Overview

The Sync Transaction Status webhook is used when a transaction has been received in Toqio or has been initiated on the Toqio side. The integrator must update the object through notification with any status change received from the provider.

Webhook Type: SYNC_TRANSACTION_STATUS

Request Body Structure

Field	Type	Required	Description
`id`	string	Yes	Transaction number identifier
`status`	enum	Yes	Current transaction state
`failureReason`	string	No	Reason for failure if transaction failed
`baseTotal`	number	No	Amount in original currency

Status Values

Example Payloads

Complete Example

{
  "id": "c14a080d-7bd3-4bab-8e2f-1d71a0123e5f",
  "status": "ACCEPTED",
  "failureReason": null,
  "baseTotal": 105.75
}

Failed Transaction

{
  "id": "c14a080d-7bd3-4bab-8e2f-1d71a0123e5f",
  "status": "FAILED",
  "failureReason": "Insufficient funds",
  "baseTotal": 105.75
}

Withheld Transaction

{
  "id": "69718d8dfb119739d2efa065",
  "status": "WITHHELD",
  "failureReason": null,
  "baseTotal": 150.00
}

Minimal Request

{
  "id": "c14a080d-7bd3-4bab-8e2f-1d71a0123e5f",
  "status": "PENDING"
}