1. OnDemand
XL DCB API for Partner
  • Getting Started
    • Introduction
    • Authentication
    • Headers
    • Recurring (Subscription)
    • On-Demand (One-Time Charge)
    • Callbacks (Webhooks)
    • Errors & Response Codes
    • Notes (Partner Guidance)
  • Subscriptions
    • Create Subscription (Initiate)
      POST
    • Confirm OTP
      POST
    • Unsubscribe
      POST
  • OnDemand
    • Create one-time charge (OTP flow)
      POST
    • Confirm OTP (execute charge)
      POST
    • Check transaction status
      GET
  1. OnDemand

Check transaction status

GET
/partner-dcb/v1/on-demand/charges/check
Query by transaction_id.

Request

Query Params

Body Params application/json

Responses

🟢200
application/json
Charge status
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request GET '/partner-dcb/v1/on-demand/charges/check?transaction_id={transaction_id}&payment_method=XL' \
--header 'Content-Type: application/json' \
--data '{}'
Response Response Example
{
    "success": true,
    "correlation_id": "8005c7c8-0800-e200-b63f-84710c7967bb",
    "code": "TRANSACTION_FOUND",
    "message": "Transaction found",
    "data": {
        "status": "Success",
        "failure_reason": "",
        "failure_message": "",
        "event_type": "OneTimePurchase",
        "payment_method": "XL",
        "amount": 3000,
        "msisdn": "6287800000000",
        "transaction_date": "2026-05-08T10:01:42+07:00",
        "item_id": "IM0002",
        "item_name": "MIA 3330",
        "item_description": "MIA 3330",
        "partner_ref_id": "0b5efb01-3ee5-491c-95ee-088316ca67b0",
        "transaction_id": "E01A7B3F-2B0C-42E7-9918-FA3333F41797",
        "timestamp": "2026-05-11T13:44:34+07:00"
    }
}
Modified at 2026-05-13 04:24:12
Previous
Confirm OTP (execute charge)
Built with