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