V1구버전 개발자센터
V2신버전 개발자센터

이 문서는 2026년 10월 2일부터 업데이트되지 않습니다. 최신 문서 보기

연동준비

해외 카드결제

샘플코드

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

java
node
react
python
python

API 키, 테스트 정보

페이플 가입 계약 심사가 완료되면 테스트 계정이 발급되며, 발급받은 테스트 계정으로 연동을 체험할 수 있습니다.

1. 접속정보

내용
접속 도메인https://demo-api.payple.kr
service_id발급받은 service_id
service_key발급받은 service_key
code영문+숫자 10자리 (직접 생성)

·통신 보안

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

2. 확인사항

내용
codecode 는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.
·code 생성규칙 영문+숫자 조합 10자리이며, 유효한 code 가 아닌 경우 T0211 응답코드를 수신합니다.
국내 카드 화이트리스트파트너(상점) 당 1개의 화이트리스트 처리 가능합니다.
·테스트 환경에서는 국내(KR), 해외발행카드 모두 이용 가능하지만, 라이브 환경에서는 해외발행카드만 이용 가능합니다.
·라이브 환경에서 국내(KR)발행카드로 테스트를 위해서는 고객센터(help@payple.kr)를 통한 화이트리스트 처리 요청이 필요합니다.
화이트(White) IP 등록페이플 해외 카드결제는 등록되어있는 IP 와의 통신만 허용되며, 등록은 고객센터(help@payple.kr)로 요청이 필요합니다.
·테스트 환경에서는 화이트 IP 등록이 필요없습니다.
위험국가 리스트위험국가에서 발행된 카드는 이상거래탐지시스템(Decision Manager)에 의해 결제가 거부됩니다.
·위험국가 코드는 여기에서 확인할 수 있습니다.

웹훅(Webhook)

페이플 웹훅을 이용하면 결제결과 누락을 방지할 수 있습니다.

1. 수신가능 이벤트

웹훅 종류설명
결제 완료결제 승인이 완료되면 보냅니다.
취소 완료결제가 취소되면 보냅니다.
·파트너 관리자에서 직접 취소한 건도 포함됩니다.

·라이브

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

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

2.1 결제 완료
해외 카드결제
JSON
1{
2  "type": "요청 종류",
3  "result": "응답 코드",
4  "message": "응답 메시지",
5  "resultUrl": "결제결과 반환(Return) URL",
6  "org_pay_id": "원거래 결제 고유키",
7  "api_id": "결제 요청 고유키",
8  "api_date": "대한민국(UTC+9) 기준 결제시간",
9  "receiptUrl": "매출전표(거래 내역서) 조회 URL",
10  "info": {
11    "service_oid": "주문번호",
12    "comments": "상품명",
13    "pay_type": "결제수단",
14    "card_number": "카드번호",
15    "totalAmount": "결제 요청금액",
16    "currency": "통화",
17    "firstName": "카드회원 이름",
18    "lastName": "카드회원 성",
19    "email": "이메일",
20    "phoneNumber": "휴대전화번호",
21    "billing_key": "빌링키",
22    "score_result": "Decision Manager 점수",
23    "submitTimeUtc": "국제표준시(UTC) 기준 결제시간"
24  },
25  "serviceDefine": "사용자 정의 파라미터"
26}
해외 카드결제 예시
JSON
1{
2  "type": "PAYMENT",
3  "result": "A0000",
4  "message": "Processing Success",
5  "resultUrl": "http://test.shop.com",
6  "org_pay_id": "",
7  "api_id": "6548264741426583803027",
8  "api_date": "2022-06-10 11:01:17",
9  "receiptUrl": "https://api.payple.kr/gpay/receipt?token=abc123...",
10  "info": {
11    "service_oid": "test120220608512351",
12    "comments": "테스트상품명",
13    "pay_type": "card",
14    "card_number": "1234-****-****-7890",
15    "totalAmount": "0.10",
16    "currency": "USD",
17    "firstName": "Gildong",
18    "lastName": "Hong",
19    "email": "test@payple.kr",
20    "phoneNumber": "01012345678",
21    "billing_key": "MlNCQ0pHMn...",
22    "score_result": "0",
23    "submitTimeUtc": "2022-06-10 02:01:16"
24  },
25  "serviceDefine": "Service Define Test"
26}
2.2 취소 완료
해외 카드결제
JSON
1{
2  "type": "요청 종류",
3  "result": "응답 코드",
4  "message": "응답 메시지",
5  "resultUrl": "취소 요청시 보낸 값 그대로 반환되는 URL",
6  "org_pay_id": "원거래 결제 고유키",
7  "api_id": "취소 고유키",
8  "api_date": "대한민국(UTC+9) 기준 취소시간",
9  "receiptUrl": "매출전표(거래 내역서) 조회 URL",
10  "info": {
11    "orgTotalAmount": "원거래 결제금액",
12    "totalAmount": "취소 요청 금액",
13    "remainAmount": "취소 후 잔여 금액",
14    "currency": "취소 통화",
15    "service_oid": "원거래 주문번호",
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  "org_pay_id": "6548264741426583803027",
7  "api_id": "676273618072602",
8  "api_date": "2022-06-10 16:09:22",
9  "receiptUrl": "https://api.payple.kr/gpay/receipt?token=abc123...",
10  "info": {
11    "orgTotalAmount": "0.10",
12    "totalAmount": "0.10",
13    "remainAmount": "0.00",
14    "currency": "USD",
15    "service_oid": "OID_22072217525616584799763773750",
16    "submitTimeUtc": "2022-06-10 07:09:22"
17  },
18  "serviceDefine": "Service Define Test"
19}
결제 연동과 관련된 무엇이든 물어보세요