📬Callbacks

Callback Mechanism for Retrieving Payment Status

The callback mechanism allows you to receive payment status updates in real-time. When a payment status changes, the system will send a callback notification to your specified endpoint.

In order to receive payment statuses you need to implement endpoint, which receive POST requests with the following body:


The callback system will operate in two stages.

1. First, an intermediate callback will take place. It will occur before the final status is received

2. The second will occur after the final status is received

The body part remains the same. The difference between the first and second 30 seconds.

Name	Type	Description
orderNumber*	String	The unique number of the transaction
amount*	BigDecimal	Amount of the transaction
currency	String	Сurrency codes according to the international standard ISO 4217
status*	String	Status of the transaction
dateCreated*	Date	Date of the transaction dateCreated format - LocalDateTime
requisite	String	Used only for QR payments
provider*	String	Provider (CARD, MEGAPAY, MBANK)

First Callback

The first callback is needed to obtain the necessary data for the status request.

Body

//method: POST 
//Content-Type: application/json 
//Authorization: No auth
{
  "orderNumber": "ORD123456",
  "amount": 1500.75,
  "currency": "KGS",
  "status": "CHARGE",
  "dateCreated": "2025-05-20 14:30:45",
  "requisite": null,
  "provider": "MEGAPAY"
}

Final Callback

Final Callback is needed to obtain the final status of the payment

Body

//method: POST 
//Content-Type: application/json 
//Authorization: No auth
{
  "orderNumber": "ORD123456",
  "amount": 1500.75,
  "currency": "KGS",
  "status": "CHARGE",
  "dateCreated": "2025-05-20 14:30:45",
  "requisite": null,
  "provider": "MEGAPAY"
}