Error Codes
DP: DM Plus authentication failed
| Code | Message | Description |
|---|---|---|
| DP00 | DmPlus Confirm fail | Response code is not successful during DmPlus authentication |
| DP01 | DmPlus Confirm fail | Status is not 1 during DmPlus authentication |
EC:Request parameter errors
| Code | Message | Description |
|---|---|---|
| EC00 | Invalid request parameter | Merchant request parameter error (refer to error message) | EC1000 | Authorization required | Check if authorization header exists or is not null |
| EC1000 | Authorization invalid | Check if encoded authorization is appropriate |
| EC1001 | Content type invalid | Check if content type is application/json |
| EC1002 | TransactionID required | Check if transaction_id is not null |
| EC1002 | TransactionID invalid | Check if transaction_id is correct |
| EC1002 | TransactionID length limited | Check if transaction_id length is 24 |
| EC1003 | HTTP method invalid | Check if HTTP method matches the current API/SDK |
EE: External communication errors
| Code | Message | Description |
|---|---|---|
| EE00 | Connect Error | Connect Error during communicate with payment company |
| EE01 | Write Error | Write Error during communicate with payment company |
| EE02 | Read Error | Read Error during communicate with payment company |
| EE99 | Communication Error | Communication Error during communicate with payment company |
| EEEE | Duplicated page call | Duplicate page invocation for receiving payment company response |
| EM00 | Internal server error occurred | Request can’t be processed due to server disconnection. Please try again later |
EX: Internal system errors
| Code | Message | Description |
|---|---|---|
| EX00 | SQLException | SQLException |
| EX01 | NumberFormatException | NumberFormatException |
| EX02 | JsonProcessingException | JsonProcessingException |
| EX99 | Exception | Exception |
| EX1000 | Internal server error occurred | Request can’t be processed. Please contact Eximbay support team (technicalsupport@eximbay.com) |
HE: Error code for the value input from the customer
| Code | Message | Description |
|---|---|---|
| HE00 | Invalid card number | card number error |
| HE01 | Invalid expiry date | card expiration date error |
| HE02 | Invalid cvc | CVC error |
| HE03 | Invalid amount | amount error |
| HE04 | Invalid product | product name error |
| HE05 | Invalid Properties | Error of properties |
| HE06 | Data Parsing Fail | Error during parsing the data |
| HE07 | Invalid email | PayPal Email Verification Error |
| HE99 | Data Prossing Error | undefined error |
IE: Internal communication errors
| Code | Message | Description |
|---|---|---|
| IE00 | Connect Error | Connect errors during communicate with GW |
| IE01 | Write Error | Write errors during communicate with GW |
| IE02 | Read Error | Read errors during communicate with GW |
| IE99 | Communication Error | Communication errors during communicate with GW |
ND: Setting Error Code
| Code | Message | Description |
|---|---|---|
| ND00 | Invalid exchange rate data | Failed to retrieve keb_exgrt_group exchange rate group information data |
| ND01 | Invalid exchange rate data | Failed to retrieve keb_exgrt_list exchange rate data(check confirmation of requested currency) |
| ND02 | Invalid merchant data | Failed to check merchant information (check mid verification) |
| ND03 | Invalid merchant data | Failed to check approval information (check mid, payment method, request currency, merchant status) |
| ND04 | Invalid van data | Failed to check Van information (check payment method, mid, request currency) |
| ND05 | Invalid 3DS setting | Failed to check merchant 3D setting information (check payment method, mid, request currency) |
| ND06 | Invalid domestic van data | Failed to check information of domestic acquirer (check payment method) |
| ND07 | Invalid tokenID | Failed to retrieve Token ID (check Token ID verifiaction) |
| ND08 | Invalid payment method | Failed to check payment method (check mid, request currency, merchant status) |
| ND10 | Invalid dmplus account | Failed to check DMPLUS account information (check mid and setting verification) |
| ND11 | Invalid ctxno | DM PLUS paramkey inquirey failed (check ctxNo) |
| ND12 | Invalid dmplus account | DM PLUS information inquiry failed (check TokenID) |
| ND13 | Invalid alipay account | Failed to check Alipay account information (check mid, request currency, payment method) |
| ND14 | Invalid bcupop account | Failed to check Bc Uppop account information (check mid, request currency, payment method) |
| ND15 | Invalid bcupop account | Bc Upop cancellation information inquiry failed (check the original approved transaction transid) |
| ND16 | Invalid bcupop token data | Bc Upop cancellation information inquiry failed (check the original approved transaction transid) |
| ND17 | Invalid bcupop token data | Bc Upop token transaction information inquiry failed (check TokenID, mno, token password, token status) |
| ND18 | Invalid bestpay account | Bc Upop token information inquiry failed (check TokenID, mno, token status) |
| ND19 | Invalid bestpay account | BestPay account information inquiry failed (check mid, payment method) |
| ND20 | Invalid chinapnr account | Failed to check ChinaPnr cancellation information (check original approved transid) |
| ND21 | Invalid chinapnr account | Failed to check ChinaPnr account information (check request currency, payment method, mid, paymethod_accounts.Payseq) |
| ND22 | Invalid cybs orginal account | Failed to check ChinaPnr cancellation information (requires confirmation of original approved transid) |
| ND23 | Invalid econtext account | Cybs cancellation information inquiry failed (requires confirmation of original approved transid) |
| ND24 | Invalid kakaopay account | Econtext account information inquiry failed (mid, request currency, payment method check required) |
| ND25 | Invalid kakaopay account | Failed to check Kaokaopay account information (check mid, request currency, payment method) |
| ND26 | Invalid lotteupop account | Failed to check Kaokaopay cancellation information (check original approved transaction transno) |
| ND27 | Invalid lotteupop transaction | Lotte Uppop account information inquiry failed (check transid) |
| ND28 | Invalid lotteupop account | Lotte Upop transaction information inquiry failed (check transid) |
| ND29 | Invalid nttd account | Failed to check Lotte Upop cancellation information (check original approval transid) |
| ND30 | Invalid nttd account | Failed to check Ntt account information (check mid, request currency, payment method, merchant status) |
| ND31 | Invalid payco account | Ntt cancellation information inquiry failed (check original approval transid) |
| ND32 | Invalid payco account | Failed to check Payco account information (check mid, payment method, merchant status) |
| ND33 | Invalid payeasy account | Failed to check Payco cancellation information (check original approval transid) |
| ND34 | Invalid payeasy account | Payeasy account information inquiry failed (check mid) |
| ND35 | Invalid paypal submall | PayPal SubMall inquiry failed |
| ND36 | Invalid paypalrest account | Payeasy cancellation information inquiry failed (check original approval transid) |
| ND37 | Invalid paypalrest account | PayPal SubMall inquiry failed |
| ND38 | Invalid samsungupop account | Failed to check PayPal Rest account information (check transid) |
| ND39 | Invalid samsungupop orginal transaction | Failed to check PayPal Rest cancellation information (check original approval transno) |
| ND40 | Invalid settlebank virtual account | Failed to check Samsung Upop account information (check mid, request currency, payment method) |
| ND41 | Invalid settlebank account | SetleBank cancellation information inquiry failed (check original approval transid verification) |
| ND42 | Invalid shinhanupop account | Shinhan Upop account information inquiry failed (check transid) |
| ND43 | Invalid shinhanupop account | Failed to check Shinhan Upop cancellation information (check original approval transid) |
| ND44 | Invalid tenpay account | Tenpay account information inquiry failed (check paymethod_accounts.PAYSEQ, mid, approval currency, payment method) |
| ND45 | Invalid tenpay account | Tenpay cancellation information inquiry failed(check paymethod_accounts.PAYSEQ) |
| ND46 | Invalid toss account | Failed to check Toss account information (check mid) |
| ND47 | Invalid toss account | Toss cancellation information inquiry failed (check original approval transid) |
| ND48 | Invalid toss original trasnaction | Toss original transaction information inquiry failed (check original approval transid) |
| ND49 | Invalid wechat account | Failed to check Wechat account information (check mid, payment method, request currency) |
| ND50 | Invalid wechat account | Failed to check Wechat cancellation information (check original approval transid) |
| ND51 | Invalid yendex account | Yandex account information inquiry failed (check transid) |
| ND52 | Invalid yendex original trasnaction | Failed to check Yandex original transaction information (check original approval transid) |
| ND53 | Invalid small merchant orginal transaction | Failed to check the original transaction of Korea small and medium-sized merchants (check the original approved transid) |
| ND54 | Invalid small merchant orginal transaction | Failed to check the remaining amount approved by the Korea small and medium-sized merchants (check transid) |
| ND55 | Invalid lastID | Failed to inquiry last_insert_id |
| ND56 | Invalid orginal transaction | Failed to check original transaction (check original approved transid, ref, mid) |
| ND57 | Invalid re orginal transaction | Failed to inquiry Re-approval transaction information |
| ND58 | Invalid minorunit | Failed to inquiry Minorunit (check request currency) |
| ND59 | Invalid invoice account | Failed to inquiry Invoice transaction information (check invoiceno) |
| ND60 | Invalid DCC transaction info | Failed to inquiry DCC transaction information (check rateid) |
| ND61 | Invalid 3D transaction info | Failed to inquiry 3D transaction information (chekc ordernumber) |
| ND62 | Invalid PAYER_AUTH transaction info | Failed to inquiry PAYER_AUTH transaction (check ordernumber) |
| ND63 | Invalid bankpay account | Failed to inquiry Bankpay account information (check mid, cur, card code) |
| ND64 | Invalid cybs account | Failed to check CYBS Optaom account information (check mid, cur, and card code) |
| ND65 | Invalid econtext orginal transaction | Failed to inquiry Econtext original transaction information(check transid) |
| ND66 | Invalid molpay account | Failed to inquiry Molpay account information (check transid) |
| ND67 | Invalid samsungupop transaction | Failed to inquiry Samsungupop transaction (check transid) |
| ND68 | Invalid dm account | Failed to check DM account information (check merchantid) |
| ND69 | Invalid transaction | Failed to query approval transaction |
| ND70 | Invalid auth transaction | Failed to inquiry original transaction of Auth |
| ND71 | Invalid recurringID | Failed to inquiry RecurringID information |
| ND74 | Invalid VN eWallet account | Vietnam alternative payment methods account |
PC: Approval Process Handling Error Codes
| Code | Message | Description |
|---|---|---|
| PC00 | Not supprot invoice | Unable to supprot Invoice (Need to check tokenbillingYN) |
| PC01 | Duplicated request invoice | Duplicate Invoice Transaction Request |
| PC02 | Invoice amount mismatch | Invoice amount, request amount mismatch |
| PC03 | Duplicated request ref | Transaction rejected due to duplicate Ref |
| PC04 | Not supprot payment method | No payment method available (check request call and payment method) |
| PC05 | Not supprot card | For overseas business, only KB, BC and Shinhan Card are supported. |
| PC06 | Nationality, CardCountry mismatch | There is mismatch between nationality and card issued country when requesting payment. |
| PC07 | Credit cards issued in korea cannot be used | You can't use a Korean issued card when you pay overseas. |
| PC08 | Minimum amount error | Unable to approve if the approval request amount is less than the minimum amount. |
| PC09 | Paymethod, CardCountry mismatch | Payment method and card issuance country mismatch when requesting payment. |
| PC10 | Upop Merchant Hosted missing required data | UPOP required data errors. |
| PC11 | BankPay missing required data | BankPay required data errors. |
| PC12 | BankPay missing required data | txntype not supported by specific process. |
| PC13 | Not support capture | Payment method that does not support capture. |
| PC14 | Not support debit card | Nonghyup Check Card Not Supported (RM) |
| PC15 | Already requested by same information | Occurs on duplicate invocation of 3DS authenticated page. |
| PC16 | Missing cybs parres data | Cybs PaRes data errors. |
| PC17 | Already requested by same information. | Occurs when page duplication is invoked. |
| PC18 | Already AUTHORIZE_PA trasnaction success | Occurs when requesting the reconstruction of AUTHORIZE_PA transaction that has already been completed. |
| PC19 | Already PAYMENT_PA trasnaction success | Occurs when requesting the reconstruction of PAYMENT_PA transaction that has already been completed |
| PC20 | Invalid 3DS setting | Occurs when attempting to proceed with 3D authentication without 3D setup registered. |
| PC21 | Mid swap error | Swap fails because there is no mid set during mid swap due to DCC, general payment, domestic payment, etc. |
| PC22 | Not support currency | The currency does not support DCC. |
| PC23 | Invalid mpitype | Error with Mpitype. |
| PC24 | Invalid bankcode | Error with Bankcode. |
| PC25 | Not supprot dcc | Error with Dcctype (Need to check request currency or apporval currency.) |
| PC26 | Invalid exchangetype | Error with exchangetype |
| PC27 | Invalid stauts | Error with status (Need to check merchant status or payment methods.) |
| PC28 | Cardnumber mismatch | When ENROLLENT and PAVALIDATE are in progress, the card information is different from the non-UI request. |
| PC29 | Invalid recurring settting | Error with Recurring setting. |
| PC30 | Invalid dcctype setting | Error with Dcctype. |
| PC31 | Invalid cardcode | Error with Cardcode. |
| PC32 | Invalid inst | Error with inst. |
| PC33 | Invalid user info | Error with User info.(Need to check Settlebank username or accountnumber) |
| PC34 | Invalid recurringdata | Error with recurringdata (You cannot change recurringamt on the same day.) |
| PC35 | Invalid midkr | Error with midkr. |
| PC36 | Invalid cur or paymethod | Requested currency, both payment methods have been set up and uploaded, but the requested currency is not registered in the payment method. |
| PC37 | Not support dcctype | Rebill Dcct type not supported (Check merchant settings) |
| PC38 | This card can not be used. | Corporate card not supported. |
| PC39 | This card can not be used. | Amex card not supported only for UnionPay (BC Acquirer). |
| PC40 | Card company and card number mismatch | If the customer's selected credit card company and card number do not match. |
| PC41 | It is not a domestic card number | If you enter an overseas card number for domestic non-authentication payment. |
| PC42 | Not Support Domestic Personal Card | Domestic personal card not supported. |
| PC99 | Data prossing error | undefined error. |
Q: Error Of retrieve a payment
| Code | Message | Description |
|---|---|---|
| Q001 | ref Missmatch | Retrieved ref(order_id) does not match. |
| Q002 | cur Missmatch | Retrieved currency does not match. |
| Q003 | amt Missmatch | Retrieved amount does not match. |
| Q004 | No Transaction | No transaction information has been retrieved |
| Q005 | transid Missmatch | Retrieved transid(transaction_id) is refund transid |
| Q006 | Not Success Transaction | This is not a success authorization transaction |
| Q007 | No Payment Result | There is no payment result |
RC: Refund processing error code
| Code | Message | Description |
|---|---|---|
| RC01 | OrgAmt, ReqAmt mismatch | Original approval amount and requested refund amount are inconsistent. |
| RC02 | OrgCur, ReqCur mismatch | Original approval currency and requested refund currency are inconsistent. |
| RC03 | Not support refund | This payment method does not support refund. |
| RC04 | Not supprot partial refund | Auth and register cannot be partially refund. |
| RC05 | Not support refund | Original transaction that does not support refund |
| RC06 | Not support full refund | Full refund request, but partial refund history exists |
| RC07 | Refund amount error | You request the full refund, but partial refund amount has been requested |
| RC08 | Refund amount error | The original authorization amount is greater than the refund request amount |
| RC09 | Refund amount error | The original authorization amount is greater than the sum of the cancellation request amount and the amount already canceled. |
| RC10 | Balance mismatch | Balance mismatch between remaining balance and request parameter |
| RC11 | Duplicated refundid | Reject the refund beacasue of reqeusting of duplicated refundid |
| RC12 | Duplicated balance | Reject the refund beacasue of reqeusting of duplicated balance |
| RC13 | Undefined means of payment | Undefined Payment Method (Refund) |
| RC14 | Refund expiration | Refundable expiration date has passed |
| RC15 | Not support refund | Refund is impossible because of the auth transaction that has already been captured |
| RC16 | Invalid upoptype | Error of upoptype |
TL: Internal transaction restriction code
| Code | Message | Description |
|---|---|---|
| TL00 | Decline | Transaction restriction: Exceeded limit by case |
| TL01 | Decline | Transaction restriction: Restriction of daily transaction amount of the same card |
| TL02 | Decline | Transaction restriction: Restriction of daily transaction number of the saem card |
| TL03 | Decline | Transaction restriction: Restriction of weekly transaction amount of the same card |
| TL04 | Decline | Transaction restriction: Restriction of weekly transaction number of the saem card |
| TL05 | Decline | Transaction restriction: Restriction of monthly transaction amount of the same card |
| TL06 | Decline | Transaction restriction: Restriction of monthly transaction number of the same card |
| TL11 | Decline | Transaction restriction: Restriction of daily transaction amount of the same IP address |
| TL12 | Decline | Transaction restriction: Restriction of daily transaction number of the same IP address |
| TL13 | Decline | Transaction restriction: Restriction of weekly transaction amount of the same IP address |
| TL14 | Decline | Transaction restriction: Restriction of weekly transaction number of the same IP address |
| TL15 | Decline | Transaction restriction: Restriction of monthly transaction amount of the same IP address |
| TL16 | Decline | Transaction restriction: Restriction of monthly transaction number of the same IP address |
TS: 3DS (Authentication) Error Code
| Code | Message | Description |
|---|---|---|
| TS01 | Decline - 3DS | Decline 3DS: Not Enrolled |
| TS02 | Decline - 3DS | Decline 3DS: Cardholder Authentication Unavailable |
| TS03 | Decline - 3DS | Decline 3DS: Error |
| TS21 | Decline - 3DS | Decline 3DS: Authentication is not completed |
| TS22 | Decline - 3DS | Decline 3DS: Customer was presented with the authentication screen however either clicked the "exit" option or was unable to provide the correct password |
VE: Fgkey, Payment Company sign error code
| Code | Message | Description |
|---|---|---|
| VE00 | Invalid fgkey | Fgkey mismatch |
| VE01 | Invalid sign | Payment company sign mismatch |
W: Internal process error code
| Code | Message | Description |
|---|---|---|
| W998 | Expired payment request | Expired Payment Request (10 minutes) |
| W999 | Decline | Invalid Page Call (No Paramkey) |
X: Payment company approval, cancellation failure code
| Code | Message | Description |
|---|---|---|
| X000 | Card payment fail | Refusal with overseas card issuers (refer to resmsg) |
| X003 | Alipay payment fail | Alipay payment fail |
| X006 | Paypal payment fail | Paypal payment fail |
| X017 | Tenpay payment fail | Tenpay payment fail |
| X023 | Econtext payment fail | Econtext payment fail |
| X025 | LotteUpop payment fail | LotteUpop payment fail |
| X026 | Molpay payment fail | Molpay payment fail |
| X033 | SamSungUpop payment fail | SamSungUpop payment fail |
| X035 | Wechat payment fail | Wechat payment fail |
| X037 | BcUpop payment fail | BcUpop payment fail |
| X039 | ChinaPnR payment fail | ChinaPnR payment fail |
| X041 | ShinHanUpop payment fail | ShinHanUpop payment fail |
| X042 | KakaoPay payment fail | KakaoPay payment fail |
| X048 | Toss payment fail | Toss payment fail |
| X049 | Paypal payment fail | Paypal payment fail |
| X050 | BestPay payment fail | BestPay payment fail |
| X051 | Yandex payment fail | Yandex payment fail |
| X052 | SettleBank payment fail | SettleBank payment fail |
| X053 | NTT payment fail | NTT payment fail |
| X054 | PAYCO payment fail | PAYCO payment fail |
| X056 | SmilePay payment fail | SmilePay payment fail |
| X059 | NaverPay payment fail | NaverPay payment fail |
| X060 | Cybs payment fail | Cybs payment fail |
| XXXX | Cancellation of transaction | Cancellation of transaction |
Network Cancellation
| Code | Message | Description |
|---|---|---|
| 0420 | Reversal | Network cancellation processing because merchant did not receive the response data |
