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=="
}