해외 간편페이 결제

간편페이는 현재 Alipay+만 지원되며, Alipay+는 중국 신분증을 가진 고객만 결제가 가능합니다.

00연동 준비

해외 간편결제(Alipay+)는 현재 운영 환경에서만 제공 중입니다. Alipay+ 테스트 환경은 지원되지 않습니다.

스크립트 정보

사전 로드 (jQuery)<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js"></script>

라이브용<script src="https://gpay.payple.kr/common/js/gpay-2.0.0.js"></script>

참고

통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.

server

참고

매 결제마다 새 토큰파트너 인증은 매 결제 요청마다 필요합니다. 발급된 토큰(access_token)은 10분간 유효합니다.

POST라이브https://api.payple.kr/gpay/oauth/1.0/token

결제창 호출을 위한 파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

파라미터	타입	설명	값 예시
service_id필수	String 20	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	your_service_id
service_key필수	String 128	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	your_service_key
code필수	String 10	파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.영문+숫자 조합 10자리로 구성되어야 합니다.	as12345678

client

아래는 결제창 호출 시 사용 가능한 Request 파라미터 목록입니다.

파라미터	타입	설명	값 예시
Authorization필수	String 500	파트너 인증 후 발급받은 access_token 입니다.
serviceId필수	String 20	파트너 인증을 위한 ID 입니다.라이브 ID 는 계약이 완료되어야 발급 가능합니다.	your_service_id
comments필수	String 200	상품명입니다.	테스트 상품
totalAmount필수	String 10	결제금액입니다.소수점 둘째 자리까지만 허용CNY 최소 결제금액은 1	1.00
resultUrl필수	String 500	결제 정보가 성공적으로 입력된 경우, 인증 결과가 POST 방식으로 전송됩니다.	/result
orders	String	결제창에 표시할 상품 정보입니다. 객체 배열을 JSON 문자열로 전송합니다.금액·수량·주문번호는 숫자로 넣어도 문자열로 통일해 전송합니다.	[{"orderId":"item-001","name":"테스트 상품","quantity":"1","unitPrice":"1.00"}]
orderId필수	String	상품 주문번호입니다. orders 전송 시 필수입니다.	item-001
name필수	String	상품명입니다. orders 전송 시 필수입니다.	테스트 상품
quantity필수	String	상품 수량입니다. orders 전송 시 필수입니다.	1
unitPrice필수	String	상품 단가입니다. orders 전송 시 필수입니다.	1.00

server

결제 정보가 성공적으로 입력된 경우, 인증 결과는 POST 방식으로 resultUrl로 전송됩니다.

ops

결제가 끝나면 취소, 조회, 해지가 따라옵니다.
실제 연동 흐름상 결제 기능과 연계되는 부분이므로 이어 설명합니다.

POST라이브https://api.payple.kr/gpay/cancel