해외 카드 결제
V1구버전 개발자센터
V2신버전 개발자센터

해외 카드 결제

키인 결제는 해외 고객에게 익숙한 카드 정보 입력 방식의 간편한 비인증 결제입니다.

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.kr
service_id발급받은 service_id
service_key발급받은 service_key
code영문+숫자 10자리 (직접 생성)
참고
환경별 키 분리테스트와 라이브는 service_idservice_key 가 다릅니다. 환경변수로 분리해두세요.
통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.
연동 전 확인사항code, 국내 카드 화이트리스트, 화이트(White) IP 등록, 위험국가 리스트문서 바로가기웹훅결제 완료, 취소 완료 결과를 받아 누락을 막습니다문서 바로가기

01파트너 인증 요청

server
참고
매 결제마다 새 토큰파트너 인증은 매 결제 요청마다 필요합니다. 발급된 토큰(access_token)은 10분간 유효합니다.
POST테스트https://demo-api.payple.kr/gpay/oauth/1.0/token
POST라이브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
ordersString결제창에 표시할 상품 정보입니다. 객체 배열을 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/cancel
POST라이브https://api.payple.kr/gpay/cancel
결제 연동과 관련된 무엇이든 물어보세요