코드표
부트페이에서 내부적으로 사용하는 코드표를 확인할 수 있어요.
API 연동 시 참고해주세요.
PG
결제 요청시payload.pg = "나이스페이"또는payload.pg = "nicepay"와 같이 PG사를 지정할 수 있습니다. 한글, 영어 모두 사용 가능합니다.
| 한글 | 영어 |
|---|
| 이니시스 | inicis |
| 케이씨피 | kcp |
| 나이스페이 | nicepay |
| 다날 | danal |
| 토스 | toss |
| 페이레터 | payletter |
| 이지페이 | easypay |
| 카카오 | kakao |
| 페이코 | payco |
| 세틀뱅크 | settlebank |
| 티페이 | tpay |
| 웰컴페이먼츠 | welcome |
| 스마트로 | smartro |
| 페이앱 | payapp |
| 키움 | kiwoom |
| 네이버페이 | naverpay |
| 페이팔 | paypal |
결제수단
결제 요청시payload.method = "카드"또는payload.method = "card"와 같이 결제수단을 지정할 수 있습니다. 한글, 영어 모두 사용 가능합니다.
만약 결제수단을 지정하지 않게되면 통합결제창이 뜨게 됩니다. 통합결제창은PG 설정한 결제수단이 모두 노출되는 UI를 말합니다.
| 한글 | 영어 | 설명 |
|---|
| 휴대폰 | phone | 휴대폰 소액결제 |
| 카드 | card | 신용카드 결제 |
| 계좌이체 | bank | 실시간 계좌이체 |
| 가상계좌 | vbank | 가상계좌 이체 |
| 간편 | easy | 카카오/페이코가 PG인 경우 간편결제 |
| 간편자동 | easy_rebill | 카카오/페이코가 PG인 경우 간편자동결제 (정기결제) |
| 카드자동 | card_rebill | 카드 자동결제 |
| 카카오페이 | kakaopay | PG에서 제공하는 카카오페이 결제 |
| 네이버페이 | naverpay | PG에서 제공하는 네이버페이 결제 |
| 페이코 | payco | PG에서 제공하는 페이코 결제 |
| 토스 | toss | PG에서 제공하는 토스 결제 |
| 간편카드 | easy_card | 카드자동결제에서 간편결제가 활성화 된 경우 간편결제 |
| 간편카드자동 | easy_card_rebill | 카드자동결제에서 간편결제가 활성화 된 경우 간편자동결제 |
| 본인인증 | auth | 본인인증 |
| 디지털카드 | digital_card | 비실물 카드 결제 |
| 디지털계좌이체 | digital_bank | 비실물 계좌이체 결제 |
| 디지털카드자동 | digital_card_rebill | 비실물 디지털 카드 자동결제 |
| 삼성페이 | samsungpay | 삼성페이 직연동 |
| 애플페이 | applepay | 애플페이 직연동 |
| 컬쳐랜드 | cultureland | 컬쳐랜드 문화상품권 결제 |
| 해피머니 | happymoney | 해피머니 문화상품권 결제 |
| 도서문화 | bookandlife | 도서문화상품권 결제 |
| 스마트문상 | smartculture | 스마트문상 결제 |
카드
카드사
카드사 바로 호출시payload.extra.direct_card_company = "국민"과 같이 지정할 수 있습니다. 해당 옵션 사용시 결제금액이 5만원이 넘을 경우 할부 옵션(payload.extra.direct_card_quota) 지정은 필수입니다.
| 카드사 |
|---|
| BC |
| 국민 |
| 하나 |
| 삼성 |
| 신한 |
| 현대 |
| 롯데 |
| 신세계한미 |
| 시티 |
| 농협 |
| 수협 |
| 신협 |
| 우리 |
| 광주 |
| 제주 |
| 전북 |
| 기업 |
| VISA |
| 마스터 |
| 다이너스 |
| AMX |
| JCB |
| DISCOVER |
| 우체국 |
| 새마을금고 |
| 은련 |
| 카카오뱅크 |
| 케이뱅크 |
| 페이코 |
| 저축은행 |
카드 종류
카드 소유자 유형
가상계좌
은행
가상계좌 발급시 은행코드는 아래와 같습니다.
| 카드사 |
|---|
| 산업 |
| 기업 |
| 국민 |
| 하나 |
| 신한 |
| 외환 |
| 케이뱅크 |
| 카카오뱅크 |
| 토스뱅크 |
| 수협 |
| 농협 |
| 우리 |
| SC제일 |
| 시티 |
| 대구 |
| 부산 |
| 광주 |
| 제주 |
| 전북 |
| 강원 |
| 경남 |
| 새마을금고 |
| 우체국 |
결제 통화
결제 통화 단위
결제 요청 및 응답시 받는currency코드는 다음과 같습니다.
| 코드 | 단위 |
|---|
| KRW | 원 |
| USD | 달러 |
| EUR | 유로 |
| JPY | 엔 |
| CNY | 위안 |
현금영수증
현금영수증 발급 유형은 아래와 같습니다.
에스크로
결제 상태
에스크로 결제 건의 상태값은 아래와 같습니다.
| 상태값 | 설명 |
|---|
| 0 | 배송전 |
| 1 | 구매확정 |
| 2 | 배송준비중 |
| 3 | 배송시작 |
| -1 | 정산보류 |
| -2 | 구매취소 |
택배사 코드
배송정보 등록시 사용되는 택배사 코드는 아래와 같습니다.
| 택배사 |
|---|
| CJ대한통운 |
| 한진 |
| 롯데 |
| KGB |
| 동부 |
| 우체국 |
| 로젠 |
| 옐로우캡 |
| 경동 |
| 대신 |
| 사가와 |
| 일양로지스 |
| 호남 |
| 합동 |
| 천일 |
| 편의점 |
| 직접배달 |
| 퀵서비스 |
클라이언트 에러코드
클라이언트 SDK에서 결제 요청 시 오류가 발생하면error이벤트가 호출됩니다. 이 이벤트는error_code와message로 오류 내용을 반환하며,pg_error_code값도 함께 전달됩니다.pg_error_code는 PG사에서 반환하는 에러 코드로, PG사에 문의할 때 이 코드를 제공하면 도움이 될 수 있습니다.
| 에러코드 (error_code) | 설명 |
|---|
| RC_REQUEST_FAILED | 결제 요청시 발생되는 에러입니다.- 휴대폰 소액결제의 경우 실물/비실물 정보를 잘못보낸 경우
- 카드결제의 경우 잘못된 할부개월수 설정 및 사용자 정보 누락
|
| RC_CONFIRM_READY_FAILED | 결제가 승인되기 이전 PG사에서 진행시 발생된 에러입니다. |
| RC_CONFIRM_FAILED | PG사에서 결제 승인중 발생된 에러입니다- 휴대폰 소액결제의 경우 소액결제 차단중이거나 잔여 소액결제 금액이 결제금액보다 작은 경우
- 카드 결제인 경우 만료된 카드/도난신고 카드/카드 잔액부족/카드 한도초과/카드사 점검으로 인한 에러
|
| RC_RESOURCE_NOT_CONFIG | 설정되지 않은 PG의 결제수단을 사용하려 할 때 발생하는 에러입니다 |
서버 에러코드
서버 SDK에서 API 요청 시 오류가 발생하면error_code와message로 오류 내용을 반환합니다. 자세한 에러코드는 아래와 같습니다.
토큰 발급
| 에러코드 (error_code) | 설명 |
|---|
| APP_FIREWALL_BLOCKED | 접근이 허가된 IP가 아닙니다. 부트페이 관리자에서 IP 보안 설정을 확인해주시기 바랍니다. |
| TOKEN_KEY_INVALID | Access Token이 잘못됨 |
| APP_KEY_NOT_FOUND | REST API Application ID가 잘못된 값을 전달함 |
| APP_KEY_NOT_REST | REST API Application ID가 아닌 다른 플랫폼의 Application ID가 전달됨 |
| APP_SK_NOT_MATCHED | Private Key가 잘못됨 |
결제조회
| 에러코드 (error_code) | 설명 |
|---|
| RC_NOT_FOUND | receipt_id를 찾을 수 없거나 혹은 조회 권한이 없음- receipt_id가 없어 조회가 안되는 경우
- 발급 받은 access token으로 다른 프로젝트에서 결제된 receipt_id를 조회 혹은 결제 취소를 요청하는 경우
|
결제취소
| 에러코드 (error_code) | 설명 |
|---|
| RC_NOT_FOUND | receipt_id를 찾을 수 없거나 혹은 조회 권한이 없음- receipt_id가 없어 조회가 안되는 경우
- 발급 받은 access token으로 다른 프로젝트에서 결제된 receipt_id를 조회 혹은 결제 취소를 요청하는 경우
|
| RC_CANCEL_SERVER_ERROR | 파라메터 오류 혹은 PG사에서 결제 취소를 실패한 경우- 휴대폰 소액결제의 경우 결제 당월 취소가 아니면 취소불가
- 부분취소가 가능하더라도 일부 카드는 부분취소가 안됨 ( * 선불카드, 기프트 카드인 경우 )
- PG에서 정산받을 금액보다 취소 금액이 더 큰 경우 ( * PG사로 문의해서 입금 후 취소처리 )
- PG에서 가맹점에서 취소요청 대사 처리가 미승인인 경우 ( * PG사로 문의해서 해결 )
- 가상계좌 환불인 경우 PG사와 계약시 CMS 이체특약이 안되어있거나, 환불계좌/환불계좌주/환불은행 은행정보가 올바르지 않은 경우
- KCP인 경우 KCP 관리자에서 결제서버 IP로 부트페이 IP인, 223.130.82.4, 223.130.82.130, 223.130.82.131이 등록이 안된 경우
|
| RC_CANCEL_CRITICAL_ERROR | 부트페이서버에서 PG사로 취소요청 중 에러 발생된 케이스- PG사 승인 서버 미응답 (timeout) 으로 인한 치명적인 에러
- DNS Resolve Timeout으로 인한 에러
- IDC 내 두 Router 간 네트워크 지연으로 인한 에러
|
자동결제
| 에러코드 (error_code) | 설명 |
|---|
| SUBSCRIBE_REQUEST_FAILED | 빌링키 발급 요청 실패- 자동결제 빌링키 발급이 허가 되지 않은 가맹점인 경우 ( * PG사로 연락해서 빌링 자동결제가 가능한지 확인 )
- 카드번호/카드소유주 생년월일/카드비밀번호 정보가 맞지 않는 경우
|
| SUBSCRIBE_PUBLISH_FAILED | 빌링키 발급 요청 실패- 카드번호/카드소유주 생년월일/카드비밀번호 정보가 맞지 않는 경우
- 자동결제를 할 수 없는 카드인 경우 ( * 기프트카드 )
|
| RC_CONFIRM_FAILED | 빌링키 발급 시 첫 결제 혹은 빌링 결제시 실패- 도난카드/유효기간만료카드/카드잔액부족/카드한도초과등의 사유로 결제가 안되는 경우
|
| SUBSCRIBE_BK_NOT_FOUND | 부트페이 빌링키가 잘못된 경우- 다른 프로젝트에서 발급받은 빌링키를 가지고 결제를 시도하는 경우
|
서버 승인
| 에러코드 (error_code) | 설명 |
|---|
| RC_CONFIRM_FAILED | PG사에서 결제 승인중 발생된 에러- 휴대폰 소액결제의 경우 소액결제 차단중이거나 잔여 소액결제 금액이 결제금액보다 작은 경우
- 카드 결제인 경우 만료된 카드/도난신고 카드/카드 잔액부족/카드 한도초과/카드사 점검으로 인한 에러
|
| RC_CONFIRM_CRITICAL_FAILED | 부트페이서버에서 PG사로 승인요청 중 에러 발생된 케이스- PG사 승인 서버 미응답 (timeout) 으로 인한 치명적인 에러
- DNS Resolve Timeout으로 인한 에러
- IDC 내 두 Router 간 네트워크 지연으로 인한 에러
|
