Skip to main content

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

HeaderRequiredDescription
AuthorizationYesBearer YOUR_JWT_TOKEN

Query Parameters

ParameterTypeRequiredDescription
refstringYesThe ref token returned by Payment Auth from Web

Response

{
"status": "approved",
"message": "Payment authorized"
}

Status Values

StatusDescription
pendingWaiting for user action on mobile
approvedUser confirmed the payment
rejectedUser declined the payment
expiredRequest 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 ref for audit purposes.