가이드/연동 깊이 이해하기/간편결제 응답 확인
목차

Version 1

SDK v1은 더 이상 업데이트되지 않습니다. 토스페이먼츠 SDK v2 연동을 추천합니다.

✅ 구매자가 에서 선택한 결제수단에 따라 결제 응답 객체이 어떻게 바뀌는지 알아보세요.

✅ 다양한 조합 및 응답 예시를 확인해보세요.

간편결제 결제수단 타입

결제수단설명응답 객체 금액 필드예시
신용·체크 카드고객이 간편결제 서비스에 등록한 카드card.amount토스페이, 네이버페이 등 간편결제에 등록된 카드
충전식 결제수단고객이 금액을 충전해서 사용하는 결제수단으로 간편결제 서비스에 등록한 계좌 혹은 현금성 포인트easyPay.amount토스페이에 연결된 계좌, 카카오페이 머니, 네이버페이 머니, 페이코 포인트
적립식 결제수단*고객이 간편결제사에서 제공하는 결제 서비스를 이용해서 적립된 포인트, 쿠폰, 즉시할인 금액으로 카드나 충전식 결제수단과 조합해서 사용easyPay.discountAmount토스포인트, 카카오페이 포인트, 페이코 쿠폰

* 적립식 결제수단은 카드 혹은 충전식 결제수단과 조합해서 사용할 수 있습니다. 적립식 결제는 토스페이, 카카오페이, 네이버페이, 페이코에서만 제공합니다.

Case 1. 간편결제에 등록된 카드로 결제했을 때

토스페이에 등록된 카드로 15,000원을 결제하면 전체 결제 금액 totalAmount는 카드로 결제한 금액인 card.amount와 동일합니다.

Case 2. 간편결제에 등록된 카드 + 적립식 결제수단으로 결제했을 때

토스페이에 등록된 카드로 10,000원을 결제하고 토스포인트에서 5,000원을 사용해 총 15,000원을 결제합니다.

전체 결제 금액 totalAmountcard.amounteasyPay.discountAmount의 합계입니다.

Case 3. 충전식 결제수단으로 결제했을 때

토스페이에 연결된 계좌로 결제하면 전체 결제 금액 totalAmount는 계좌로 결제한 금액인 easyPay.amount와 동일합니다. 즉 easyPay 객체만 확인하면 됩니다.

Case 4. 충전식 결제수단 + 적립식 결제수단으로 결제했을 때

토스페이에 연결된 계좌로 15,000원을 결제하고 토스포인트에서 5,000원을 사용해 총 15,000원을 결제합니다.

전체 결제 금액 totalAmounteasyPay.amounteasyPay.discountAmount의 합계입니다.

Case 5. 적립식 결제수단으로 결제했을 때

토스포인트로 15,000원을 결제하면 전체 결제 금액 totalAmounteasyPay.discountAmount와 동일합니다. 즉 easyPay 객체만 확인하면 됩니다.

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기