로고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예금주명입니다김이플