카드사 혜택 조회하기

카드사 혜택 조회 API를 사용하면 카드사별로 제공되는 즉시할인 정보와 무이자 할부 혜택을 한 번에 조회합니다.

카드사 혜택 조회 API 호출하기

모든 카드사의 즉시할인 정보와 무이자 할부 혜택을 조회하는 카드사 혜택 조회 API를 호출합니다.

요청
curl --request GET \
  --url https://api.tosspayments.com/v1/promotions/card \
  --header 'Authorization: Basic dGVzdF9za196WExrS0V5cE5BcldtbzUwblgzbG1lYXhZRzVSOg=='

응답으로 discountCardsinterestFreeCards가 포함된 객체가 돌아옵니다. 카드사별 즉시할인 이벤트 정보와 무이자 혜택 정보가 각 필드에 배열로 들어옵니다.

응답
{
"discountCards": [
{
"cardCompany": "롯데",
"companyCode": "71",
"discountCode": "12860",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 1000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 500
},
{
"cardCompany": "BC",
"companyCode": "31",
"discountCode": "12861",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 2000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 600
},
{
"cardCompany": "현대",
"companyCode": "61",
"discountCode": "12863",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 10000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 5000
}
],
"interestFreeCards": [
{
"cardCompany": "국민",
"companyCode": "11",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5],
"minimumPaymentAmount": 50000
},
{
"cardCompany": "BC",
"companyCode": "31",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5, 6],
"minimumPaymentAmount": 50000
},
{
"cardCompany": "우리",
"companyCode": "33",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5, 6],
"minimumPaymentAmount": 50000
}
]
}
JSON

혜택을 받을 수 있는 기간(dueDate), 금액 조건(minimumPaymentAmount, maximumPaymentAmount) 등에 따라 할인 금액과 코드, 무이자 할부 혜택을 노출해서 고객이 결제할 때 사용할 수 있도록 사용해보세요.

Case. 다른 API와 함께 사용하기

카드사 정보를 미리 받는 카드앱 바로 열기와 함께 사용해보세요. 선택된 카드사의 혜택 정보를 조회해서 결제할 금액을 할인된 가격으로 바로 보여줄 수 있습니다.

혹은 등록된 카드 중 가장 많은 혜택을 받을 수 있는 카드를 자동으로 선택해서 고객이 더욱 간편하게 혜택을 받을 수 있도록 구현하는데 활용해보세요.


카드사 혜택 조회 API를 자세히 알아보세요

카드사 혜택 조회 API를 직접 실행해보세요

내용이 도움 되셨나요?
  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    디스코드 채팅|이메일 보내기