특정 카드사 다이렉트 호출 방법

포트원 javascript sdk 를 이용하여 결제창 호출 시, 특정 카드에 대한 결제창을 direct 로 호출할 수 있는 방법에 대한 가이드입니다.

카드사 결제창을 direct 로 호출하기 위해서는 두가지 파라미터에 대한 설정이 필요합니다.

card.direct.code : 카드사 금융결제원 표준 코드. 하단 표 참조. (string)
card.direct.quota : 할부 개월 수. 일시불일 시 0으로 지정. (integer)

즉, 결제창 호출을 위한 IMP.request_pay() 함수 호출 시, 다음과 같이 파라미터 추가가 되어야 합니다.

ex) 현대카드 3개월 할부 direct 호출 code

IMP.request_pay({ // param
    pay_method: "card",
    merchant_uid: "ORD20180131-0000011",
    name: "노르웨이 회전 의자",
    amount: 64900,
    company : "행복쇼핑몰",
    buyer_email: "[email protected]",
    buyer_name: "홍길동",
    buyer_tel: "010-4242-4242",
    buyer_addr: "서울특별시 강남구 신사동",
    buyer_postcode: "01181",
    card: {
      direct: {
        code: "367",
        quota: 3
      }
    }
  }
)

⚠️주의사항

현재 KG이니시스, KCP, 토스페이먼츠, 나이스페이먼츠, KICC, 다날, 키움페이(다우데이타), (신)스마트로 7개 PG사에 대해서만 카드사 결제창 direct 호출이 가능합니다. 이외의 PG사에 대해선 위 값을 설정하더라도 일반 결제창이 노출됩니다.
- 키움페이의 경우 다른 PG사와 달리 키움페이 결제창이 우선적으로 호출된 이후 2~3초 이내에 카드사페이지로 전환됩니다.
일부 PG사의 경우, 모든 상점아이디에 대하여 카드사 결제창 direct 노출 기능을 지원하지 않습니다. 반드시 포트원을통해 현재 사용중인 상점아이디가 카드사 결제창 direct 호출이 가능하도록 설정이 되어있는지 PG사에 확인이 필요합니다.
KCP의 경우, 결제창 표시를 위한 가맹점명을 직접 company 파라미터에 설정해 주셔야 합니다.
```
 (기본(default) : iamport)
```

카드사 금융결제원 표준 코드

카드사 금융결제원 표준 코드 관련 참고사항 📌