Use case · Direct carrier billing

Let customers pay with their mobile account

Direct carrier billing charges a purchase to the customer's mobile bill or prepaid balance, so customers can pay without a bank card.

Register to get API keys and start building

How it works

  1. Get a token for the charge

    Request an access token with your app's credentials. For carrier billing, the token request also carries the subscriber's number and the charge.

  2. Charge once or on a schedule

    Use DCB OneTime for a single purchase and DCB Recurring for subscriptions. Each charge sends the amount, the bucket to charge and the usage type, and can carry a one-time code (OTP) the customer confirmed.

  3. Manage prepaid balances

    Prepay Balance Management debits or credits a prepaid balance and lets you look up a debit or credit by its ID.

APIs for this use case

Questions

One-off or recurring?

DCB OneTime charges a single purchase. DCB Recurring charges subscription payments. Both use the adjustBalance operation of the TM Forum Prepay Balance Management standard.

What does a charge request contain?

The amount, the bucket to charge and the usage type are required. The request can also carry a channel, a description and a six-character one-time code (OTP). Each API reference lists the fields.

Which standard do these APIs follow?

The billing and balance APIs follow the TM Forum Open API standard (TMF654 Prepay Balance Management).

Other use cases: Fraud prevention with SIM Swap · Phone number verification · Get started

Contact Us

Please use this form to email us regarding anything related to Ooredoo

Fields mark with an * are required