연동준비

해외 간편결제

샘플코드

페이플 결제 연동을 위한 샘플코드는 아래 버튼을 눌러 확인해주세요.

API 키, 테스트 정보

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

·통신 보안

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

1. 확인사항

	내용
code	code 는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다. ·code 생성규칙 영문+숫자 조합 10자리이며, 유효한 code 가 아닌 경우 T0211 응답코드를 수신합니다.
결제 통화	현재 Alipay+만 지원되며 결제 통화는 CNY 입니다. 결제창 요청 시 currency 를 생략하면 CNY 로 처리됩니다. ·CNY 최소 결제금액은 1 입니다. ·Alipay+는 중국 신분증을 가진 고객만 결제가 가능합니다.
화이트(White) IP 등록	페이플 해외 결제는 등록되어있는 IP 와의 통신만 허용되며, 등록은 고객센터(help@payple.kr)로 요청이 필요합니다.

웹훅(Webhook)

페이플 웹훅을 이용하면 결제결과 누락을 방지할 수 있습니다. 해외 간편결제 웹훅 파라미터는 camelCase 입니다.

1. 수신가능 이벤트

웹훅 종류	설명
결제 완료	결제 완료 결과를 수신합니다.
취소 완료	결제 취소 결과를 수신합니다. ·파트너 관리자에서 직접 취소한 건도 포함됩니다.

·라이브

라이브 환경에서 웹훅 등록은 파트너 관리자 〉 기본정보 메뉴에서 가능합니다.

2. 수신 데이터 설명과 예시

2.1 결제 완료

해외 간편결제

JSON

1{
2  "type": "요청 종류",
3  "result": "응답 코드",
4  "message": "응답 메시지",
5  "resultUrl": "결제결과 반환(Return) URL",
6  "apiId": "결제 요청 고유키",
7  "apiDate": "대한민국(UTC+9) 기준 결제시간",
8  "receiptUrl": "매출전표(거래 내역서) 조회 URL",
9  "info": {
10    "serviceOid": "주문번호",
11    "comments": "상품명",
12    "payType": "결제수단",
13    "totalAmount": "결제 요청금액",
14    "currency": "통화",
15    "firstName": "구매자 이름",
16    "lastName": "구매자 성",
17    "email": "이메일",
18    "billingKey": "빌링키"
19  },
20  "serviceDefine": "사용자 정의 파라미터"
21}

해외 간편결제 예시

JSON

1{
2  "type": "PAYMENT",
3  "result": "A0000",
4  "message": "Processing Success",
5  "resultUrl": "http://test.shop.com",
6  "apiId": "6548264741426583803027",
7  "apiDate": "2022-06-10 11:01:17",
8  "receiptUrl": "https://api.payple.kr/gpay/receipt?token=abc123...",
9  "info": {
10    "serviceOid": "order12345",
11    "comments": "테스트 상품",
12    "payType": "alipay",
13    "totalAmount": "1.00",
14    "currency": "CNY",
15    "firstName": "iple",
16    "lastName": "Kim",
17    "email": "complete@payer-email.com",
18    "billingKey": "MlNCQ0pHMn..."
19  },
20  "serviceDefine": "Service Define Test"
21}

2.2 취소 완료

해외 간편결제

JSON

1{
2  "type": "요청 종류",
3  "result": "응답 코드",
4  "message": "응답 메시지",
5  "resultUrl": "취소 요청시 보낸 값 그대로 반환되는 URL",
6  "orgPayId": "원거래 결제 고유키",
7  "apiId": "취소 고유키",
8  "apiDate": "대한민국(UTC+9) 기준 취소시간",
9  "receiptUrl": "매출전표(거래 내역서) 조회 URL",
10  "info": {
11    "orgTotalAmount": "원거래 결제금액",
12    "totalAmount": "취소 요청 금액",
13    "remainAmount": "취소 후 잔여 금액",
14    "currency": "취소 통화",
15    "serviceOid": "원거래 주문번호",
16    "submitTimeUtc": "국제표준시(UTC) 기준 취소시간"
17  },
18  "serviceDefine": "사용자 정의 파라미터"
19}

해외 간편결제 예시

JSON

1{
2  "type": "CANCEL",
3  "result": "A0000",
4  "message": "Processing Success",
5  "resultUrl": "http://test.shop.com",
6  "orgPayId": "6548264741426583803027",
7  "apiId": "676273618072602",
8  "apiDate": "2022-06-10 16:09:22",
9  "receiptUrl": "https://api.payple.kr/gpay/receipt?token=abc123...",
10  "info": {
11    "orgTotalAmount": "1.00",
12    "totalAmount": "1.00",
13    "remainAmount": "0.00",
14    "currency": "CNY",
15    "serviceOid": "order12345",
16    "submitTimeUtc": "2022-06-10 07:09:22"
17  },
18  "serviceDefine": "Service Define Test"
19}