토스페이먼츠 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 | 기타 수수료입니다. |