⌨
페이팔
페이팔 결제연동 방법을 안내합니다.
Paypal Express checkout 신규 신청 및 신규 연동이 불가합니다. 페이팔 연동을 원하는 경우, 페이팔 SPB(Smart Payment Buttons) 연동 방법으로 진행 바랍니다.
JavaScript SDK IMP.request_pay(param, callback)을 호출하여 페이팔 결제창을 호출할 수 있습니다. 결제결과는 PC / 모바일 모두 m_redirect_url 리디렉션됩니다.
인증결제창 요청
Javascript SDK
IMP.request_pay({
pg : 'paypal.{API 사용자 이름}',
pay_method : 'card',
merchant_uid: "order_no_0001", // 상점에서 관리하는 주문 번호
name : '주문명:결제테스트',
amount : 14.20,
currency : 'USD', // 기본값: USD(원화 KRW는 페이팔 정책으로 인해 지원하지 않음)
buyer_email : '[email protected]',
buyer_name : '구매자이름',
buyer_tel : '010-1234-5678',
buyer_addr : '서울특별시 강남구 삼성동',
buyer_postcode : '123-456',
m_redirect_url : '{결제 완료 후 리디렉션 될 URL}'
}, function(rsp) { // callback 로직
//* ...중략... *//
});
주요 파라미터 설명
pg *stringPG사 구분코드
paypal 로 지정하면 됩니다.pay_method * string결제수단 구분코드
- card (신용카드)
merchant_uid * string주문번호매번 고유하게 채번되어야 합니다.
amount * integer결제금액
string 이 아닌점에 유의하세요
currency * string결제통화코드
m_redirect_url * string결제결과 수신 URL
PC환경 모바일 환경 모두 해당 값을 필수로 설정해야 결과를 받아볼수 있습니다.
Paypal에서는 고위험업종(게임, 디지털 콘텐츠) 가맹점의 경우 판매자 보호 및 더 높은 수준의 위험관리를 위해 STC API(SetTransactionContext API)를 제공합니다.
고위험거래를 안전하게 요청하기 위해서는 거래를 증명할 추가적인 정보(STC API로 전달할 정보)가 필요하며, 아래 예제와 같이
request_pay에 파라미터를 추가하여 고위험거래를 요청할 수 있습니다.IMP.request_pay({
/* 요청 객체 */
// Paypal 전용 파라미터로 결제요청 파라미터 문서에 존재하지 않습니다.
optional: {
"use_stc_api": true,
"stc_data": {
// Paypal과 협의한 STC(SetTransactionContext) 데이터를 넣어주세요.
"sender_account_id": "A12345N343"
}
}
});
고위험거래인 경우에만 해당 파라미터가 제공될 수 있도록 사용에 유의해주세요.
STC API를 사용하 기 위해서는 Paypal과의 STC 데이터 협의가 필요하며, 포트원 지원팀([email protected])을 통해 요청해주시면 협의 프로세스를 안내해드리고 있습니다.
연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 아래 pdf의 Create REST API Application 섹션을 완료해주세요.
STC Integration For DG.Gaming with Order v2 API.pdf
460KB
PDF
참고사항
포트원은 페이팔 정기결제를 지원하지 않습니다.
Last modified 4mo ago