1. 배경설명

기존 브랜드페이(구. 커넥트페이)는 프로모션 API 와 결제수단조회 API가 분리되어 있습니다. 그동안 가맹점에서는 프로모션 API 호출 후 결제수단 조회 API를 호출하여 결제수단 별로 적용 가능한 즉시할인과 무이자 할부 정보를 매칭하는 로직을 개발하였습니다. 그러나 최근 카드사 추가 및 프로모션 적용 범위가 변경되면서 가맹점에서 로직 변경에 혼동을 겪는다는 피드백을 받아 결제수단 조회 API에 프로모션 정보(즉시 할인, 무이자 할부 정보)가 같이 응답되도록 변경/배포하기로 하였습니다.

2. 배포 예정 일시

2024년 01월 25일 16시 정각

3. 변경 내용

결제수단 조회 API에 결제수단 목록과 함께 각 결제수단 별로 제공가능한 프로모션 정보가 같이 응답되도록 promotions 객체가 추가됩니다. 기존 응답에 promotions 객체가 추가되는 방식이기 때문에 새로운 객체가 추가되어도 가맹점 코드에 문제가 없는지 영항도를 검토 해주시면 됩니다. 배포 이후부터 결제수단 조회 API 만 호출하여 프로모션을 적용할 수 있도록 가맹점에서 프로그램 변경하실 수 있습니다.

4. 상세응답 예시

4.1 결제수단 조회 API

• 적용대상 API
  • AccessToken으로 결제수단 조회: [GET] v1/brandpay/payments/methods
  • SecretKey로 결제수단 조회: [GET] /v1/brandpay/payments/methods/{customerKey}
  • AccessToken으로 결제수단 조회: [GET] /v1/connectpay/payments/methods
  • SecretKey로 결제수단 조회: [GET] v1/connectpay/payments/methods/{customerKey}
• 브랜드페이 결제수단 조회 시 각 결제수단에서 적용 가능한 프로모션 객체 (promotions)가 추가되었습니다.
• 요청(Request) 스펙은 기존과 동일합니다.
• 하나의 결제수단에 적용가능한 동일 프로모션이 여러 종류가 있다면 혜택이 큰 순으로 정렬 되어 내려갑니다.
• 응답 예시

{
  "cards": [
    {
      "id": "m_Zzorzo1AJbaD78l5",
      "alias": "카드 별칭",
      "methodKey": "pa90ZoyegEOALnQvDd2VJ5vKkpRyN3Mj7X41mNW5kzKbwG6J",
      "cardName": "현대비자플래티늄",
      "cardNumber": "43301234****123*",
      "issuerCode": "61",
      "acquirerCode": "61",
      "ownerType": "개인",
      "cardType": "신용",
      "installmentMinimumAmount": 10000,
      "registeredAt": "2022-06-07T18:37:04+09:00",
      "status": "ENABLED",
      "icon": "icn-bank-square-hyundaicard",
      "iconUrl": "<https://static.toss.im/icons/png/4x/icn-bank-square-hyundaicard.png>",
      "cardImgUrl": "",
      "color": {
        "background": "#3C3C42",
        "text": "#FFFFFF"
      },
			"**promotions**" :[
				{
					"type": "CARD_DISCOUNT",
				  "cardDiscount": {
			      "issuerCode": "61",
						"currency": "KRW",
			      "discountAmount": 600,
			      "balance": 1000000,
			      "discountCode": "12861",
			      "dueDate": "2022-04-30",
			      "minimumPaymentAmount": 2000,
			      "maximumPaymentAmount": 99999999
					},
					"cardInterestFree": {},     //nullable
					"cardPoint": {},           //nullable
					"bankDiscount": {}         //nullable
			  },
				{
					"type": "CARD_INTEREST_FREE",
				  "cardDiscount": {},        //nullable
					"cardInterestFree": {
			      "issuerCode": "61",
			      "dueDate": "2022-06-30",
			      "installmentFreeMonths": [2, 3, 4, 5, 6, 7],
						"currency": "KRW",
			      "minimumPaymentAmount": 50000
					},
					"cardPoint": {},           //nullable
					"bankDiscount": {}         //nullable
			  }
			]
    }
  ],
  "accounts": [
    {
      "id": "b_aPz8LBLadxD6WVy4",
      "methodKey": "b6vdX0wJDpj5mBZ1gQ4YVXe9DYzQparl2KPoqNbMGOkn9EW7y",
      "accountName": "신한은행 계좌",
      "accountNumber": "123***7890",
      "alias": "내 계좌",
      "bankCode": "88",
      "icon": "",
      "iconUrl": "",
      "registeredAt": "2022-06-07T10:00:43.838Z",
      "status": "DISABLED",
      "color": {
        "background": "#F2F4F6",
        "text": "#333D4B"
      },
			"**promotions**" :[
				{
					"type": "BANK_DISCOUNT",
				  "cardDiscount": {},        //nullable
					"cardInterestFree": {},     //nullable
					"cardPoint": {},           //nullable
					"bankDiscount": {
			      "bankCode": "88",
						"currency": "KRW",
			      "discountAmount": 600,
			      "balance": 1000000,
			      "discountCode": "12861",
			      "dueDate": "2022-04-30",
			      "minimumPaymentAmount": 2000,
			      "maximumPaymentAmount": 99999999
					}
			  }
			]
    }
  ],
  "isIdentified": true,
  "selectedMethodId": "m_Zzorzo1AJbaD78l5"
}

4.2 SDK 결제수단 조회