Payment Auth from Web

Initiate a payment authorization request. The user receives a push notification on their MobileID app showing the transaction details to confirm or reject.

Endpoint

POST /api/organization/paymentauthorizationfromweb

https://sandbox-services.mobileid.dj/api/organization/paymentauthorizationfromweb

Headers

Header	Required	Description
Authorization	Yes	Bearer YOUR_JWT_TOKEN

Query Parameters

Parameter	Type	Required	Description
client_id	string	Yes	NNI of the user authorizing the payment
preContextTitle	string	Yes	Context message shown to the user on their device
transaction_id	string	Yes	Unique transaction identifier from your system
timeout	integer	Yes	Seconds before the request expires (e.g. 15)
amount	decimal	Yes	Payment amount (e.g. 62.65)
currency	string	Yes	Currency code (e.g. usd, djf)
beneficiary_name	string	Yes	Name of the payment recipient
beneficiary_bank	string	Yes	Bank of the payment recipient
beneficiary_account	string	Yes	Account number of the payment recipient
reference	string	No	Optional free-text reference for the transaction

Response

{
  "ref": "<encrypted_reference_token>"
}

Field	Type	Description
ref	string	Reference token — use with Check Status to poll the result

Example Request

POST /api/organization/paymentauthorizationfromweb
  ?client_id=YOUR_CLIENT_NIN
  &preContextTitle=Payment+confirmation
  &transaction_id=TXN-20240418-001
  &timeout=15
  &amount=150.00
  &currency=djf
  &beneficiary_name=ACME+Corp
  &beneficiary_bank=CAC
  &beneficiary_account=00012345678
  &reference=INV-2024-042
Host: sandbox-services.mobileid.dj
Authorization: Bearer YOUR_JWT_TOKEN

Notes

• The transaction_id should be unique per transaction in your system.
• The preContextTitle is displayed prominently on the user's device — keep it clear and concise.
• After receiving the ref, poll Check Status until a terminal status is returned.