에러 코드
DP : DMPlus 인증 실패
코드 | Message | 상세 설명 |
---|---|---|
DP00 | DmPlus Confirm fail | DmPlus 인증 시 응답 코드가 성공이 아닌 경우 |
DP01 | DmPlus Confirm fail | DmPlus 인증 시 status가 1이 아닌 경우 |
EC: 요청 파라미터 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
EC00 | Invalid request parameter | 가맹점 요청 파라미터 오류 (메시지 참고) |
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: 외부 통신 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
EE00 | Connect Error | 각 결제사 통신 Connect 중 에러 발생 |
EE01 | Write Error | 각 결제사 통신 시 Write 중 에러 발생 |
EE02 | Read Error | 각 결제사 통신 시 Read 중 에러 발생 |
EE99 | Communication Error | 각 결제사 통신 중 정의되지 않은 에러 발생 |
EEEE | Duplicated page call | 결제사 응답 수신 페이지 중복 호출 |
EM00 | Internal server error occurred | Request can’t be processed due to server disconnection. Please try again later |
EX: 내부 시스템 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
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: 고객으로부터 입력 받는 값에 대해 처리 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
HE00 | Invalid card number | 카드 번호 오류 |
HE01 | Invalid expiry date | 유효 기간 오류 |
HE02 | Invalid cvc | CVC 오류 |
HE03 | Invalid amount | 금액 오류 |
HE04 | Invalid product | 상품명 오류 |
HE05 | Invalid Properties | Properties 오류 |
HE06 | Data Parsing Fail | 데이터 파싱 중 에러 발생 |
HE07 | Invalid email | 페이팔 이메일 검증 오류 |
HE99 | Data Prossing Error | 정의 되지 않은 오류 |
IE: 내부 통신 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
IE00 | Connect Error | GW 통신 Connect 중 에러 발생 |
IE01 | Write Error | GW 통신 Write 중 에러 발생 |
IE02 | Read Error | GW 통신 Read 중 에러 발생 |
IE99 | Communication Error | GW 통신 중 정의되지 않은 에러 발생 |
ND: 내부 통신 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
ND00 | Invalid exchange rate data | keb_exgrt_group 환율 그룹 정보 데이터 조회 실패 |
ND01 | Invalid exchange rate data | keb_exgrt_list 환율 데이터 조회 실패 (요청 통화 확인 필요) |
ND02 | Invalid merchant data | 가맹점 정보 조회 실패 (mid 확인 필요) |
ND03 | Invalid merchant data | 승인 정보 조회 실패 (mid, 결제 수단, 요청 통화, 가맹점 상태 확인 필요 |
ND04 | Invalid van data | Van 정보 조회 실패 (결제 수단, mid, 요청 통화 확인 필요) |
ND05 | Invalid 3DS setting | 가맹점 3D 설정 정보 조회 실패 (결제 수단, mid, 요청 통화 확인 필요) |
ND06 | Invalid domestic van data | 국내 매입사 정보 조회 실패 (결제 수단 확인 필요) |
ND07 | Invalid tokenID | 토큰ID 조회 실패 (tokenID 확인 필요) |
ND08 | Invalid payment method | 결제 수단 조회 실패 (mid, 요청 통화, 가맹점 상태 확인 필요) |
ND10 | Invalid dmplus account | DM PLUS 계정 정보 조회 실패 (mid 및 설정 확인 필요) |
ND11 | Invalid ctxno | DM PLUS paramkey 조회 실패 (ctxNo 확인 필요) |
ND12 | Invalid dmplus account | DM PLUS 정보 조회 실패 (TokenID 확인 필요) |
ND13 | Invalid alipay account | Alipay 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단 확인 필요) |
ND14 | Invalid bcupop account | Bc Upop 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단 확인 필요) |
ND15 | Invalid bcupop account | Bc Upop 취소 정보 조회 실패 (원 숭인 거래 transid 확인 필요) |
ND16 | Invalid bcupop token data | Bc Upop 토큰 거래 정보 조회 실패 (TokenID, mno, token password, 토큰 상태 확인 필요) |
ND17 | Invalid bcupop token data | Bc Upop 토큰 정보 조회 실패 (TokenID, mno, 토큰 상태 확인 필요) |
ND18 | Invalid bestpay account | BestPay 계정 정보 조회 실패 (mid, 결제 수단 확인 필요) |
ND19 | Invalid bestpay account | ChinaPnr 취소 정보 조회 실패 (원 승인 거래 transid 확인 필요) |
ND20 | Invalid chinapnr account | ChinaPnr 계정 정보 조회 실패 (요청 통화, 결제 수단, mid, paymethod_accounts.payseq 확인 필요) |
ND21 | Invalid chinapnr account | ChinaPnr 취소 정보 조회 실패 (원 승인 거래 transid 확인 필요) |
ND22 | Invalid cybs orginal account | Cybs 취소 정보 조회 실패 (원 승인 거래 transid 확인 필요) |
ND23 | Invalid econtext account | Econtext 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단 확인 필요) |
ND24 | Invalid kakaopay account | Kaokaopay 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단 확인 필요) |
ND25 | Invalid kakaopay account | Kaokaopay 취소 정보 조회 실패 (원 승인 거래 transno 확인 필요) |
ND26 | Invalid lotteupop account | Lotte Upop 계정 정보 조회 실패 (transid 확인 필요) |
ND27 | Invalid lotteupop transaction | Lotte Upop 거래 정보 조회 실패 (transid 확인 필요) |
ND28 | Invalid lotteupop account | Lotte Upop 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND29 | Invalid nttd account | Ntt 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단, 가맹점 상태 확인 필요) |
ND30 | Invalid nttd account | Ntt 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND31 | Invalid payco account | Payco 계정 정보 조회 실패 (mid, 결제 수단, 가맹점 상태 확인 필요) |
ND32 | Invalid payco account | Payco 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND33 | Invalid payeasy account | Payeasy 계정 정보 조회 실패 (mid 확인 필요) |
ND34 | Invalid payeasy account | Payeasy 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND35 | Invalid paypal submall | Paypal SubMall 조회 실패 |
ND36 | Invalid paypalrest account | Paypal Rest 계정 정보 조회 실패 (transid 확인 필요) |
ND37 | Invalid paypalrest account | Paypal Rest 취소 정보 조회 실패 (원 승인 transno 확인 필요) |
ND38 | Invalid samsungupop account | Samsung Upop 계정 정보 조회 실패 (mid, 요청 통화, 결제 수단) |
ND39 | Invalid samsungupop orginal transaction | Samsung Upop 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND40 | Invalid settlebank virtual account | SettleBank 계정 가상 계좌 정보 조회 실패 (선택 은행 확인 필요) |
ND41 | Invalid settlebank account | SettleBank 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND42 | Invalid shinhanupop account | Shinhan Upop 계정 정보 조회 실패 (transid 확인 필요) |
ND43 | Invalid shinhanupop account | Shinhan Upop 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND44 | Invalid tenpay account | Tenpay 계정 정보 조회 실패 (paymethod_accounts. PAYSEQ, mid, 승인 통화, 결제 수단 확인 필요) |
ND45 | Invalid tenpay account | Tenpay 취소 정보 조회 실패 (paymethod_accounts. PAYSEQ 확인 필요) |
ND46 | Invalid toss account | Toss 계정 정보 조회 실패 (mid 확인 필요) |
ND47 | Invalid toss account | Toss 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND48 | Invalid toss original trasnaction | Toss 원 거래 정보 조회 실패 (원 승인 transid 확인 필요) |
ND49 | Invalid wechat account | Wechat 계정 정보 조회 실패 (mid, 결제 수단, 요청 통화 확인 필요) |
ND50 | Invalid wechat account | Wechat 취소 정보 조회 실패 (원 승인 transid 확인 필요) |
ND51 | Invalid yendex account | Yandex 계정 정보 조회 실패 (transid 확인 필요) |
ND52 | Invalid yendex original trasnaction | Yandex 원 거래 정보 조회 실패 (원 승인 transid 확인 필요) |
ND53 | Invalid small merchant orginal transaction | 국내 영중소 가맹점 원 거래 조회 실패 (원 승인 transid 확인 필요) |
ND54 | Invalid small merchant orginal transaction | 국내 영중소 원 승인 잔여 금액 조회 실패 (transid 확인 필요) |
ND55 | Invalid lastID | last_insert_id 조회 실패 |
ND56 | Invalid orginal transaction | 취소 시 원 거래 조회 실패 (원 승인 transid, ref, mid 확인 필요) |
ND57 | Invalid re orginal transaction | 재 승인 거래 정보 조회 실패 |
ND58 | Invalid minorunit | Minorunit 조회 실패 (요청 통화 확인 필요) |
ND59 | Invalid invoice account | Invoice 거래 정보 조회 실패 (invoiceno 확인 필요) |
ND60 | Invalid DCC transaction info | DCC 거래 정보 조회 실패 (rateid 확인 필요) |
ND61 | Invalid 3D transaction info | 3D 거래 정보 조회 실패 (ordernumber 확인 필요) |
ND62 | Invalid PAYER_AUTH transaction info | PAYER_AUTH 거래 조회 실패 (ordernumber 확인 필요) |
ND63 | Invalid bankpay account | bankpay 계정 정보 조회 실패 (mid, cur, cardcode 확인 필요) |
ND64 | Invalid cybs account | CYBS 옵타옴 계정 정보 조회 실패 (mid, cur, cardcode 확인 필요) |
ND65 | Invalid econtext orginal transaction | Econtext 원 거래 정보 조회 실패 (transid 확인 필요) |
ND66 | Invalid molpay account | Molpay 계정 정보 조회 실패 (transid 확인 필요) |
ND67 | Invalid samsungupop transaction | Samsungupop 거래 조회 실패 (transid 확인 필요) |
ND68 | Invalid dm account | DM 계정 정보 조회 실패 (merchantid 확인 필요) |
ND69 | Invalid transaction | 승인 거래 조회 실패 |
ND70 | Invalid auth transaction | Auth 원 거래 조회 실패 |
ND71 | Invalid recurringID | RecurringID 정보 조회 실패 |
ND74 | Invalid VN eWallet account | 베트남 간편 결제 계정 조회 실패 |
PC: 승인 프로세스 처리 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
PC00 | Not supprot invoice | Invoice 결제 불가 (tokenbillingYN 확인 필요) |
PC01 | Duplicated request invoice | 인보이스 거래 중복 요청 |
PC02 | Invoice amount mismatch | 인보이스 금액, 요청 금액 불일치 |
PC03 | Duplicated request ref | Ref 중복 요청으로 인해 거래 거절 |
PC04 | Not supprot payment method | 사용 가능 결제 수단 없음 (요청 통화 및 결제 수단 확인) |
PC05 | Not supprot card | 해외 사업자의 경우 국민, 비씨, 신한 카드만 지원 |
PC06 | Nationality, CardCountry mismatch | 결제 요청 시 올린 국가와 입력한 카드 발급 국가 불일치 |
PC07 | Credit cards issued in korea cannot be used | 해외 결제 시 한국 발급 카드 사용 불가 |
PC08 | Minimum amount error | 최소 금액보다 승인 요청 금액 작을 경우 승인 불가 |
PC09 | Paymethod, CardCountry mismatch | 결제 요청 시 올라온 Paymethod 와 카드 발급 국가 불일치 |
PC10 | Upop Merchant Hosted missing required data | UPOP 간편 결제 필수 데이터 오류 |
PC11 | BankPay missing required data | BankPay 필수 데이터 오류 |
PC12 | BankPay missing required data | BankPay 필수 데이터 오류 |
PC13 | Not support capture | capture를 지원하지 않는 결제 수단 |
PC14 | Not support debit card | 농협 체크 카드 미 지원(RM) |
PC15 | Already requested by same information | 3DS 인증 완료 페이지 중복 호출 시 발생 |
PC16 | Missing cybs parres data | Cybs PaRes 데이터 오류 |
PC17 | Already requested by same information. | 페이지 중복 호출 시 발생 |
PC18 | Already AUTHORIZE_PA trasnaction success | 이미 완료 된 AUTHORIZE_PA 거래 건 재 요청 시 발생 |
PC19 | Already PAYMENT_PA trasnaction success | 이미 완료 된 PAYMENT_PA 거래 건 재 요청 시 발생 |
PC20 | Invalid 3DS setting | 3D 설정 미 등록 상태로 3D 인증 진행하려고 할 경우 발생 |
PC21 | Mid swap error | DCC, 일반 결제, 국내 결제 등 으로 인한 mid Swap 시 설정 된 mid가 없어 Swap 실패 |
PC22 | Not support currency | DCC 지원하지 않는 통화 |
PC23 | Invalid mpitype | Mpitype 오류 |
PC24 | Invalid bankcode | Bankcode 오류 |
PC25 | Not supprot dcc | Dcctype 오류 (요청 통화, 승인 통화 확인) |
PC26 | Invalid exchangetype | exchangetype 오류 |
PC27 | Invalid stauts | status 오류 (가맹점 상태, 결제 수단 상태 확인) |
PC28 | Cardnumber mismatch | ENROLLMENT, PAVALIDATE 진행 시 카드 정보와 Non-UI 요청 시 카드 정보가 상이 |
PC29 | Invalid recurring settting | Recurring 설정 오류 |
PC30 | Invalid dcctype setting | Dcctype 오류 |
PC31 | Invalid cardcode | Cardcode 오류 |
PC32 | Invalid inst | inst 오류 |
PC33 | Invalid user info | User info 오류(Settlebank username, accountnumber 확인) |
PC34 | Invalid recurringdata | recurringdata 오류(recurringamt 당일 변경 불가) |
PC35 | Invalid midkr | midkr 오류 |
PC36 | Invalid cur or paymethod | 요청 통화, paymethod가 둘 다 세팅되어 올라왔지만 해당 결제 수단에 요청 통화 등록되어 있지 않음 |
PC37 | Not support dcctype | Rebill Dcctype 미지원(가맹점 설정 확인) |
PC38 | This card can not be used. | 법인카드 미지원 |
PC39 | This card can not be used. | 유니온페이(비씨 매입사)에 한해 아멕스 카드 미 지원 |
PC40 | Card company and card number mismatch | 고객 선택 카드사와 카드번호가 일치하지 않을 경우 |
PC41 | It is not a domestic card number | 국내 비인증 결제에 해외 카드 번호 입력했을 경우 |
PC42 | Not Support Domestic Personal Card | 국내 개인 카드 미지원 |
PC99 | Data prossing error | 정의 되지 않은 오류 |
Q: 거래조회 오류
코드 | Message | 상세 설명 |
---|---|---|
Q001 | ref Missmatch | ref 불일치 |
Q002 | cur Missmatch | cur 불일치 |
Q003 | amt Missmatch | amt 불일치 |
Q004 | No Transaction | 거래 없음 |
Q005 | transid Missmatch | transid가 취소 건 이면 발생 |
Q006 | Not Success Transaction | 정상 승인 거래 건이 아닐 경우 발생 |
Q007 | No Payment Result | 결제 결과 없음 |
RC: 취소 프로세스 처리 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
RC01 | OrgAmt, ReqAmt mismatch | 원 승인 금액, 취소 요청 금액 불일치 |
RC02 | OrgCur, ReqCur mismatch | 원 승인 통화, 취소 요청 통화 불일치 |
RC03 | Not support refund | 취소를 지원하지 않는 결제 수단 |
RC04 | Not supprot partial refund | Auth, Register 부분 취소 불가 |
RC05 | Not support refund | 취소를 지원하지 않는 원 거래 상태 |
RC06 | Not support full refund | 전체 취소 요청이지만 부분 취소 된 내역 존재 |
RC07 | Refund amount error | 전체 취소 요청이지만 부분 취소 금액 요청 |
RC08 | Refund amount error | 원 승인 금액이 취소 요청 금액 보다 큽니다 |
RC09 | Refund amount error | 원 승인 금액 > 취소 요청 금액 + 이미 취소 된 금액 |
RC10 | Balance mismatch | 현재 남아있는 Balance와 요청 파라미터 Balance 불일치 |
RC11 | Duplicated refundid | Refundid 중복 요청으로 인해 취소 거절 |
RC12 | Duplicated balance | Balance 중복 요청으로 인해 취소 거절 |
RC13 | Undefined means of payment | 정의되지 않은 결제 수단 (취소) |
RC14 | Refund expiration | 취소 유효 기간 만료 |
RC15 | Not support refund | 이미 Caputre 진행 된 auth 거래 취소 불가 |
RC16 | Invalid upoptype | Upoptype 오류 |
TL: 내부 거래 제한 코드
코드 | Message | 상세 설명 |
---|---|---|
TL00 | Decline | 거래제한 : 건별 한도초과 |
TL01 | Decline | 거래제한 : 동일카드 일 거래금액 제한 |
TL02 | Decline | 거래제한 : 동일카드 일 거래횟수 제한 |
TL03 | Decline | 거래제한 : 동일카드 주 거래금액 제한 |
TL04 | Decline | 거래제한 : 동일카드 주 거래횟수 제한 |
TL05 | Decline | 거래제한 : 동일카드 월 거래금액 제한 |
TL06 | Decline | 거래제한 : 동일카드 월 거래횟수 제한 |
TL11 | Decline | 거래제한 : 동일 IP 일 거래금액 제한 |
TL12 | Decline | 거래제한 : 동일 IP 일 거래횟수 제한 |
TL13 | Decline | 거래제한 : 동일 IP 주 거래금액 제한 |
TL14 | Decline | 거래제한 : 동일 IP 주 거래횟수 제한 |
TL15 | Decline | 거래제한 : 동일 IP 월 거래금액 제한 |
TL16 | Decline | 거래제한 : 동일 IP 월 거래횟수 제한 |
TS: 3DS(인증) 오류 코드>
코드 | Message | 상세 설명 |
---|---|---|
TS01 | Decline - 3DS | 3DS 인증 실패 (3D - Not Enrolled) |
TS02 | Decline - 3DS | 3DS 인증 실패 (Cardholder Authentication Unavailable) |
TS03 | Decline - 3DS | 3DS 인증 실패 (Error) |
TS21 | Decline - 3DS | 3DS 인증 실패 (Authentication is not completed) |
TS22 | Decline - 3DS | 3DS 인증 실패 (Customer was presented with the authentication screen however either clicked the "exit" option or was unable to provide the correct password) |
VE: Fgkey, 결제사 Sign 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
VE00 | Invalid fgkey | Fgkey 불일치 |
VE01 | Invalid sign | 결제사 Sign 불일치 |
W: 내부 프로세스 오류 코드
코드 | Message | 상세 설명 |
---|---|---|
W998 | Expired payment request | 만료 된 결제 요청 (10분) |
W999 | Decline | 올바르지 않은 페이지 호출 (Paramkey 없음) |
X: 결제사 승인, 취소 실패 코드
코드 | Message | 상세 설명 |
---|---|---|
X000 | Card payment fail | 해외 카드 발급사 거래 거절 (resmsg 참고) |
X003 | Alipay payment fail | 알리페이 거래 거절 |
X006 | Paypal payment fail | 페이팔 거래 거절 |
X017 | Tenpay payment fail | 텐페이 거래 거절 |
X023 | Econtext payment fail | 이컨 결제 실패 |
X025 | LotteUpop payment fail | 롯데유팝 거래 거절 |
X026 | Molpay payment fail | 몰페이 거래 거절 |
X033 | SamSungUpop payment fail | 삼성유팝 거래 거절 |
X035 | Wechat payment fail | 위챗 거래 거절 |
X037 | BcUpop payment fail | 비씨유팝 거래 거절 |
X039 | ChinaPnR payment fail | 차이나피엔알 거래 거절 |
X041 | ShinHanUpop payment fail | 신한유팝 거래 거절 |
X042 | KakaoPay payment fail | 카카오페이 거래 거절 |
X048 | Toss payment fail | 토스 거래 거절 |
X049 | Paypal payment fail | 페이팔 결제 실패 |
X050 | BestPay payment fail | 베스트페이 거래 거절 |
X051 | Yandex payment fail | 얀덱스 거래 거절 |
X052 | SettleBank payment fail | 올바르지 않은 페이지 호출 (세틀뱅크 거래 거절 없음) |
X053 | NTT payment fail | 엔티티 거래 거절 |
X054 | PAYCO payment fail | 페이코 거래 거절 |
X056 | SmilePay payment fail | 스마일 페이 결제 실패 |
X059 | NaverPay payment fail | 네이버 페이 결제 실패 |
X060 | Cybs payment fail | 사이버소스 결제 실패 |
XXXX | Cancellation of transaction | 사용자 거래 중단 |
망 취소
코드 | Message | 상세 설명 |
---|---|---|
0420 | Reversal | 가맹점 측에서 응답 데이터 정상 수신하지 못하여 망 취소 처리 |