Overview
In addition to being passively informed about ongoing payment status by Merchant Callback and Webhook Notification, merchant can query payment status using direct API call to GetPaymentStatus
Request
curl --location --request GET 'https://api.sandbox.volumepay.io/api/payments/{payment-id}}/status' \
--header 'x-application-id: {application-id}}'| argument | kind | type | description |
|---|---|---|---|
| payment-id | path variable | UUID | id of the payment to get status for |
| application-id | header | UUID | id of the merchant application |
Response
{
"paymentId": "11611393-885f-4acc-a421-227362bbc342",
"merchantPaymentId": "ab-123",
"paymentStatus": "COMPLETED",
"errorDescription": null,
"tracingId": "c625b7f56b7ed4f5"
}| field | type | description |
|---|---|---|
| paymentId | UUID | payment id |
| merchantPaymentId | string [optional] | merchant payment id if specified when payment was initialized |
| paymentStatus | string | current payment status: AWAITING_AUTHORIZATION, AUTHORIZED, PENDING, COMPLETED, FAILED |
| errorDescription | string [optional] | error details when paymentStatus is FAILED |
| tracingId | string | call tracingId |