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.

Callback examples

Deposits

Success

{
  "status": 4,
  "type": 1,
  "external_id": "example_external_id",
  "order_id": "173805987126016235868313296400",
  "amount": 10000,
  "currency": "USD",
  "customer_id": "307353",
  "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",
  "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
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