결제 운영/간편결제 응답 확인
목차

고객이 간편결제에서 결제수단을 조합해서 사용하면 결제 응답 객체가 조금씩 달라집니다. 아래 토스페이 사용 예시를 확인해보세요.

간편결제 결제수단 타입

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

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

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

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

JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"status": "DONE",
"lastTransactionKey": "",
"orderId": "",
"orderName": "토스 티셔츠 외 2건",
//...
"card": {
"issuerCode": "61",
"acquirerCode": "31",
"number": "123456******7890",
"installmentPlanMonths": 0,
"isInterestFree": false,
"interestPayer": null,
"approveNo": "21974757",
"useCardPoint": false,
"cardType": "신용",
"ownerType": "개인",
"acquireStatus": "READY",
"amount": 15000
},
"easyPay": {
"provider": "토스페이",
"amount": 0,
"discountAmount": 0
},
//...
"totalAmount": 15000
}

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

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

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

JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"status": "DONE",
"lastTransactionKey": "",
"orderId": "",
"orderName": "토스 티셔츠 외 2건",
//...
"card": {
"issuerCode": "61",
"acquirerCode": "31",
"number": "123456******7890",
"installmentPlanMonths": 0,
"isInterestFree": false,
"interestPayer": null,
"approveNo": "21706400",
"useCardPoint": false,
"cardType": "체크",
"ownerType": "개인",
"acquireStatus": "READY",
"amount": 10000
},
"easyPay": {
"provider": "토스페이",
"amount": 0,
"discountAmount": 5000
},
//...
"totalAmount": 15000
}

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

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

JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"status": "DONE",
"lastTransactionKey": "",
"orderId": "",
"orderName": "토스 티셔츠 외 2건",
//...
"card": null,
"easyPay": {
"provider": "토스페이",
"amount": 15000,
"discountAmount": 0
},
//...
"totalAmount": 15000
}

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

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

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

JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"status": "DONE",
"lastTransactionKey": "",
"orderId": "",
"orderName": "토스 티셔츠 외 2건",
//...
"card": null,
"easyPay": {
"provider": "토스페이",
"amount": 10000,
"discountAmount": 5000
},
//...
"totalAmount": 15000
}

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

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

JSON
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"status": "DONE",
"lastTransactionKey": "",
"orderId": "",
"orderName": "토스 티셔츠 외 2건",
//...
"card": null,
"easyPay": {
"provider": "토스페이",
"amount": 0,
"discountAmount": 15000
},
//...
"totalAmount": 15000
}
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    실시간 문의|이메일 보내기