운영
정산지급대행〉건별 실행결과 조회
연동하기
각 건별로 실제 이체 완료 결과를 수신할 수 있습니다.
연동 흐름
1. 파트너 인증 요청
Server1.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. 이체 실행결과 조회 요청
Server2.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}