Payment Status Request

To initiate a payment status request, send a POST request to the following URL:

POST /acquiring/{Service_ID}/check

Where {Service_ID} is the Partner's ID in the system.

The system will validate the incoming request, including the control signature. If the request is invalid, the system will respond with:

• HTTP Status 400: Incorrect request
• HTTP Status 401: Validation error
• HTTP Status 404: Operation not found

Request Parameters

Example of a Payment Status Request

POST
{{url_system}}/acquiring/{Service_ID}/check

HEADERS:
Content-Type: application/x-www-form-urlencoded

BODY:

"orderid": "123456789"
"dt": "20240701233011"
"control": "a43520fb836e2d7fab8c05a69baf3edc"

The control value is generated using the following parameters with SecretKey = Qwerty123:

Signature Generation String:
12345678920240701233011Qwerty123

The system responds in XML format with UTF-8 encoding. The Content-Type will be set to application/xml.

Examples of Responses

Example response for an operation with a successful final status:

<response>
         <txnId>20476210</txnId>
         <paymentStatus>PAY_OK</paymentStatus>
         <paymentStatusDesc>SUCCESS</paymentStatusDesc>
</response> 

Example of a response for an operation with an unsuccessful final status:

<response>
         <txnId>20476211</txnId>
         <description>User did not follow the link</description>
         <paymentStatus>PAY_FAIL</paymentStatus>
         <paymentStatusDesc>FAIL</paymentStatusDesc>
</response> 

Example of a response for an operation that does not exist in the System:

<response>
         <errorCode>9908</errorCode>
         <description>Operation 123456789 not found</description>
         <paymentStatus>ORDER NOT FOUND</paymentStatus>
</response> 

Response Parameters