로고Developer Center
홈페이지가입문의

결제창 연동

정산지급대행정산지급대행


연동하기

페이플 정산지급대행은 페이플이 파트너(플랫폼)에게 정산할 금액을 플랫폼이 지정한 셀러의 계좌로 자동으로 지급하는 서비스입니다.
주말 및 공휴일과 같은 비영업일에도 실시간 이체가 가능합니다.

연동흐름

정산지급대행_플랫폼정산자동화_플로우
정산지급대행_플랫폼정산자동화_플로우

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 인증을 위한 토큰 발급

계좌인증 요청 전 필수적인 인증 절차로, 이 과정에서 필요한 토큰을 발급받는 과정입니다.
매 결제 시 인증이 필요하며, 이때 발급된 토큰은 60초간 유효합니다.

1.2 CustKey 확인

계약 완료 후 페이플 담당자에게 전달받은 custKey를 확인해주세요.

·주의사항

custKey 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.

1.3 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://demohub.payple.kr/oauth/token테스트 환경
POSThttps://hub.payple.kr/oauth/token라이브 환경
Header
1Content-Type: application/json
2Cache-Control: no-cache
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "code": "as12345678"
5}

·주의사항

code는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.
영문+숫자 조합 10자리로 구성되어야 합니다.

2. 계좌인증 요청

Server
파라미터 확인 →

파트너 인증 후 REST API를 사용해 계좌 인증을 요청하면, 예금주 이름이 반환됩니다.

2.1 요청 예시

파트너 인증 후 응답된 access_token으로 요청해주세요.

POSThttps://demohub.payple.kr/inquiry/real_name테스트 환경
POSThttps://hub.payple.kr/inquiry/real_name라이브 환경
Header
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "sub_id": "sub01",
5  "bank_code_std": "020",
6  "account_num": "",
7  "account_holder_info_type": "0",
8  "account_holder_info": "880212"
9}

3. 빌링키로 이체 대기 요청

Server
파라미터 확인 →

계좌인증이 성공적으로 완료된 후에는 대기 단계가 시작되며, 이 단계에서는 실제 이체가 이루어지지 않습니다.

3.1 요청 예시

파트너 인증 후 응답된 access_token으로 요청해주세요.

POSThttps://demohub.payple.kr/transfer/request테스트 환경
POSThttps://hub.payple.kr/transfer/request라이브 환경
Header
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "sub_id": "sub01",
5  "distinct_key": "c9z116521650283...",
6  "billing_tran_id": "6fen3g2m-j9hb-...",
7  "tran_amt": "1000",
8  "print_content": "테스트입니다"
9}

4. 이체 실행 요청

Server
파라미터 확인 →

이체 대기가 성공적으로 완료된 후에 실제 이체가 진행되는 단계입니다. 아래의 내용을 주의 깊게 확인해주세요.

빌링키 billing_tran_id값에 따라 그룹키 group_key에 속한 대기 건의 이체 실행이 결정됩니다.

·ALL : group_key 에 속한 모든 대기 건의 이체가 진행됩니다.

·특정 빌링키 : group_key 에 속한 특정 빌링키 대기 건의 이체가 진행됩니다.

group_key 는 이체 대기를 수행한 여러 건을 하나의 그룹으로 묶는 역할을 하며, 이체 실행 요청 시 이 그룹키를 기준으로 실제 이체가 진행됩니다.

·특정 빌링키 group_key 내의 여러 건 중 일부만 이체 실행이 완료되었을 경우, 나머지 미실행 건들은 기존 group_key 에 계속 묶여 있습니다.

4.1 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://demohub.payple.kr/transfer/execute테스트 환경
POSThttps://hub.payple.kr/transfer/execute라이브 환경
Header
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "group_key": "Q0RSSkYzWUI3...",
5  "billing_tran_id": "ALL",
6  "execute_type": "NOW",
7  "webhook_url": "http://your-test-domain.com"
8}

·안내사항

webhook_url 테스트 서버로 요청시에만 필요합니다.

5. 결과 수신

Server
파라미터 확인 →

이체가 성공적으로 완료되면, 결과는 웹훅을 통해 건별로 수신됩니다.
예를 들어, 그룹키 A에 묶인 5건의 이체 대기 건이 있을 경우, 모든 대기 건에 대해 ALL로 이체를 실행하면, 결과적으로 총 5건의 이체 결과를 수신하게 됩니다.

6. 연동 완료

모든 연동 작업을 완료하셨습니다.