파라미터
허브〉계좌인증
1. 파트너 인증 요청
파트너 인증에 필요한 Request 파라미터는 아래와 같습니다.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| cst_id | String | 12 | 파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. | demo | |
| service_key | String | 255 | 파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다. 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요. | abcd1234567890 | |
| code | String | 10 | 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다. 영문+숫자 조합 10자리로 구성되어야 합니다. | as12345678 |
인증이 성공적으로 완료된 경우, 수신되는 Response 파라미터는 다음과 같습니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| result | String | 응답 코드입니다. | T0000 |
| message | String | 응답 메시지입니다. | 처리 성공 |
| code | String | 토큰 확인 코드입니다. | as12345678 |
| access_token | String | 발행된 Access 토큰입니다.
| eyJhlNDlj… |
| token_type | String | Access 토큰 유형이며, 고정값입니다. | Bearer |
| expires_in | String | Access 토큰 만료 시간입니다.(초) | 60 |
2. 계좌인증 요청
파트너 인증 후 계좌인증 요청 시 필요한 Request 파라미터는 아래와 같습니다.
| 파라미터 | 필수 | 타입 | 길이 | 설명 | 값 예시 |
|---|---|---|---|---|---|
| cst_id | String | 255 | 파트너 인증을 위한 ID 입니다. 라이브 ID 는 계약이 완료되어야 발급 가능합니다. | test | |
| custKey | String | 255 | 파트너 인증을 위한 키입니다. 라이브 키는 계약이 완료되어야 발급 가능합니다. 외부에 노출되면 안되는 정보입니다. 보안에 유의해주세요. | abcd1234567890 | |
| bank_code_std | String | 3 | 금융기관 코드입니다. | 020 | |
| account_num | String | 13 | 계좌번호입니다. | 1234567890123456 | |
| account_holder_info_type | String | 1 | 예금주 구분 코드입니다.
| 0 | |
| account_holder_info | String | 10 | 예금주 생년월일(사업자번호)입니다.
| 880212 | |
| sub_id | String | 64 | 파트너 하위 셀러의 ID 입니다. | sub01 |
계좌인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.
| 파라미터 | 타입 | 설명 | 값 예시 |
|---|---|---|---|
| result | String | 페이플 응답코드입니다. | A0000 |
| message | String | 응답 메시지입니다. | 처리 성공 |
| cst_id | String | 파트너 ID입니다. | test |
| sub_id | String | 파트너 하위 셀러의 ID 입니다. | sub01 |
| billing_tran_id | String | 인증 완료된 계좌의 빌링키입니다. | cb9d695e-c034-4eeb-9550-c53a9ab7c2e4 |
| api_tran_dtm | String | 금융기관으로부터 수신한 인증 완료 상세일시입니다. (밀리세컨드) | 20240131175503547 |
| bank_tran_id | String | 금융기관과 통신을 위해 필요한 고유 키입니다. | M202112389U152040289 |
| bank_tran_date | String | 금육기관관으로부터 수신한 인증 완료 일자입니다. | 20240131 |
| bank_rsp_code | String | 금융기관 응답코드입니다. | 000 |
| bank_code_std | String | 금융기관 코드입니다. | 020 |
| bank_code_sub | String | 금융기관 점별 코드입니다.
| 0201234 |
| bank_name | String | 금융기관명입니다. | 우리은행 |
| account_num | String | 계좌번호입니다. | 1234567890123456 |
| account_holder_name | String | 예금주명입니다 | 김이플 |