로고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
3
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/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": "CANCEL"
7}