Carrier Billing (DCB)
Carrier Billing Call Flow
Carrier Billing MT-MO Authentication Flow
In Carrier Billing MT-MO authentication the customer receives instructions by SMS and authorizes the transaction by sending an SMS based on those instructions.
Carrier Billing MO Authentication Flow
Also in Carrier Billing MO authentication, the authorization is also done by sending an SMS, but instructions on doing so must be provided on partner's payment page.
Request Message
Parameters | Length | Description | Mandatory |
---|---|---|---|
api_key | 256 | Secret key assigned by Coda (Unique to each country). | Yes |
order_id | 64 | Merchant-assigned unique transaction identifier. | Yes |
lang | 2 | 2-character language code. See Language table for options. | Yes |
pay_type | 1 | Carrier Billing use pay_type = 1. For Carrier billings, if customers enter MSISDN of different carrier billings than the carrier billings in request message, the transaction will be failed with error 240 . | Yes |
msisdn | 15 | MSISDN (non-formatted; without country code). Only include this if MSISDN is required and not email. |
|
mno_code | N/A | Mobile Network Code. If empty, Coda selects available MNO. | Yes |
merchant_name | 128 | Merchant name that will be displayed in SMS message, if the partner wants to specify partner name, please enter the name in this field. The default value is empty. |
|
type | 1 | 1: digital content. 2: non-digital content. | Yes |
items | N/A | ItemInfo array. See Item Info table below for more details. | Yes |
profile | N/A | Other details. | Yes |
Sample Of Response
Response Message
Parameters | Length | Description |
---|---|---|
result_code | N/A | Success or Error code. Success = 0. Common Error Codes |
result_desc | 512 | If the resultCode is an error, this value describes the error. Common Error Codes |
txn_id | N/A | Unique payment transaction identifier. |
txn_timeout | N/A | Transaction Timeout in Minutes. |
total_price | N/A | Net payment amount. Non-formatted numeric value. For Indonesia, Chile, South Korea, Taiwan, Vietnam currency, decimals are not supported. |
pay_instructions | 15 | If this value is populated, partner should display the instructions provided on screen to the customer. |
profile | N/A | Other details, please refer to Profile field. |
Other details in Profile Field
Parameters | Length | Description |
---|---|---|
extInfoByte | N/A | Please ignore this field. |
redirect_url | 128 | Return payment gateway's redirect URL. Please be aware this response is only available if the payment channel has a redirect URL workflow. For Example: Thailand Rabbit Line Pay |
merchantType | 128 | Please ignore this field. |
Sample of Response
Mobile Operator Codes
Country | Payment Channels (MNO) | Auth Type |
---|---|---|
Bangladesh | Robi | N/A |
Indonesia | Indosat | MT-MO |
Indonesia | Telkomsel | MT-MO |
Indonesia | TRI | MT-MO |
Indonesia | XL | MO |
Cambodia | Smart Axiata | MT-MO |
Laos | Unitel | MT-MO |
Myanmar | ATOM | MT-MO |
Myanmar | Ooredoo | MT-MO |
Malaysia | Celcom | MT-MO |
Malaysia | Maxis | MO |
Philippines | Smart/Sun | MT-MO |
Pakistan | Telenor Pakistan | MT-MO |
Singapore | M1 | MT-MO |
Taiwan | Asia Pacific Telecom | N/A |
Taiwan | Chunghwa Telecom | N/A |
Taiwan | FarEasTone | N/A |
Reference of USD Transactions
Please check out this guide to learn more about USD transactions.
Last updated