TransfersInternal transfers

Internal transfer failed

Hook/internalTransferFailed

Datman sends a JSON POST to the webhook_url of an internal transfer when the transfer fails. The body has a reason and no status. Verify the X-Datman-Signature header over the raw request body before trusting the payload. The notification is sent once and isn't retried.

Request Parameters

Header Parameters

X-Datman-Signature*string

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

Request Body

application/json
  1. body
request_id*string

The request_id returned when you created the transfer.

source_merchant_id?string|integer
destination_merchant_id?string|integer
amount?integer

The amount in minor units.

currency?string

ISO 4217 currency code. Not present for every transfer.

transfer_category_code?integer
description?string
reference?string

Your reference for the transfer.

webhook_url?string
order_id?|

Present only if you sent it.

reason*string

Why the transfer failed, e.g. "Insufficient funds" or "Transfer failed".

Your response

Response Body

Acknowledge receipt of the notification.