포트원 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: "gildong@gmail.com",
buyer_name: "홍길동",
buyer_tel: "010-4242-4242",
buyer_addr: "서울특별시 강남구 신사동",
buyer_postcode: "01181",
card: {
direct: {
code: "367",
quota: 3
}
}
}
)
JavaScript
복사
주의사항
•
현재 KG이니시스, KCP, 토스페이먼츠, 나이스페이먼츠, KICC, 다날, 키움페이(다우데이타), (신)스마트로 7개 PG사에 대해서만 카드사 결제창 direct 호출이 가능합니다. 이외의 PG사에 대해선 위 값을 설정하더라도 일반 결제창이 노출됩니다.
◦
키움페이의 경우 다른 PG사와 달리 키움페이 결제창이 우선적으로 호출된 이후 2~3초 이내에 카드사페이지로 전환됩니다.
•
일부 PG사의 경우, 모든 상점아이디에 대하여 카드사 결제창 direct 노출 기능을 지원하지 않습니다. 반드시 포트원을통해 현재 사용중인 상점아이디가 카드사 결제창 direct 호출이 가능하도록 설정이 되어있는지 PG사에 확인이 필요합니다.
•
KCP의 경우, 결제창 표시를 위한 가맹점명을 직접 company 파라미터에 설정해 주셔야 합니다.
(기본(default) : iamport)
Default view
Search
카드사 금융결제원 표준 코드 관련 참고사항
•
PG사별로 'O' 표시가 없는 공백의 경우, 현재 포트원에서 지원하지 않는 카드사 입니다.
빠른 시일 내에 추가 개발될 예정이며, 자세한 내용은 포트원 기술지원팀 (support@portone.io) 으로 문의 바랍니다.
•
PG사별로 '미지원' 표시는 해외결제로 카드사에서 지원하지 않음을 의미합니다.
