ENUM 코드
토스페이먼츠 API/SDK에서 사용하는 ENUM 코드입니다. 한글과 영문이 함께 있는 코드는 둘 중 하나를 사용하면 됩니다.
결제
결제 API와 결제창 JavaScript SDK(이하 SDK)에서 사용하는 ENUM 코드 모음입니다.
결제수단 타입
결제수단으로 사용하는 ENUM 코드입니다.
결제수단 파라미터 타입
결제창을 열 때 사용되는 SDK 메서드 requestPayment()의 첫 번째 결제수단 파라미터에 아래 타입을 사용합니다.
| 코드 |
|---|
카드/CARD |
가상계좌/VIRTUAL_ACCOUNT |
휴대폰/MOBILE_PHONE |
계좌이체/TRANSFER |
문화상품권/CULTURE_GIFT_CERTIFICATE |
도서문화상품권/BOOK_GIFT_CERTIFICATE |
게임문화상품권/GAME_GIFT_CERTIFICATE |
* 간편결제에는 카드/CARD 코드를 사용하세요.
결제수단 응답 타입
Payment 객체, Transaction 객체, Settlement 객체의 method에 아래 코드 중 하나가 돌아옵니다.
| 코드 |
|---|
카드 |
간편결제 |
가상계좌 |
휴대폰 |
계좌이체 |
상품권 |
* Billing 객체의 method는 카드 코드가 고정으로 돌아옵니다.
간편결제 타입
간편결제 타입으로 사용하는 ENUM 코드입니다.
간편결제 결제창 열 때 사용되는 SDK 메서드 requestPayment()의 easyPay 파라미터에 아래 타입을 사용합니다.
| 코드 |
|---|
토스페이/TOSSPAY |
네이버페이/NAVERPAY |
삼성페이/SAMSUNGPAY |
엘페이/LPAY |
카카오페이/KAKAOPAY |
페이코/PAYCO |
SSG페이/SSG |
카드 타입
카드 결제에 사용한 카드 종류를 나타내는 ENUM 코드입니다.
Payment 객체, Billing 객체의 card.cardType에 아래 코드 중 하나가 돌아옵니다.
| 코드 |
|---|
신용 |
체크 |
기프트 |
카드 소유자 타입
카드 결제에 사용한 카드의 소유자 타입을 나타내는 ENUM 코드입니다.
Payment 객체, Billing 객체의 card.ownerType에 아래 코드 중 하나가 돌아옵니다.
| 코드 | 설명 |
|---|---|
개인 | 개인이 발급 받을 수 있는 본인카드, 가족카드입니다. |
법인 | 기업, 기관, 협회 등 사업자에서 발급 받을 수 있는 카드입니다. |
미확인 | 비여신 거래 또는 해외 카드 거래로 카드 소유자 정보가 확인이 어려울 때 돌아옵니다. |
가상계좌 타입
가상계좌 타입으로 사용하는 ENUM 코드입니다.
Payment 객체의 virtualAccount.accountType에 아래 코드 중 하나가 돌아옵니다.
| 코드 | 설명 |
|---|---|
일반 | 임시적으로 발급되어 고객이 입금한 뒤에는 더 이상 사용할 수 없는 일반적인 가상계좌입니다. |
고정 | 고객이 같은 계좌로 여러 번 입금할 수 있는 특수 가상계좌입니다. |
결제 방식 타입
결제 방식을 나타내는 ENUM 코드입니다. 토스페이먼츠에서 제공하는 세 가지 결제 방식 중 어떤 것을 사용했는지 명시합니다.
Payment 객체의 type에 아래 코드 중 하나가 돌아옵니다.
| 코드 | 설명 |
|---|---|
NORMAL | 일반결제입니다. 카드, 가상계좌, 계좌이체, 휴대폰, 상품권 결제 방식입니다. |
BILLING | 자동결제입니다. 고객의 카드를 결제수단으로 등록한 이후 별도의 인증 없이 간편하게 결제할 수 있는 방식입니다. |
BRANDPAY | 브랜드페이 결제입니다. 브랜드페이는 상점에서 자체 간편결제를 구현할 수 있는 SDK와 API를 제공하는 서비스입니다. |
현금영수증
현금영수증 API와 SDK에서 사용하는 ENUM 코드 모음입니다.
현금영수증 발급 타입
발급할 현금영수증의 용도로 사용하는 ENUM 코드입니다.
SDK로 계좌이체 또는 가상계좌 연동할 때 requestPayment() 메서드의 cashReceipt.type 선택 파라미터에 아래 타입을 사용합니다.
API로 현금영수증 발급 또는 가상계좌 발급 요청할 때도 파라미터에 아래 타입을 사용합니다.
| 코드 | 설명 | |
|---|---|---|
소득공제/DEDUCTION | 소비자 소득공제 현금영수증입니다. | |
지출증빙/PROOF | 사업자 지출증빙 현금영수증입니다. | |
미발행/NONE | 계좌이체 또는 가상계좌를 연동할 때 현금영수증을 발급하지 않습니다. 결제창에서 현금영수증 발급 용도를 선택할 수 없습니다. |
정산
정산 API에서 사용하는 ENUM 코드 모음입니다.
수수료 세부 타입
결제 수수료의 세부 타입을 나타내는 ENUM 코드입니다. 정산 정보를 담고있는 Settlement 객체의 fees.type에 아래 코드 중 하나가 돌아옵니다.
| 코드 | 설명 |
|---|---|
BASE | 기본 수수료입니다. |
INSTALLMENT_DISCOUNT | 카드사 혹은 토스페이먼츠가 부담하는 무이자 할부 수수료입니다. |
INSTALLMENT | 상점이 부담하는 무이자 할부 수수료입니다. |
POINT_SAVING | 카드사 포인트 적립 수수료입니다. |
ETC | 기타 수수료입니다. |