Skip to main content
WEBHOOK

​
When it’s sent

  • A payment is recorded on an invoice.
  • An invoice is created or edited together with a payment. When an insurance invoice is edited, the insurance share is sent with payment_type = INSURANCE.
  • A diagnostic fee is paid when collecting it or when booking the appointment (not for online payments, which are sent when the payment is confirmed).
The request type is NEW_PAYMENT. See the introduction to subscribe to this event and verify the X-Hub-Signature-256 signature.

Headers

​
X-Hub-Signature-256
string

HMAC SHA-256 of the raw request body, keyed with your Verify Token, as sha256=<hex>. Sent only when a Verify Token is set.

Example:

"sha256=3f1c5e…"

Body

application/json

Sent when a payment is recorded on an invoice.

​
version
enum<string>
required

Payload version.

Available options:
v1.0
Example:

"v1.0"

​
type
enum<string>
required

Event type.

Available options:
NEW_PAYMENT
Example:

"NEW_PAYMENT"

​
id
string

Payment ID.

Example:

"ckx1y0000001"

​
amount
number

Amount paid.

Example:

575

​
payment_type
enum<string>

Payment method.

Available options:
CARD,
CASH,
BALANCE,
INSURANCE,
CHEQUE,
VOUCHER,
BANK_TRANSFER,
MOBILE_WALLET,
BANK,
SAFE,
OTHER
Example:

"CASH"

​
payment_sub_type
string | null

Payment sub-type (e.g. card brand or wallet name).

Example:

null

​
invoice_id
string

Invoice ID.

Example:

"ckx1i0000001"

​
treasury_id
string | null

Treasury the money was received into.

Example:

"ckx1t0000001"

​
patient_id
string | null

Patient ID.

Example:

"ckx1p0000001"

​
bound_type
enum<string>

Always outbound.

Available options:
outbound
Example:

"outbound"

Response

200

Return any 2xx status within 5 seconds to acknowledge the event. Failed deliveries are not retried.