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

운영

정산지급대행건별 실행결과 조회


연동하기

각 건별로 실제 이체 완료 결과를 수신할 수 있습니다.

연동 흐름

이체실행결과조회(건별)_플로우
이체실행결과조회(건별)_플로우

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 인증을 위한 토큰 발급

조회 요청 전 필수적인 인증 절차로, 이 과정에서 필요한 토큰을 발급받는 과정입니다.
매 API 요청 시 인증이 필요하며, 이때 발급된 토큰은 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
파라미터 확인 →

2.1 요청 예시

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

POSThttps://demohub.payple.kr/transfer/result테스트 환경
POSThttps://hub.payple.kr/transfer/result라이브 환경
Header
1Authorization: ‘Bearer ’ + {파트너 인증 후 응답된 access_token}
2Content-Type: application/json
3Cache-Control: no-cache
Body
JSON
1{
2  "cst_id": "test",
3  "custKey": "abcd1234567890",
4  "api_tran_id": "a9e10979-1cb9-44ff-95fd-bb4b1fb57701"
5}