Skip to content

Payment status request (Deposit)

The data transfer method can be POST or GET.

The request contains certain fields:

Field Description
merchant unique merchant ID;
order transaction number in the merchant system;
co_inv_id unique transaction number (the number is transferred after payment processing to the merchant’s Process URL);
sign digital signature with the merchant’s key. Available fields are: “merchant”, “order”, “co_inv_id”. It is hashed using the MD5 method. (for more details read the “Digital signature in requests” section);
GET /payment/status
https://<provided url>
/payment/status
Examples of the request:

application/json

{
    "merchant" : "M1VJDHSI6DYXS",
    "order" : "0001",
    "co_inv_id" : "1111111",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}

In response to the request the data is returned in the JSON format:

Field Description
status transaction status:

Success – the payment is completed successfully (final status)
Pending – the payment is new or is in the line for processing
Fail – the payment is canceled (final status)
Refund – the payment was refunded (final status)
Error – received data error (signature in the response is empty “sign” = “”);
order transaction number in the merchant system;
description status description;
card_number bank card mask (in the format NNNNNN**NNNN, where N – digit);
error_resolution payment error description;
sign digital signature with the merchant’s key.
Example of the response – Success status:

application/json

{
    "status" : "success",
    "order" : "0001",
    "description" : "Merchant payment success",
    "card_number" : "530011******3333",
    "sign" : "XXXXXXXXXXXXXXXXXX"
}
Example of the response – Error status:

application/json

{ "status" : "Error", "order" : "0001", "description" : "Merchant payment not found", "sign" : "XXXXXXXXXXXXXXXXXX" } ```