Skip to content

Callback in "payment successful" case (iframe and host-2-host)

If the payment is successful, the payment data will be sent to the process_url store server using the POST method:

Callback contains the fields:

Field Description
co_inv_id unique transaction number;
co_inv_crt transaction creation date and time;
co_inv_prc transaction processing date and time;
co_inv_st payment processing status (“success”);
co_order_no transaction number in the merchant system (transferred by the merchant when payment is making);
co_amount transaction amount in the currency, separator character is a point “.”;
co_to_wlt amount of crediting the merchant account (minus fee);
co_cur transaction currency;
co_merchant_id unique merchant number;
co_merchant_uuid unique merchant ID;
co_sign digital signature with the merchant’s key (for more details read the “Digital signature in callback” section);
co_card_number transfer of the card mask. This field is not present in the response by default. In order to receive it in response, you must set YES in the field Cardmask in callback in the merchant’s settings;
co_error_resolution payment error description.

If an internal conversion is performed, additional fields may be present in the callback:

Field Description
co_base_amount the base amount received in the request;
co_base_currency the base currency used in the payment request;
co_rate conversion rate.

During the converting, the co_cur field will include the processing currency, and the co_amount and co_to_wlt fields will include the amounts in the processing currency.

In response to the package received, the merchant’s server must respond with two English letters OK.

Example:

application/json

{
  "co_inv_id": "1111111",
  "co_inv_crt": "2019-02-19 19:12:04",
  "co_inv_prc": "2019-02-19 19:12:11",
  "co_inv_st": "success",
  "co_order_no": "0001",
  "co_amount": "16",
  "co_to_wlt": "15.95",
  "co_cur": "UAH",
  "co_merchant_id": "1",
  "co_merchant_uuid": "M1VJDHSI6DYXS",
  "co_error_resolution": "Success",
  "co_sign": "pQQgUBfjz+XxRSpwo5srmw=="
}