카드사 혜택 조회하기
카드사 혜택 조회 API를 사용하면 카드사별로 제공되는 즉시할인 정보와 무이자 할부 혜택을 한 번에 조회합니다.
카드사 혜택 조회하는 방법
모든 카드사의 즉시할인 정보와 무이자 할부 혜택을 조회하는 카드사 혜택 조회 API를 호출합니다.
요청
curl --request GET \
--url https://api.tosspayments.com/v1/promotions/card \
--header 'Authorization: Basic dGVzdF9za196WExrS0V5cE5BcldtbzUwblgzbG1lYXhZRzVSOg=='응답으로 discountCards와 interestFreeCards가 포함된 객체가 돌아옵니다. 카드사별 즉시할인 이벤트 정보와 무이자 혜택 정보가 각 필드에 배열로 들어옵니다.
응답
{
"discountCards": [
{
"companyCode": "71",
"discountCode": "12860",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 1000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 500
},
{
"companyCode": "31",
"discountCode": "12861",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 2000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 600
},
{
"companyCode": "61",
"discountCode": "12863",
"dueDate": "2022-01-31",
"minimumPaymentAmount": 10000,
"maximumPaymentAmount": 99999999,
"balance": 1000000,
"discountAmount": 5000
}
],
"interestFreeCards": [
{
"companyCode": "11",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5],
"minimumPaymentAmount": 50000
},
{
"companyCode": "31",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5, 6],
"minimumPaymentAmount": 50000
},
{
"companyCode": "33",
"dueDate": "2022-01-31",
"installmentFreeMonths": [2, 3, 4, 5, 6],
"minimumPaymentAmount": 50000
}
]
}
JSON
혜택을 받을 수 있는 기간(dueDate), 금액 조건(minimumPaymentAmount, maximumPaymentAmount) 등에 따라 할인 금액과 코드, 무이자 할부 혜택을 노출해서 고객이 결제할 때 사용할 수 있도록 사용해보세요.
Case. 다른 API와 함께 사용하기
카드사 정보를 미리 받는 앱카드 결제창 연동하기와 함께 사용해보세요. 선택된 카드사의 혜택 정보를 조회해서 결제할 금액을 할인된 가격으로 바로 보여줄 수 있습니다.
혹은 등록된 카드 중 가장 많은 혜택을 받을 수 있는 카드를 자동으로 선택해서 고객이 더욱 간편하게 혜택을 받을 수 있도록 구현하는데 활용해보세요.