Payment webhooksWebhooks

Payment status notification

Hook/paymentStatus

Datman sends a JSON POST to your configured webhook URL when the status of a payment changes. Verify the HMACSignature header before trusting the payload.

Request Parameters

Header Parameters

HMACSignature?string

HMAC-SHA256 of the JSON body using your webhook secret, hex-encoded.

Request Body

application/json
  1. body
order_id?string

Your original order reference.

amount?string

Amount in major units with two decimals (e.g. "10.00").

currency?string

ISO 4217 currency code.

customer_id?string

Your original shopper reference.

xref?string

Datman transaction reference in the form O{order_id}M{merchant_id}T{payment_id}.

status?string

Lower-cased payment event code (e.g. "authorisation", "capture").

success?string

Whether the event succeeded, as a string.

Value in"true""false"
date?string

Event date/time.

three_ds_authenticated?string
three_ds_authenticated_response?string
card_bin?string
last4_digits?string
shopper_ip?string
shopper_email?string
expiry_date?string
avs_result?string
cvc_result?string
card_type?string

Card brand / payment method variant.

reason?string

Failure reason; present only when success is "false".

split_fee_status?

Split fee outcome; present only on capture events for orders with split fees.

Your response

Response Body

Acknowledge receipt of the notification.