로고Developer Center

결제창 연동

허브계좌인증


연동하기

페이플 허브 계좌인증은 상대방 계좌의 유효성을 확인할 수 있는 제품입니다.
인터넷 은행을 포함한 모든 은행 및 증권사의 최신 계좌 정보를 조회할 수 있으며, 개인과 사업자에 관계없이 모든 예금주를 확인할 수 있습니다.

연동흐름

허브계좌인증_플로우
허브계좌인증_플로우

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 인증을 위한 토큰 발급

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

1.2 CustKey 확인

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

·주의사항

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

1.3 요청 예시

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

POST https://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으로 요청해주세요.

POST https://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. 연동 완료

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