Skip to content

Carrier Billing Disbursement

PMmax provides merchant with access to top up payee’s mobile phone bill, so that merchant can achieve the purpose of paying the payee. Specification:Please pass ‘CarrierBilling’ into ‘paymentMethodType’ field through API.

Supported Types

  • FIXED_VALUE_RECHARGE: Support top up to payee’s mobile phone bill balance according to fixed value.
  • RANGED_VALUE_RECHARGE:Support top up to payee’s mobile phone bill balance according to value in a range.
  • FIXED_PIN: Support distribute recharge code(PIN code) according to fixed value to payee who can redeem recharge code(PIN code) to mobile phone bill balance following the guidance in notification message.

For details on the types and amounts supported under each country-operator, please refer to "Disbursement Application Template and Filling Specifications" For details of the PIN code exchange process, please refer to the attached PIN code exchange process table:PIN code exchange process

Carrier Billing disbursement process

1. Merchants can initiate payment applications through API/MMC, and need to provide the following payee information

  • The mobile phone number of the payee (accountNo): the mobile phone number of the recharge
  • Disbursement amount (amount): The disbursement amount applied by the merchant
**
  • Operator code (targetOrg): Merchant can directly specify the telecom operator corresponding to payee’s mobilephone number(payeeAccountNo), if it’s not specified, PMmax will automatically match telecom operator based on prefix of payee’s mobilephone number. - There may be situation such as mobile number portability, which will lead to mismatch of the telecom operator and payee’s mobile network, and the failure of the transaction.

2. The transaction is completed: When the transaction reaches the final state, PayerMax will notify the merchant

Disburesement failed

  • If phone billing top-up failed, PayerMax would notify merchant the failure and return the fund - When there is a scenario where the recharge fails due to operator mismatch, we will return the possible matching operator name in the error description (responseMsg) for reference.

Disburesement succeeded:

  • FIXED_VALUE_RECHARGE/RANGED_VALUE_RECHARGE successful recharge means successful transaction
  • FIXED_PIN recharge code notification message sent successfully means the transaction is successful

##Carrier Billing Limits For operator restrictions, please click to download: OperatorLimitations_Sep2022.pdf

Was this page helpful?

Thank you for your help in improving PayerMax Product Docs!

Last updated:

Released under the MIT License.