Skip to main content
POST

Headers

beem-secure-token
string

Client validation token from the original checkout request, if provided.

Body

application/json
amount
string
required

Amount paid by the customer.

referenceNumber
string
required

Reference number matching the checkout request.

status
enum<string>
required

Payment status.

Available options:
success,
failed
timestamp
string<date-time>
required

Payment date-time in ISO 8601 format.

transactionID
string
required

Transaction ID matching the checkout request.

msisdn
string
required

Customer mobile number.

Response

200 - application/json

Acknowledge receipt of the payment status

amount
string
required

Echo the amount from the callback request.

status
boolean
required

Set to true when payment succeeded, false otherwise.

referenceNumber
string
required

Echo the reference number from the callback request.

statusMessage
string
required

Human-readable status message for your records.

transactionID
string
required

Echo the transaction ID from the callback request.