키움페이 (다우데이타/페이조아)
키움페이 연동 방법을 안내합니다.
1. 키움페이 채널 설정하기
결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.
2.결제 요청하기
JavaScript SDK IMP.request_pay(param, callback)
을 호출하여 다우 페이조아 결제창을 호출할 수 있습니다. 결제 결과는 PC의 경우 IMP.request_pay(param, callback)
호출 후 callback으로 수신되고 모바일의 경우 m_redirect_url로 리디렉션됩니다.
페이조아 결제창 연동을 위해서는 JS SDK Version 1.2.0 이상을 사용하셔야 합니다.
Javascript SDKIMP.request_pay( { channelKey: "{콘솔 내 연동 정보의 채널키}", pay_method: "card", merchant_uid: "mid_1234567890", escrow: false, amount: 1004, name: "노스페이스 롱패딩 M", buyer_name: "홍길동", buyer_email: "hello@world.com", buyer_tel: "01012345678", digital: false, // 디지털로 계약되었다면 true로 설정 m_redirect_url: "https://allerts.com/payments/complete", bypass: { // 페이조아(다우데이타) 전용 파라미터 daou: { PRODUCTCODE: "portone", CASHRECEIPTFLAG: 0, }, }, app_scheme: "portoneappscheme", }, function (rsp) { // callback 로직 // * ...중략... * }, );
주요 파라미터 설명
channelKey
* string
채널키
결제를 진행할 채널을 지정합니다.
포트원 콘솔 내 [결제 연동] - [연동 정보] - [채널 관리] 에서 확인 가능합니다.
(최신 JavaScript SDK 버전부터 사용 가능합니다.)
pg
(deprecated) string
PG사 구분코드
daou
로 지정하면 됩니다.
pg
파라미터는 지원 중단 예정입니다.
JS SDK를 가장 최신 버전으로 업그레이드 후 channelKey
파라미터로 채널 설정(PG사 구분)을 대체해주세요.
pay_method
* string
결제수단 구분코드
- card(신용카드)
- trans(실시간 계좌이체)
- vbank(가상계좌)
merchant_uid
* string
주문번호
매번 고유하게 채번되어야 합니다.
digital
* string
디지털 컨텐츠 여부
고객사 <-> 페이조아간 계약 상태에 따라 정해진 올바른 값을 넣어야 함. 그렇지 않은 경우 결제 진행 불가
bypass.daou.PRODUCTCODE
string
결제 상품 고유 번호
값에 대해 정해진 규격이 없고 보내지 않을 경우 포트원에서 기본값(iamport)을 설정해 페이조아 측으로 전달
bypass.daou.CASHRECEIPTFLAG
``number
현금영수증 발급 구분코드
비 신용결제(계좌,가상)시 페이조아에서 자동발급 여부 구분코드
1
: 허용
0
: 차단
app_scheme
string
모바일 앱 URL Scheme
모바일 앱 환경에서 결제시 필수 파라미터
amount
*number
결제금액
string 이 아닌 점에 유의하세요.
escrow
boolean
에스크로 설정여부
계좌이체,가상계좌만 지원됩니다.
3. 부가기능
{
"display": {
"card_quota": [6] // 할부개월 6개월까지만 활성화
}
}
파라미터 설명
card_quota
:[]
: 일시불만 결제 가능2,3,4,5,6
: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
할부결제는 5만원 이상 결제 요청시에만 이용 가능합니다.