#Error Code
#General Error Code
| Error Code | Error Information |
|---|---|
| 11 | Sorry, the system is busy, please try again later! |
| OPEN_GW_000001 | APP_NOT_EXIST |
| OPEN_GW_000002 | The required parameter cannot be empty |
| OPEN_GW_000003 | refreshToken not valid |
| OPEN_GW_000004 | Sorry, the validity period of the page has expired. Please click to return to Palmpay and initiate a new loan |
| OPEN_GW_000005 | auth openId not found |
| OPEN_GW_000006 | country code can not be null |
| OPEN_GW_000007 | member auth already exist |
| OPEN_GW_000008 | Security validate fail / sign error |
| OPEN_GW_000009 | invalid method name parameter |
| OPEN_GW_000010 | missing signature |
| OPEN_GW_PARTNER_000011 | no product reg by partner |
| OPEN_GW_000012 | insufficient permissions / request ip not in ip white list |
| OPEN_GW_000013 | invalid app auth token |
| OPEN_GW_000014 | invalid auth token |
| OPEN_GW_000015 | Your request could not be processed! Make sure that your phone time and date are set correctly and then try again. |
| OPEN_GW_000016 | biz exception |
| OPEN_GW_000017 | unknown exception |
| OPEN_GW_000018 | duplicated req |
| OPEN_GW_000019 | public key parse error, please check public key config |
| OPEN_GW_000020 | param error |
| OPEN_GW_000022 | invalid url router |
#Order Error Code
| Error Code | Error Message |
|---|---|
| MC100000 | Merchant orders already exist |
| MC100001 | Merchant order status is abnormal and not operational |
| MC100002 | Merchant order has been accepted |
| MC100003 | The merchant order does not support a refund |
| MC100004 | Merchant order does not exist |
| MC100005 | Merchant refund amount is too large |
| MC100006 | Too many refunds from merchants |
| MC100007 | The merchant's last refund order has not been completed |
| MC100008 | Refund failed |
| MC100009 | The sign token is not existed |
| MC100010 | Member does not exist |
| MC100011 | Account does not exist |
| MC100012 | Loyalty account does not exist |
| MC100013 | Database writing failure |
| MC100015 | The mobile phone number has been bound |
| MC100016 | Authorization invalid |
| MC100017 | Sorry, not a reusable Verve card, please change another card |
| MC100018 | The Verification code is invalid. Please try it again |
| MC100029 | The order is being paid and cannot be closed |
| MC100040 | Account does not exist |
| MC100041 | Abnormal payee account status |
| MC100042 | Abnormal payer account status |
| MC100043 | Bank code does not exist |
| MC200001 | Account balance is insufficient |
#ZA Card Payment — Pre-auth / Card Binding / Capture (New)
| Error Code | Error Message |
|---|---|
| MC1000046 | Missing card payment three elements (card number / expiry / CVV) |
| MC1000047 | captureMode enumeration value error |
| MC1000048 | Card not available |
| MC1000049 | Internal system error, please re-initiate the order |
| MC1000051 | action enumeration value error (capture / cancel) |
| MC1000052 | Card not supported / Card token not supported |
Note: MC1000046 ~ MC1000052 were added on 2026-06-12 for ZA card payment pre-auth, card binding, and capture flows.
#Ledger Split Error Code
| Error Code | Error Message |
|---|---|
| 00000064 | No permission, ledger split product not enabled |
| 00000067 | Ledger split merchant not bound |
| 00000066 | Number of ledger split merchants exceeds 10 |
| 00000065 | Ledger split amount does not match order amount |
#Merchant Collection High Frequency Error Messages
| Error Code | Error Message |
|---|---|
| 31021502 | Balance Not Enough |
| tongdun | This transaction cannot be completed for the security of your account. For further assistance, please contact: 020 1888 6888 |
| 45 | Your bank account doesn't have enough money. Please try another payment method or add money. |
| PR000023 | The request was failed, please try it later. |
| 63000029 | Timeout, transaction not completed. |
#Merchant Pay Out High Frequency Channel Error Messages and Solutions
| Error Message | Reasons and Possible Solutions |
|---|---|
| Invalid account number, please check and try again | Failed to check the account number, you need to confirm with the customer whether the account number is correct, and whether there are spaces or special characters in the transmission format |
| Abnormal account status | The account status is abnormal and cannot be traded, you need to check whether the account is frozen or the transaction limit is exceeded |
| Payer account suspended | Merchant accounts are restricted from withdrawing funds and payments cannot be made, you need to confirm the status of the paying account |
| Transaction failed due to risk control | There are unknown transaction risks, block transactions to ensure the safety of funds, you need to confirm whether there is compliance or transaction risk in the payee account |
| Transaction failed as the beneficiary of this transaction has exceeded the maximum balance limit | The transaction is blocked because the balance of the payee account exceeds the limit, you need to confirm whether the payee account exceeds the account level limit, resulting in the inability to receive payment |
| You exceeded the trading limit today. Please try it tomorrow | Exceeded your merchant account transaction limit, you need to check with your BD to see if you have exceeded your daily or monthly withdrawal limit |
| Channel request failed, please try it later | It is common for requests to fail due to channel jitter, and a retry can be initiated. If the request still fails after several retries, check if the receiving account exceeds the transaction limit |
| Transaction failed. The recipient's account has been frozen in line with CBN regulations and cannot receive transfers | The new policy of CBN has led to the freezing of the payee account and the inability to receive money, you need to contact the customer to deal with the account unfreezing |
| Transaction failed, the recipient's account does not meet the latest regulatory requirements of CBN and is temporarily unable to trade | The new policy of CBN has led to the freezing of the payee account and the inability to receive money, you need to contact the customers to upgrade their accounts to meet the new policy |
#Virtual Account Error Code
| Error Code | Error Message |
|---|---|
| AC100001 | Virtual AccountNo not exist |
| AC100002 | Virtual banking products have not been launched |
| AC100003 | Failed to create an account, please try again |
| AC100004 | No agreement signed |
| AC100005 | Account limit exceeded |
| AC100006 | The required parameter cannot be empty |
| AC100007 | LicenseNumber verification failed |
| 00000008 | Parameters error |
#Enquire MoMo Network Return Code
| Return Code | Return Message |
|---|---|
| 00000000 | Successful |