Skip to content

Payment status request Open banking (Deposit)

The data transfer method can be POST or GET.

The request contains certain fields:

Field Description
merchant unique merchant identifier;
order transaction number in the merchant system;
co_inv_id unique transaction number (the number is transmitted to the merchant's Process URL after payment processing);
sign digital signature with the merchant's key. The fields ‘merchant’, ‘order’, ‘co_inv_id’ are used. It is hashed by MD5 method. (see details in the ‘Digital Signature in Requests’ section).
GET /payment/status
https://<provided url>
/payment/status
Examples of the request:
{
    "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 card mask (in the format NNNNNNNNNN**NNNNNNN, where N is a digit);
error_resolution This parameter will provide additional details of the main payment status.
Non-final sub-statuses:
1. TRANSACTION_INITIATED - the transaction has been created
2. TRANSACTION_PROCESSING - the customer has started to go through the transaction flow
3. TRANSACTION_ACCEPTED - the customer's bank has accepted the payment
4. TRANSACTION_SUCCESS - the customer has successfully completed the payment.
Final statuses:
1. fail - unsuccessful payment
2. TRANSACTION_CANCELLED - the customer has cancelled the payment
3. TIMEOUT - the payment term has expired
4. AML_BLOCKED - payment is blocked by AML
5. success - the money has been received
6. REFUNDED - payment is returned;
sign digital signature with the merchant’s key.
Example of the response – Success status:

application/json

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

application/json

```json

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