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. See Other details in Profile field	Yes

Sample Of Response

Sample with msisdn

{
    "txn_id": 6648561839693172536,
    "txn_timeout": 11,
    "result_code": 0,
    "total_price": 100.0,
    "pay_instructions": "We just sent an SMS to xxxxxx. To complete the transaction, send \"PAY\" followed by five digits code from the SMS to 75457. Example: PAY 12345.",
    "profile": {
        "extInfoByte": "0",
        "user_id": "Testuser397",
        "merchantType": "Codapay"
    }
}

Sample without msisdn

{
    "txn_id": 6742026121325386583,
    "txn_timeout": 61,
    "result_code": 0,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "user_id": "12345",
        "merchantType": "Codapay",
        "redirect_url": "https://sample_URL.com"
    }
}

Response Message

Parameters	Length	Description
result_code	N/A	Success or Error code. Success = 0.
result_desc	512	If the resultCode is an error, this value describes the error.
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

Sample with msisdn

{
    "txn_id": 6648561839693172536,
    "txn_timeout": 11,
    "result_code": 0,
    "total_price": 100.0,
    "pay_instructions": "We just sent an SMS to xxxxxx. To complete the transaction, send \"PAY\" followed by five digits code from the SMS to 75457. Example: PAY 12345.",
    "profile": {
        "extInfoByte": "0",
        "user_id": "Testuser397",
        "merchantType": "Codapay"
    }
}

Sample without msisdn

{
    "txn_id": 6742026121325386583,
    "txn_timeout": 61,
    "result_code": 0,
    "total_price": 1000.0,
    "pay_instructions": "",
    "profile": {
        "extInfoByte": "0",
        "user_id": "12345",
        "merchantType": "Codapay",
        "redirect_url": "https://sample_URL.com"
    }
}

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.