Check Status — Payment Authorization
Poll the result of a payment authorization request initiated with Payment Auth from Web.
Endpoint
POST /api/organization/authorizepayment/checkStatus
https://sandbox-services.mobileid.dj/api/organization/authorizepayment/checkStatus
Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Bearer YOUR_JWT_TOKEN |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ref | string | Yes | The ref token returned by Payment Auth from Web |
Response
{
"status": "approved",
"message": "Payment authorized"
}
Status Values
| Status | Description |
|---|---|
pending | Waiting for user action on mobile |
approved | User confirmed the payment |
rejected | User declined the payment |
expired | Request timed out (exceeded timeout parameter) |
Example Request
POST /api/organization/authorizepayment/checkStatus?ref=YOUR_REF_TOKEN HTTP/1.1
Host: sandbox-services.mobileid.dj
Authorization: Bearer YOUR_JWT_TOKEN
Notes
- Only proceed with the payment on your side when status is
approved. - Log the final status and
reffor audit purposes.