PG와 결제수단 코드값을 표로 빠르게 찾아봐요.
이 문서는 결제 API 요청·응답에서 자주 쓰는 PG사, 결제수단, 카드사, 은행 코드값을 정리해요.
PG 계약과 관리자 설정에 따라 실제 사용 가능한 값은 달라질 수 있으니, 화면 표시나 서버 분기 조건으로 쓰기 전에 실제 응답값과 관리자 설정을 함께 확인해요.
PG사 코드
| 코드 |
PG사 |
inicis |
이니시스 |
kcp |
케이씨피 |
nicepay |
나이스페이 |
danal |
다날 |
toss |
토스 |
payletter |
페이레터 |
easypay |
이지페이 |
kakao |
카카오 |
payco |
페이코 |
settlebank |
세틀뱅크 (헥토페이먼츠) |
tpay |
티페이 |
welcome |
웰컴페이먼츠 |
smartro |
스마트로 |
payapp |
페이앱 |
kiwoom |
키움 |
npay |
네이버페이 |
paypal |
페이팔 |
lightpay |
라이트페이 |
mobilians |
모빌리언스 |
paymentwall |
페이먼트월 |
stripe |
스트라이프 |
udpay |
유디페이 |
HTTP 상태 코드
| 코드 |
설명 |
| 200 |
성공 |
| 201 |
이미 처리된 요청 (RC_CONFIRM_ALREADY_COMPLETE — 성공으로 간주해요) |
| 202 |
처리 지연 중 (RC_CONFIRM_PENDING — 웹훅·조회로 결과 확인) |
| 400 |
잘못된 요청 (파라미터 오류) |
| 401 |
인증 실패 (연동키 오류) |
| 403 |
권한 없음 |
| 404 |
리소스를 찾을 수 없음 |
| 429 |
충돌 (Conflict) — 이미 존재하는 값과 중복. 요청 횟수 제한이 아니에요 |
| 442 |
처리할 수 없는 요청 |
| 500 |
서버 내부 오류 |
201, 202 는 상태 코드만 보면 성공이지만 본문은 error_code 를 담은 에러 형식이에요. 자세한 처리 방법은 오류 코드에서 확인해요.
결제수단 코드
결제 조회 응답의 method_symbol 은 아래 심볼로, method 는 한글명으로 내려와요. 그룹 번호는 부트페이 내부에서 결제수단을 구분하는 값이에요.
| 그룹 |
코드 |
결제수단 |
설명 |
| 1 |
phone |
휴대폰 |
휴대폰 소액결제 |
| 2 |
card |
카드 |
신용·체크카드 결제 |
| 3 |
bank |
계좌이체 |
실시간 계좌이체 |
| 4 |
vbank |
가상계좌 |
가상계좌 이체 |
| 5 |
easy |
간편결제 |
카카오/페이코가 PG인 경우 간편결제 |
| 10 |
auth |
인증 |
본인인증 |
| 12 |
card_rebill |
카드자동 |
카드 자동결제 |
| 13 |
card_keyin |
카드수기 |
카드 수기(키인) 결제 |
| 14 |
card_rebill_rest |
카드자동(REST) |
REST API 로 발급하는 카드 자동결제 |
| 15 |
easy_rebill |
간편자동 |
카카오/페이코가 PG인 경우 간편자동결제 (정기결제) |
| 16 |
automatic_transfer_rest |
계좌자동이체 |
계좌 자동이체 (REST) |
| 17 |
phone_rebill |
휴대폰자동 |
휴대폰 자동결제 |
| 18 |
phone_rebill_rest |
휴대폰자동(REST) |
REST API 로 발급하는 휴대폰 자동결제 |
| 19 |
sequential_auto_rebill |
우선순위자동결제 |
우선순위 지갑 기반 자동결제 |
| 22 |
kakao_money |
카카오머니 |
카카오머니 결제 |
| 23 |
payco_point |
페이코포인트 |
페이코 포인트 결제 |
| 24 |
toss |
토스 |
PG에서 제공하는 토스 결제 |
| 25 |
kakao |
카카오페이 |
PG에서 제공하는 카카오페이 결제 |
| 26 |
payco |
페이코 |
PG에서 제공하는 페이코 결제 |
| 27 |
npay |
네이버페이 |
PG에서 제공하는 네이버페이 결제 |
| 28 |
naver_point |
네이버포인트 |
네이버 포인트 결제 |
| 29 |
toss_point |
토스머니 |
토스머니 결제 |
| 30 |
easy_card |
카드간편 |
카드 간편결제 |
| 31 |
easy_bank |
계좌간편 |
계좌 간편결제 |
| 47 |
skpay |
SKPAY |
SK페이 결제 |
| 50 |
cultureland |
컬쳐랜드상품권 |
컬쳐랜드 문화상품권 결제 |
| 51 |
happymoney |
해피머니상품권 |
해피머니 문화상품권 결제 |
| 52 |
bookandlife |
도서문화상품권 |
도서문화상품권 결제 |
| 53 |
smartculture |
스마트문상 |
스마트문상 결제 |
| 62 |
digital_card |
카드(디지털) |
비실물 카드 결제 |
| 63 |
digital_bank |
계좌이체(디지털) |
비실물 계좌이체 결제 |
| 64 |
digital_vbank |
가상계좌(디지털) |
비실물 가상계좌 결제 |
| 72 |
digital_card_rebill |
카드자동(디지털) |
비실물 디지털 카드 자동결제 |
| 80 |
cash_receipt |
현금영수증 |
현금영수증 발행 건 |
| 90 |
paymentwall |
페이먼트월 |
페이먼트월 결제 |
| 100 |
samsungpay |
삼성페이 |
삼성페이 직연동 |
| 101 |
applepay |
애플페이 |
애플페이 직연동 |
| 102 |
lgpay |
LG페이 |
LG페이 결제 |
| -1 |
none |
결제 선택중 |
아직 결제수단이 정해지지 않은 상태 |
빌링키 조회 응답의 method_symbol 은 위 그룹 심볼이 아니라 결제수단 설정의 alias 예요. 결제 조회 응답과 같은 값이라고 가정하고 분기하지 않아요.
카드사 코드
| 카드사 |
| BC |
| 국민 |
| 하나 |
| 삼성 |
| 신한 |
| 현대 |
| 롯데 |
| 신세계한미 |
| 시티 |
| 농협 |
| 수협 |
| 신협 |
| 우리 |
| 광주 |
| 제주 |
| 전북 |
| 기업 |
| VISA |
| 마스터 |
| 다이너스 |
| AMX |
| JCB |
| DISCOVER |
| 우체국 |
| 새마을금고 |
| 은련 |
| 카카오뱅크 |
| 케이뱅크 |
| 페이코 |
| 저축은행 |
카드 타입
발급자 타입
| 값 |
타입 |
| 0 |
- (구분 없음) |
| 1 |
개인 |
| 2 |
법인 |
| 3 |
해외 |
응답에는 번호가 아니라 위 문자열이 내려와요. 해외(3)는 한글 표기가 정의돼 있지 않아 빈 문자열로 내려올 수 있어요.
은행 코드 (가상계좌)
부트페이 내부의 은행 코드 매핑은 PG별로 따로 있어요. 같은 은행이라도 3자리 코드가 PG에 따라 다르고(예: 국민은행 006 / 004, 신한은행 026 / 088), 지원하는 은행 목록도 PG마다 달라요. 아래는 은행 이름 목록이고, 실제 코드값은 사용하는 PG 기준으로 확인해요.
| 은행 |
| 산업 |
| 기업 |
| 국민 |
| 하나 |
| 신한 |
| 외환 |
| 케이뱅크 |
| 카카오뱅크 |
| 토스뱅크 |
| 수협 |
| 농협 |
| 우리 |
| SC제일 |
| 시티 |
| 대구 |
| 부산 |
| 광주 |
| 제주 |
| 전북 |
| 강원 |
| 경남 |
| 새마을금고 |
| 우체국 |
통화 코드
현재 결제에 사용할 수 있는 통화는 KRW 와 USD 두 가지예요.
EUR, JPY, CNY 는 정의만 있고 현재 결제 요청에서는 사용할 수 없어요.
현금영수증 유형
에스크로 상태
| 상태값 |
설명 |
0 |
배송 전 |
1 |
구매확정 |
2 |
배송준비중 |
3 |
배송시작 |
-1 |
정산보류 |
-2 |
구매거절요청 |
-3 |
구매거절승인 |
택배사 목록
delivery_corp 에는 코드가 아니라 아래 한글 이름을 넣어요. 목록에 없는 값은 기타로 폴백돼요.
| 택배사 |
| CJ대한통운 |
| 한진 |
| 롯데 |
| KGB |
| 동부 |
| 우체국 |
| 로젠 |
| 옐로우캡 |
| 경동 |
| 대신 |
| 사가와 |
| 일양로지스 |
| 호남 |
| 합동 |
| 천일 |
| 편의점 |
| 직접배달 |
| 퀵서비스 |
| 기타 |
예약 결제 상태
| 값 |
상태 |
설명 |
-1 |
실패 |
예약 결제 실패 |
0 |
대기 |
실행 전 대기 중 |
1 |
결제 완료 |
결제 완료 (부분취소 포함) |
3 |
취소 |
예약 취소됨 |
