| ErrorCode | ErrorMsg | Description |
|---|---|---|
| 50074 | Illegal parameters | Basic required field validation failed. For example: country cannot be null, company name exceeds maximum length (64), etc. |
| 50131 | Email format invalid | Payee email does not match the required email format. |
| 50132 | Wallet value format invalid | Wallet identifier (walletPhone) contains spaces or invalid characters. |
| 50093 | There are no fieldMapping available here | No field mapping found for the given parameters. This typically only occurs in sandbox environment during integration testing. |
| 60001 | {fieldName} is required | A required field is missing. The specific field name will be indicated in the error message. |
| 50095 | Contact your administrator to add a payment country | No routing configuration found for the merchant. Contact your account manager to configure. |
| 50096 | Payment country is not supported | The target country is not included in the merchant's routing configuration. |
| 50097 | Payment country does not support this payment method | The specified wallet type is not supported for this country's routing configuration. |
| 50098 | Phone number format is incorrect | For wallet payments using mobile number format, the wallet identifier must include the country code prefix. |
| 50099 | Phone area code format is incorrect | The area code format is invalid. |
| 50100 | The Swift code is invalid | The SWIFT code provided is not valid. |
| 50101 | Account type is invalid | The account type value is incorrect for bank transfer / SWIFT payments. |
| 50102 | Sort code length is invalid | The sort code length does not meet requirements for bank transfer / SWIFT payments. |
| 50103 | The branch number is filled out incorrectly | The branch code length does not meet requirements for bank transfer / SWIFT payments. |
| 50104 | Name only supports Latin characters | For certain countries (e.g., Japan), last name and first name must use Latin characters only. |
| 50105 | Company name length invalid | The company name exceeds the allowed length. |
| 50106 | The date of birth must be earlier than the current date | The birth date format is incorrect or the date is in the future. |
| 50107 | Zipcode invalid | The postal code length does not meet requirements. |
| 50124 | Param invalid | Core parameters are missing (merchant number, country, or currency). |
| 60002 | Should be a valid IBAN for the country/region selected | The IBAN is invalid or does not match the target country code. |
| 60002 | Invalid state/province | The state or province information is incorrect. Please verify and try again. |
| 60002 | Payment currency is not supported | The payment currency is not included in the merchant's routing configuration. |
| 50094 | Add beneficiary failed | Internal service error. Please retry the request. |
The edit beneficiary API includes all create beneficiary error codes, plus:
| ErrorCode | ErrorMsg | Description |
|---|---|---|
| 50112 | beneficiaryId invalid | The beneficiaryId does not exist or does not belong to this merchant. |
| ErrorCode | ErrorMsg | Description |
|---|---|---|
| 50112 | beneficiaryId invalid | The beneficiaryId does not exist or cannot be found. |
| 50118 | Request id repeat | Duplicate requestId detected. A distributed lock (10s) or database record with the same requestId already exists. |
| 50093 | There are no fieldMapping available here | No field mapping found. This typically only occurs in sandbox during integration. |
| 60001 | {fieldName} is required | A required field is missing. |
| 50114 | Target currency invalid | The target currency does not match the payee's payout currency. |
| 50115 | Target amount invalid | When chargeFlag=Y (full amount arrival), targetAmount is missing or <= 0. |
| 50074 | Source amount can not be null / Source amount needs to be greater than zero | When chargeFlag=N (non-full amount arrival), sourceAmount is missing or <= 0. |
| 50117 | Exchange rate conversion exception | Currency conversion failed. This should not occur in production if exchange rate configuration is correct. |
| 50011 | Insufficient available balance | The account balance is insufficient to complete this transaction. |
| 50090 | This beneficiary does not exist | The beneficiaryId does not belong to the merchant initiating the payment (authorization check failed). |