해외 카드 결제
키인 결제는 해외 고객에게 익숙한 카드 정보 입력 방식의 간편한 비인증 결제입니다.
00연동 준비
페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.
스크립트 정보
사전 로드 (jQuery)
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>테스트용
<script src="https://demo-gpay.payple.kr/common/js/gpay-2.0.0.js"></script>라이브용
<script src="https://gpay.payple.kr/common/js/gpay-2.0.0.js"></script>테스트 환경 접속 정보
접속 도메인
https://demo-api.payple.krservice_id
발급받은 service_idservice_key
발급받은 service_keycode
영문+숫자 10자리 (직접 생성)참고
연동 전 확인사항code, 국내 카드 화이트리스트, 화이트(White) IP 등록, 위험국가 리스트문서 바로가기웹훅결제 완료, 취소 완료 결과를 받아 누락을 막습니다문서 바로가기환경별 키 분리테스트와 라이브는 service_idservice_key 가 다릅니다. 환경변수로 분리해두세요.
통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.
01파트너 인증 요청
server참고
매 결제마다 새 토큰파트너 인증은 매 결제 요청마다 필요합니다. 발급된 토큰(
access_token)은 10분간 유효합니다.POST테스트
https://demo-api.payple.kr/gpay/oauth/1.0/tokenPOST라이브
https://api.payple.kr/gpay/oauth/1.0/token결제창 호출을 위한 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| service_id필수 | String 20 | 파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. | 발급받은 service_id |
| service_key필수 | String 128 | 파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요. | 발급받은 service_key |
| code필수 | String 10 | 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.영문+숫자 조합 10자리로 구성되어야 합니다. | 영문+숫자 10자리 (직접 생성) |
02결제창 호출
client| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| Authorization필수 | String 500 | 파트너 인증 후 발급받은 access_token 입니다. | |
| serviceId필수 | String 20 | 파트너 인증을 위한 ID 입니다.라이브 ID 는 계약이 완료되어야 발급 가능합니다. | 발급받은 serviceId |
| comments필수 | String 200 | 상품명입니다. | 테스트 상품 |
| totalAmount필수 | String 10 | 결제금액입니다.외화(USD, JPY)는 소수점 둘째 자리까지만 허용원화(KRW)는 정수만 가능(소수점 불가) | 0.10 |
| currency필수 | String 3 | 결제통화입니다.가능한 통화는 KRW, USD, JPY 이며, 통화별 파트너(상점) 계정 발급이 필요테스트 환경에서는 USD 만 가능 | USD |
| resultUrl필수 | String 500 | 결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다. | /result |
| payCls필수 - 테스트 시 | String 10 | 테스트 서버로 결제요청 시에 필요한 값입니다. | demo |
| orders | String | 결제창에 표시할 상품 정보입니다. 객체 배열을 JSON 문자열로 전송합니다.금액·수량·주문번호는 숫자로 넣어도 문자열로 통일해 전송합니다. | [{"orderId":"item-001","name":"테스트 상품","quantity":"1","unitPrice":"0.10"}] |
| orderId필수 | String | 상품 주문번호입니다. orders 전송 시 필수입니다. | item-001 |
| name필수 | String | 상품명입니다. orders 전송 시 필수입니다. | 테스트 상품 |
| quantity필수 | String | 상품 수량입니다. orders 전송 시 필수입니다. | 1 |
| unitPrice필수 | String | 상품 단가입니다. orders 전송 시 필수입니다. | 0.10 |
03결제결과 수신
server결제 정보가 성공적으로 입력된 경우, 인증 결과는 POST 방식으로 resultUrl로 전송됩니다.
저장해두기
billing_key04 운영04운영
ops결제가 끝나면 취소, 조회, 해지가 따라옵니다.
실제 연동 흐름상 결제 기능과 연계되는 부분이므로 이어 설명합니다.
POST테스트
https://demo-api.payple.kr/gpay/cancelPOST라이브
https://api.payple.kr/gpay/cancel