국내 계좌조회

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

00연동 준비

페이플이 제공하는 테스트 정보를 통해 계약 전 단계에서도 누구나 연동 체험이 가능합니다.

테스트 환경 접속 정보

접속 도메인https://demohub.payple.kr

cst_idtest

custKeyabcd1234567890

참고

환경별 키 분리테스트와 라이브는 cst_idcustKey 가 다릅니다. 환경변수로 분리해두세요.

통신 보안파트너사는 TLS v1.2 이상 / SSL 보안 통신(HTTPS)을 필수적으로 적용해야 합니다.

server

참고

요청마다 새 토큰파트너 인증은 매 요청마다 필요합니다. 발급된 토큰(access_token)은 60초간 유효합니다.

POST테스트https://demohub.payple.kr/oauth/token

POST라이브https://hub.payple.kr/oauth/token

파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.

파라미터	타입	설명	값 예시
cst_id필수	String 12	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	test
custKey필수	String 255	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	abcd1234567890
code필수	String 10	파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.영문+숫자 조합 10자리로 구성되어야 합니다.	as12345678

server

파트너 인증 후 REST API를 사용해 계좌 조회를 요청하면, 예금주 이름이 반환됩니다.

POST테스트https://demohub.payple.kr/inquiry/real_name

POST라이브https://hub.payple.kr/inquiry/real_name

파트너 인증 후 계좌조회 요청 시 필요한 Request 파라미터는 아래와 같습니다.

파라미터	타입	설명	값 예시
cst_id필수	String 255	파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다.	test
custKey필수	String 255	파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다.외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요.	abcd1234567890
bank_code_std필수	String 3	금융기관 코드입니다.	020
account_num필수	String 16	계좌번호입니다.	1234567890123456
account_holder_info_type필수	String 1	예금주 구분 코드입니다.0 : 개인, 개인사업자6 : 법인사업자	0
account_holder_info필수	String 10	예금주 생년월일(사업자번호)입니다.개인, 개인사업자 : 생년월일 6자리(YYMMDD)법인사업자 : 사업자번호 10자리	880212
sub_id	String 64	파트너 하위 셀러의 ID 입니다.	sub01

server

계좌조회 응답으로 아래를 확인한 뒤, 서비스 기준에 따라 계좌 등록을 마칩니다. 이 단계에서 호출하는 API 는 없습니다.

참고

확인할 것

지급이체도 사용한다면응답의 billing_tran_id 를 보관하고 정산금 이체 문서를 이어서 보세요. 정산금 이체 문서에도 계좌조회 단계가 들어 있습니다.