Webhooks

Internal transfer updated

Sent when an internal transfer changes status (PENDING → PROCESSING → COMPLETED, FAILED, etc.). Set the destination URL using callback_url when creating the transfer. The body is identical to the Get Internal Transfer response.

postWebhookinternal_transfer.updated

Payload

idstring required

Transfer ID

idempotency_keystring

A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.

company_idstring required

Company ID

created_atstring date-time required

Creation date of the transfer

updated_atstring date-time required

Last update date of the transfer

quote_idstring

Quote request ID used in the transfer, if applicable

ratenumber

FX rate used in the transfer, if applicable

source_amountnumber

Amount of the transfer

destination_amountnumber

Amount received in the target account currency

source_account_idstring required

Source account ID

target_account_idstring required

Target account ID

status'PENDING' | 'PROCESSING' | 'SETTLING' | 'COMPLETED' | 'FAILED' required
failure_reasonstring

Reason of the failure, if the transfer failed

compliance_holdboolean

True while the transfer is temporarily held for a compliance review. The transfer resumes automatically once the review is completed.

callback_urlstring

URL to send a POST request with the result of the transfer, if applicable

voucher_idsstring[]

Voucher IDs associated with the transfer of funds to the final destination.

Response

Any 2xx response is treated as a successful acknowledgement. Infinia will retry delivery on non-2xx responses.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.