로고Developer Center
홈페이지가입문의

파라미터

정산지급대행〉계좌인증

1. 파트너 인증 요청

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

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

인증이 성공적으로 완료된 경우, 수신되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
resultString응답 코드입니다.T0000
messageString응답 메시지입니다.처리 성공
codeString토큰 확인 코드입니다.as12345678
access_tokenString발행된 Access 토큰입니다.
  • API 요청 시 Header의 Authorization 필드에 포함하여 전송해야 합니다
eyJhlNDlj…
token_typeStringAccess 토큰 유형이며, 고정값입니다.Bearer
expires_inStringAccess 토큰 만료 시간입니다.(초)60

2. 계좌인증 요청

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

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

계좌인증이 성공적으로 완료된 후에 받게 되는 Response 파라미터는 다음과 같습니다.

파라미터타입설명값 예시
resultString페이플 응답코드입니다.A0000
messageString응답 메시지입니다.처리 성공
cst_idString파트너 ID입니다.test
sub_idString파트너 하위 셀러의 ID 입니다.sub01
billing_tran_idString인증 완료된 계좌의 빌링키입니다.cb9d695e-c034-4eeb-9550-c53a9ab7c2e4
api_tran_dtmString금융기관으로부터 수신한 인증 완료 상세일시입니다. (밀리세컨드)20240131175503547
bank_tran_idString금융기관과 통신을 위해 필요한 고유 키입니다.M202112389U152040289
bank_tran_dateString금육기관관으로부터 수신한 인증 완료 일자입니다.20240131
bank_rsp_codeString금융기관 응답코드입니다.000
bank_code_stdString금융기관 코드입니다.020
bank_code_subString금융기관 점별 코드입니다.
  • 금융기관 공동코드 3자리와 지점코드 4자리로 구성
0201234
bank_nameString금융기관명입니다.우리은행
account_numString계좌번호입니다.1234567890123456
account_holder_nameString예금주명입니다김이플