프로모션 | Notion

토스페이먼츠에서는 카드 및 계좌 즉시할인을 제공하고 있습니다. 아래는 프로모션 진행시, 연동 측면에서 각 제품별 고려해야할 부분입니다.

1️⃣ 결제창(카드, 퀵계좌이체), 결제위젯 , 브랜드페이 결제창

별도의 추가적인 연동 없이 즉시할인 기능 사용 가능합니다. 프로모션 안내/적용 모두 토스페이먼츠에서 자동으로 진행합니다.

Untitled

단 가맹점에 따라 응답값 및 부분 취소 정책 확인이 필요할 수 있습니다. ‘ℹ️ 공통사항’을 확인해주세요.

2️⃣ 카드사 직호출 (자체창)

토스페이먼츠 결제창을 통하지 않고, 카드사 결제창을 직접 호출할 경우 프로모션을 직접 적용 및 관리해주셔야합니다.

프로모션 적용
- 프로모션 조회 API를 사용해 현재 진행 중인 Promotion 정보확인
- 금액/잔액/issuerCode를 확인하여, 조건에 부합하는 카드가 있을 경우 discountCode를 결제요청시 보냅니다.
  - 카드사 프로모션은 발급사 기준으로 진행됩니다. 프로모션 조회API 응답값 중 cardCompany가 아닌 issuerCode 기반으로 비교해주세요.
- 동일 원천사(카드사, 은행)에 조건(dueDate, MinMaxAmount 등)이 다른 경우 프로모션은 1개 이상 응답될 수 있습니다. 이 경우 고객에 유리한 조건 1개를 적용하거나 고객이 프로모션을 선택할 수 있도록 고려되어야 합니다.

tossPayments.requestPayment('카드', {
    amount: 15000,
    orderId: 'c9znPX7QtRfsLuIUiSD9-',
    orderName: '토스 티셔츠 외 2건',
    customerName: '박토스',
    successUrl: '<http://localhost:8080/success>',
    failUrl: '<http://localhost:8080/fail>',
		discountCode: '10000',
    flowMode: 'DIRECT',
    cardCompany: '삼성',
  })

3️⃣ 브랜드페이 API

브랜드페이 API 방식도 프로모션을 직접 적용 및 관리해주셔야합니다.

프로모션 적용

결제수단조회API (혹은 getPaymentMethods())를 사용해서 가맹점에서 직접 프로모션을 적용해줘야 해요. API 응답값으로 promotion 배열이 내려오는 결제 수단일 경우, 결제요청(requestPayment)시 discountCode 파라미터를 올려줘야해요.

[결제수단조희 데이터 샘플]

promotion.json
```
brandpay.requestPayment({
        amount: amount,
        orderId: orderId,
        orderName: orderName,
        methodId : "b_eQVxaJJbG6JjNqrP",
        discountCode: '1191',
        customerEmail: '[email protected]' // 고객의 이메일 주소 (optional)
})
```
- 단, 응답값이 내려오더라도 프로모션 기준금액 (minimumPaymentAmount)과 결제금액을 비교해줘야해요. 기준금액에 맞지 않은 주문에 discountCode를 포함해 결제요청할 경우, 아래와 같이 에러가 발생하고 결제 실패되요.
- 프로모션 예산이 모두 소진되면, promotion 배열이 비어서 내려가요.
- 1인 1회만 적용되도록 설정한 프로모션이라면, 1회 사용한 사용자에게는 promotion 배열이 비어서 내려가요.

ℹ️ 공통 사항

결제 응답에 discount.amount 로 할인 금액을 전달드려요. 필수로 연동하셔야 하는 값은 아니지만, 이 값을 통해 거래에 적용된 할인 금액을 확인할 수 있어요.