Error code(v2)
Eximbay error code: The error code is provided in the errcode field of the payment response, with the new format being represented as character strings. Any existing miscellaneous error codes will be included in the rescode field.
Payment
| Error code | Error message | Solution |
|---|---|---|
| EXPIRED_CARD | The card has expired. Please check the card exipration date is correct or expired. | Please verify the card expiration date. |
| INVALID_CARD_NUMBER | The card number is incorrect. Please check the card number. | Please enter the correct card number |
| INVAILD_CARD_DATA | Some of the card data was invalid (CVV, expiration date, card number, name on card, card password) | Please enter the correct card information. |
| INVALID_CVC | The CVC(CVV) number is incorrect. Please try again using the correct CVC(CVV). | Please enter the correct card's cvc number. |
| INVALID_PASSWORD | The card password is incorrect or has been incorrect several times. Please try again with the correct password. | Enter the correct PIN number. Please contact the card issuiying bank if you exceed the entiry limit. |
| PASSWORD_REQUIRED | The card was declined as it requires a password(PIN). | Please enter the card PIN number |
| INVALID_AUTHENTICATION | The payment was declined because authentication failed or was required. | Please verify if the card supports authentication payments and ensure the authentication process is completed properly. |
| INVALID_CAVV | The payment was declined because CAVV is incorrect. | Please enter the correct CAVV information. |
| FRAUDULENT_DECLINE | The payment was declined because the transaction was suspected to be fraudulent. | |
| STOLEN_OR_LOST_CARD | The card was reported lost or stolen. Please try check the card. | Please contact the card-issuing bank. |
| CONTACT_CARD_ISSUER | The card was declined for an unknown reason. Please contact card issuer for more information. | Please contact the card-issuing bank. |
| CARD_NOT_SUPPORTED | The card does not support this type of payment. Please try again using other card. | Please use a card that supports the selected payment method. |
| RESTRICTED_CARD | You can't use this card to make this payment. Please contact card issuer for more information. | Please contact the card-issuing bank. |
| NOT_REGISTERED_CARD | The card does not register, please register your card before using it. | Please contact the card issuing bank. |
| CARD_PAYMENT_COUNT_EXCEEDED | You have exceeded the maximum number(daily/monthly/annually) of payments. | Please contact the card-issuing bank for information regarding the transaction count limit. |
| CARD_VELOCITY_EXCEEDED | You have exceeded the balance, credit limit, or transaction amount limit available on their card. | Please check the account balance and card usage limit. |
| INSUFFICIENT_FUNDS | The card has insufficient funds to complete the purchase. | Please check the account balance. |
| INVALID_CARD_IDENTITY | Some of the identity information was invalid(resident registration number, business number). | |
| KEYIN_NOT_SUPPORTED | The mercahnt has not allowed KEYIN transaction. | |
| INVALID_CARD_INSTALLMENT_PLAN | The installment months are invalid or exceeded. | |
| NOT_SUPPORT_INSTALLMENT_PLAN | The card does not support installment plan. | |
| NOT_SUPPORT_DISCOUNT | The card does not support discount. | |
| INVALID_CARD_INSTALLMENT_AMOUNT | The installment amount is incorrect. Card installment plan is supported over 50,000won transaction. | |
| POINTS_NOT_SUPPORTED | The points cannot be used this transaction. Please try again or contact card issuer. | |
| INVALID_MERCHANT_NUMBER | The merchant number is invalid. Please check merchant number is correct. | Please contact Eximbay customer support. |
| INVALID_SUBMALL_NUMBER | The submall merchant number is invalid. Please check merchant number is correct. | Please contact Eximbay customer support. |
| CHECK_MERCHANT_STATUS | The merchant status is a suspended. Please check merchant status. | The merchant MID is temporarily paused. |
| INSUFFICIENT_MERCHANT_FUNDS | The merchant has insufficient funds to complete the purchase. | Please contact Eximbay customer support. |
| INSUFFICIENT_MERCHANT_REFUND_FUNDS | The merchant has insufficient funds to complete the refund. | Please contact Eximbay customer support. |
| INVALID_CANCEL_REQUEST | The cancel request was invalid. Please check the orginal transaction status and try again. | Please verify the original transaction status and the information entered. |
| TRANSACTION_ALREADY_CANCELED | The transaction was already canceled. | Please verify the transaction status. |
| TRANSACTION_ALREADY_CAPTURED | The transaction was already captured. | |
| TRANSACTION_ALREADY_CAPTURED_OR_CANCELED | The transaction was already captured or canceled. | |
| ALREADY_VOID_CAPTURED_TRANSACTION | The captured transaction was already void. | |
| INVALID_CERTIFICATE | Your certificate has expired or invalid. Please check your certificate and try agian. | |
| INVALID_OR_MISSING_FIELD | The request is missing one or more fields or contain invalid data. | Please check the required parameters and the information that cannot be duplicated in the linked document. |
| DUPLICATE_TRANSACTION | The transaction was decline as duplicate. | |
| CURRENCY_NOT_SUPPORTED | The transaction does not support the currency used. | Please verify the supported currencies. |
| GENERIC_DECLINE | The transaction was failed an unknown reason. Please try again later or contact card issuer for more information. | |
| ORIGINAL_TRANSACTION_NOT_EXIST | The original transaction was not exisited. | Please verify the original transaction information. |
| INVALID_REQEUST_AMOUNT | Requested amount conflicts with the minimum or maximum amount allowed. | |
| TEMPORARY_ERROR | There is a temporary error in the system. Please try again later. | |
| INVALID_MERCHANT | Information in your merchant is incorrect. | |
| INVALID_ACCOUNT | Information in your account is incorrect or not supported. | |
| NOT_REGISTERED_MERCHANT | The merchant does not register, please register merchant before payment. | |
| INVALID_REQEUST_ID | The request ID is invalid. Please check the request ID before reqeusting payment. | |
| INVALID_ADDRESS | The address you entered is invalid, please enter the correct address. | |
| ACQUIRER_DECLINE | The transaction was declined because of acquirer. | |
| VALIDATION_FAILED | The transaction failed due to a valiation failure. | |
| DUPLICATION_DECLINE | The transaction was decline because a specific field was requested as duplicated. Please make sure that duplicate values are not requested. | |
| INVALID_CAPTURE_REQUEST | The requested capture was invalid. Check amount exceeds the authorized amount or orginal transaction. | |
| ALREADY_ACTIVE_PREPAID_CARD | Gift card account or prepaid card account is already active. |
Payout service
| Status | Error code | Message |
|---|---|---|
| 400 | SUBMALL_NOT_FOUND | Not existing sub-merchant |
| 400 | PAYOUT_NOT_FOUND | Not existing payout request |
| 400 | INVALID_SUBMALL_STATUS | Inactivated sub-merchant |
| 400 | INVALID_MERCHANT_STATUS | Invalid merchant status |
| 400 | INVALID_REQUEST | Invalid request |
| 400 | DATE_PARSING_ERROR | Invalid date format |
| 400 | BANK_ACCOUNT_NOT_FOUND | The bank account is not registered. |
| 400 | EXISTING_SUBMALL | Existing sub-merchant |
| 400 | INVALID_BUSINESS_NUMBER | Invalid business registration number |
| 400 | DUPLICATED_PAYOUT_CURRENCY | The currency is already registered. |
| 400 | INVALID_PAYOUT_DATE | A past date or public holiday cannot be set as the payment date. |
| 400 | EXCEEDED_PAYOUT_AMOUNT | Exceeds the allowable payment amount. |
| 400 | DUPLICATED_PAYOUT_REQUEST | Duplicated payout request |
| 400 | INVALID_SUBMALL_INFO | Required sub-merchant value is missing |
| 400 | INVALID_PAYOUT_REQUEST | Invalid request |
| 400 | FORBIDDEN_SUBMALL_IN_PAYOUT | Sub-merchant verification process is incomplete |
| 400 | NOT_SUPPERTED_CURRENCY | The currency is not supported for this transaction. |
| 400 | FORBIDDEN_PAYOUT_CANCEL_IN_REQUEST | A refund can be processed only when the transaction is in 'Request' status. |
| 400 | INVALID_ACCOUNT_INFO | Beneficiary Account inquiry failed. |
| 400 | INSUFFICIENT_PAYOUT_AMOUNT | The payment amount is below the minimum allowed threshold. (include hana bank KRW: 4000won / USD:$4 / JPY: 400 yen) |
| 400 | SUBMALL_IS_AUDITING | The sub-merchant's information cannot be modified during the verification process. |
| 400 | INVALID_URL | Invalid URL format. |
| 400 | URL_NOT_CORRECT | The registered URL does not exist. |
| 400 | NOT_CONFIGURED_BANK_ACCOUNT | The currency associated with the bank account cannot be found. |
| 400 | PENDING_PAYOUT_REQUEST_EXIST | The payment request is in the waiting list for the bank account. |
