결제창 연동
정산지급대행〉정산지급대행
연동하기
페이플 정산지급대행은 페이플이 파트너(플랫폼)에게 정산할 금액을 플랫폼이 지정한 셀러의 계좌로 자동으로 지급하는 서비스입니다.
주말 및 공휴일과 같은 비영업일에도 실시간 이체가 가능합니다.
연동흐름
1. 파트너 인증 요청
Server1.1 인증을 위한 토큰 발급
계좌인증 요청 전 필수적인 인증 절차로, 이 과정에서 필요한 토큰을 발급받는 과정입니다.
매 결제 시 인증이 필요하며, 이때 발급된 토큰은 60초간 유효합니다.
1.2 CustKey 확인
계약 완료 후 페이플 담당자에게 전달받은 custKey를 확인해주세요.
·주의사항
custKey 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.
1.3 요청 예시
Header 설정 후 API를 요청해주세요.
1Content-Type: application/json
2Cache-Control: no-cache1{
2 "cst_id": "test",
3 "custKey": "abcd1234567890",
4 "code": "as12345678"
5}·주의사항
code는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.
영문+숫자 조합 10자리로 구성되어야 합니다.
2. 계좌인증 요청
Server파트너 인증 후 REST API를 사용해 계좌 인증을 요청하면, 예금주 이름이 반환됩니다.
2.1 요청 예시
파트너 인증 후 응답된 access_token으로 요청해주세요.
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache1{
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으로 요청해주세요.
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache1{
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를 요청해주세요.
1Authorization: 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache1{
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. 연동 완료
모든 연동 작업을 완료하셨습니다.