API & SDK/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에 아래 코드 중 하나가 돌아옵니다.

코드
신용
체크
기프트

카드 소유자 타입

카드 결제에 사용한 카드의 소유자 타입을 나타내는 ENUM 코드입니다.

Payment 객체, Billing 객체card.ownerType에 아래 코드 중 하나가 돌아옵니다.

코드설명
개인개인이 발급 받을 수 있는 본인카드, 가족카드입니다.
법인기업, 기관, 협회 등 사업자에서 발급 받을 수 있는 카드입니다.
미확인비여신 거래 또는 해외 카드 거래로 카드 소유자 정보가 확인이 어려울 때 돌아옵니다.

가상계좌 타입

가상계좌 타입으로 사용하는 ENUM 코드입니다.

Payment 객체virtualAccount.accountType에 아래 코드 중 하나가 돌아옵니다.

코드설명
일반임시적으로 발급되어 고객이 입금한 뒤에는 더 이상 사용할 수 없는 일반적인 가상계좌입니다.
고정고객이 같은 계좌로 여러 번 입금할 수 있는 특수 가상계좌입니다.

결제 방식 타입

결제 방식을 나타내는 ENUM 코드입니다. 토스페이먼츠에서 제공하는 세 가지 결제 방식 중 어떤 것을 사용했는지 명시합니다.

Payment 객체type에 아래 코드 중 하나가 돌아옵니다.

코드설명
NORMAL일반결제입니다. 카드, 가상계좌, 계좌이체, 휴대폰, 상품권 결제 방식입니다.
BILLING자동결제입니다. 고객의 카드를 결제수단으로 등록한 이후 별도의 인증 없이 간편하게 결제할 수 있는 방식입니다.
BRANDPAY브랜드페이 결제입니다. 브랜드페이는 상점에서 자체 간편결제를 구현할 수 있는 SDK와 API를 제공하는 서비스입니다.

현금영수증

현금영수증 APISDK에서 사용하는 ENUM 코드 모음입니다.

현금영수증 발급 타입

현금영수증의 종류 사용하는 ENUM 코드입니다. 계좌이체 또는 가상계좌를 연동할 때, 현금영수증을 발급할 때 사용합니다.

코드설명
소득공제/DEDUCTION소비자 소득공제 현금영수증입니다.
지출증빙/PROOF사업자 지출증빙 현금영수증입니다.
미발행/NONE계좌이체 또는 가상계좌를 연동할 때 현금영수증을 발급하지 않습니다. 결제창에서 현금영수증 발급 용도를 선택할 수 없습니다.

정산

정산 API에서 사용하는 ENUM 코드 모음입니다.

수수료 세부 타입

결제 수수료의 세부 타입을 나타내는 ENUM 코드입니다. 정산 정보를 담고있는 Settlement 객체fees.type에 아래 코드 중 하나가 돌아옵니다.

코드설명
BASE기본 수수료입니다.
INSTALLMENT_DISCOUNT카드사 혹은 토스페이먼츠가 부담하는 무이자 할부 수수료입니다.
INSTALLMENT상점이 부담하는 무이자 할부 수수료입니다.
POINT_SAVING카드사 포인트 적립 수수료입니다.
ETC기타 수수료입니다.
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기