자동결제(bill) 승인 요청

결제 가맹점의 API Key. 빌링키 생성요청 시 사용된 API Key와 동일해야 합니다. 결제 보안상 유의가 필요하며 웹 브라우저에 노출되지 않도록 가맹점의 관리가 필요합니다.

빌링키. 빌링키 생성 콜백으로 전달받은 빌링키 값으로, 해당 사용자의 결제수단 식별 용도로 사용됩니다.

가맹점의 상품 주문번호. 최대 50자로 지정하며 숫자, 영문자도 가능하되 특수문자는 _ - : . ^ @ = 만 허용합니다. 주문번호는 가맹점에서 관리하는 유니크한 값이어야 합니다.

상품 설명

할부 개월 수. 카드 결제 시 0~12까지 지정 가능하며, 0은 일시불입니다. 5만원 미만 결제 건은 일시불만 가능합니다.

결제 요청 금액. 카드 가맹점은 최대 10억원, 그 외 가맹점은 최대 200만원까지 가능합니다.

결제 요청 금액 중 비과세 금액

결제 요청 금액 중 과세 금액

결제 요청 금액 중 부가세

결제 요청 금액 중 봉사료

토스 현금영수증 자동발행 기능을 사용한다면 매회 결제 시 true 값을, 미 사용하는 경우 false 값을 전달합니다. 기본값은 true입니다.

빌링키 결제가 실패할 경우, 사용자에게 결제 실패 알람을 발송합니다. 기본값 true

현금영수증 발행 유형. CULTURE: 문화비, GENERAL: 일반(기본값), PUBLIC_TP: 대중교통

선승인 여부. true: 선승인 (포인트 사용 X), false 또는 null: 선승인 아님

메타데이터. 가맹점에서 관리하는 추가 정보

응답코드. 0: 성공, -1: 실패 (실패 사유는 msg와 errorCode로 제공)

에러 코드

응답이 성공이 아닌 경우 설명 메시지

결제환경. LIVE: 실거래용, TEST: 테스트용

결제 토큰

주문번호

결제수단. TOSS_MONEY: 토스머니, CARD: 카드

결제 금액

거래 트랜잭션 아이디

승인 처리 시간 (yyyy-MM-dd HH:mm:ss)

할인된 금액. 할인 적용이 없으면 0

지불수단 승인금액. 총 금액 중 할인된 금액을 제외한 순수 지불수단 승인금액

카드사명

카드사 코드

카드사 승인번호

신용카드 매출전표 호출 URL

카드 할부개월. 5만원 미만 금액 및 일시불 결제의 경우 0

카드 무이자 적용 여부. true: 무이자, false: 일반

카드 타입. CREDIT: 신용카드, CHECK: 체크카드, PREPAYMENT: 선불카드

은행명

은행코드

마스킹된 계좌번호

현금영수증 관리번호 식별값

마스킹된 카드번호

카드 사용자 구분. PERSONAL: 본인 카드, PERSONAL_FAMILY: 가족 카드, CORP_PERSONAL: 법인지정 결제계좌 임직원, CORP_PRIVATE: 법인 공용

카드 BIN 번호

카드번호 끝 4자리