Skip to main content

Callback

Unlike the other methods, the business being the initiator of their calling, the callback method is called from the online payment system and receiving of the information and logics of processing is to be realized on the business side. This method allows to get the information on changing of the payment status in real time

if:

  • the payment is completed successfully;
  • the payment is completed unsuccessfully;
  • the amount is fully or partially returned to the customer.

The payment details, using the POST method, are sent to the callback url address, provided while requesting the order. To confirm the successful reception of the response the business should return HTTP CODE 200. If successful calling of callback has not been possible, the payment status will remain unchanged. To check the status the business is to use the method of payment details.

note

NOTE: callback has nothing to do with re-addressing from the general payment online system to the business web-page. Re-addressing takes place in the order request, according to the meaning indicated in redirect urls transmitted by the business.

Callback-Validatoroptionalstring

Signature generated with a private key using SHA256withRSA algorithm. This parameter ensures that the callback was sent from the Payment Manager. Use public key to verify the signature.

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4RUyAw3+CdkS3ZNILQh
zHI9Hemo+vKB9U2BSabppkKjzjjkf+0Sm76hSMiu/HFtYhqWOESryoCDJoqffY0Q
1VNt25aTxbj068QNUtnxQ7KQVLA+pG0smf+EBWlS1vBEAFbIas9d8c9b9sSEkTrr
TYQ90WIM8bGB6S/KLVoT1a7SnzabjoLc5Qf/SLDG5fu8dH8zckyeYKdRKSBJKvhx
tcBuHV4f7qsynQT+f2UYbESX/TLHwT5qFWZDHZ0YUOUIvb8n7JujVSGZO9/+ll/g
4ZIWhC1MlJgPObDwRkRd8NFOopgxMcMsDIZIoLbWKhHVq67hdbwpAq9K9WMmEhPn
PwIDAQAB
-----END PUBLIC KEY-----

Response

eventstring

Callback type. The meaning is always order_payment.

request_timestring

Time of callback sending.

bodyobject

Order data. Involves the payment detail containing fields.

{
"event": "order_payment",
"request_time": "2022-11-23T18:06:37.240559",
"body": {
"order_id": "a767a276-cddd-43ec-9db3-9f9b39eee02d",
"industry": "ecommerce",
...
}
}