Webhooks

After a confirmation of a transaction by the external payment system, a notification (Callback) with the final status of the transaction will be sent to the Merchant’s site.

Notification (Callback) - is a POST request, containing information about the results of a successful and unsuccessful operations, which is sent to the special addresses specified by the client and transmits the data of a specific transaction in the form of a set of parameters.

You need to specify the address for callbacks in a letter to the technical support. In addition, you can set different addresses for callbacks about successful and unsuccessful transactions.

The parameter status_id contains transaction status.

Status will be sent repeatedly until json {"result": "ok"} respond received, with periods 45s, 2, 5, 10, 30 minutes, and once per hour during twenty-four hours.

Important

The system expects an HTTP 200 OK response to confirm that the webhook has been successfully received.

If a 4xx or 5xx status is returned, the webhook will be retried automatically, which may result in multiple repeated requests.

Please ensure the endpoint returns 200 OK after successful processing.

Callback examples

Deposits

Success

{
  "status": 4,
  "type": 1,
  "external_id": "example_external_id",
  "order_id": "173805987126016235868313296400",
  "amount": 10000,
  "currency": "USD",
  "customer_id": "307353",
  "customer_purse": "428455...9651",
  "signature": "**"
}

Decline

{
  "status": 5,
  "type": 1,
  "external_id": "example_external_id",
  "order_id": "173805987126016235868313296401",
  "amount": 10000,
  "currency": "USD",
  "customer_id": "307354",
  "reason_code": "001",
  "reason": "General decline",
  "customer_purse": "428455...9651",
  "signature": "d9f5713990de5c6e32169dba1f0102f540018975"
}

Notification parameters

Parameters	Type	Description
status	Enum	Operation status
type	Enum	Operation type
external_id	String	Order identifier in the merchant's system
order_id	String	Order identifier in the Cabbagino's system
amount	Numeric	Amount to be paid in minor units (e.g., for USD - in cents)
currency	ISO 4217 alpha-3	Order currency
customer_id	String	Merchant’s initial ID, returned in callback
reason_code	String	Three-digit error code
reason	String	General or detailed decline reason
signature	String	Request signature, see Request signature generating rules