오픈API
수취조회
"수취조회 API"는 이용기관이 입금이체 요청 전 수취계좌의 입금가능여부 및 수취인 성명을 사전에 조회하기 위한 용도로 사용할 수 있습니다.
출금이체 API는 POST 메소드로 호출되며, 상세 스펙 및 호출 예제는 아래와 같습니다.
요청메시지 URL
| HTTP URL | https://openapi.openbanking.or.kr/v2.0/inquiry/receive |
|---|---|
| HTTP Method | POST |
| Content-Type | application/json; charset=UTF-8 |
요청 메시지 명세
| HTTP | 항목 | 값 | TYPE (길이) | 설명 |
|---|---|---|---|---|
| Header | Authorization | Bearer<access_token> | 조회서비스 계좌등록 시 오픈뱅킹으로부터 전송받은 access _token을 HTTP Header에 추가 [scope = oob] | |
| Parameter | bank_tran_id | "F123456789U4BC34239Z" | AN(20) | 은행거래고유번호 |
| cntr_account_type | "N" | A(1) | 약정 계좌/계정구분 N:계좌, C:계정 | |
| cntr_account_num | "1101230000678" | AN(16) | 약정 계좌/계정 번호 | |
| bank_code_std | "097" | AN(3) | 입금은행.표준코드 | |
| account_num | "3001230000678" | AN(16) | 계좌번호 | |
| account_seq | “001” | AN(3) | 회차번호 | |
| fintech_use_num | "123456789012345678901234" | AN(24) | 핀테크이용번호 | |
| print_content | "홍길동송금" | AH(20) | 입금계좌인자내역 | |
| tran_amt | "10000" | N(12) | 거래금액 | |
| req_client_name | “홍길동” | AH(20) | 요청고객성명 | |
| req_client_bank_code | "097" | AN(3) | 요청고객계좌 개설기관.표준코드 | |
| req_client_account_num | "1221230000678" | AN(16) | 요청고객계좌번호 | |
| req_client_fintech_use_num | "123456789012345678901234" | AN(24) | 요청고객핀테크이용번호 | |
| req_client_num | “HONGGILDONG1234” | AN(20) | 요청고객회원번호 | |
| transfer_purpose | “TR” | AN(2) | 이체용도 TR:송금, ST:결제, AU:인증 | |
| sub_frnc_name | “하위가맹점” | AH(40) | 하위가맹점명 | |
| sub_frnc_num | “123456789012” | AN(20) | 하위가맹점명 | |
| sub_frnc_business_num | “1234567890” | N(10) | 하위가맹점 사업자등록번호 | |
| cms_num | “93848103221” | AN(32) | CMS 번호 |
요청 메시지 형태
{
"bank_tran_id": "F123456789U4BC34239Z",
"cntr_account_type": "N",
"cntr_account_num": "1101230000678",
"bank_code_std": "097",
"account_num": "3001230000678",
"print_content": "홍길동송금",
"tran_amt": "10000",
"req_client_name": "홍길동",
"req_client_bank_code": "097",
"req_client_account_num": "1221230000678",
"req_client_num": "HONGGILDONG1234",
"transfer_purpose": "TR",
"sub_frnc_name": "하위가맹점",
"sub_frnc_num": "123456789012",
"sub_frnc_business_num": "1234567890",
"cms_num": "93848103221"
}
응답 메시지 명세
| HTTP | 항목 | 값 | TYPE (길이) | 설명 |
|---|---|---|---|---|
| Body | api_tran_id | "2ffd133a-d17a-431d-a6a5" | aNS(40) | 거래고유번호(API) |
| api_tran_dtm | "20190910101921567" | N(17) | 거래일시(밀리세컨드) | |
| rsp_code | "A0000" | AN(5) | 응답코드(API) | |
| rsp_message | "" | AH(300) | 응답메시지(API) | |
| bank_code_std | "097" | AN(3) | 입금기관.표준코드 | |
| bank_code_sub | "1230001" | AN(7) | 입금기관.점별코드 | |
| bank_name | "오픈은행" | AH(20) | 입금기관명 | |
| savings_bank_name | “오픈저축은행” | AH(20) | 개별저축은행명 | |
| account_num | "3001230000678" | AN(16) | 입금계좌번호* | |
| account_seq | “001” | AN(3) | 회차번호 | |
| account_num_masked | "300123-0000-***" | NS*(20) | 입금계좌번호(출력용) | |
| print_content | "홍길동송금" | AH(20) | 입금계좌인자내역 | |
| account_holder_name | "허균(개인)" | AH(20) | 수취인성명 | |
| bank_tran_id | "F123456789U4BC34239Z" | AN(20) | 총 거래고유번호(참가은행) | |
| bank_tran_date | "20190910" | N(8) | 거래일자(참가은행) | |
| bank_code_tran | "097" | AN(3) | 응답코드를 부여한 참가은행.표준코드 | |
| bank_rsp_code | "000" | AN(3) | 응답코드(참가은행) | |
| bank_rsp_message | "" | AH(100) | 응답메시지(참가은행) | |
| wd_bank_code_std | "097" | AN(3) | 출금(개설)기관. 표준코드 | |
| wd_bank_name | "오픈은행" | AH(20) | 출금(개설)기관명 | |
| wd_account_num | "1101230000678" | AN(16) | 출금계좌번호 | |
| tran_amt | "10000" | N(12) | 거래금액 | |
| cms_num | “93848103221” | AN(32) | CMS 번호 |
응답 메시지 형태
{
"api_tran_id": "2ffd133a-d17a-431d-a6a5",
"api_tran_dtm": "20190910101921567",
"rsp_code": "A0000",
"rsp_message": "",
"bank_code_std": "097",
"bank_code_sub": "1230001",
"bank_name": "오픈은행",
"account_num": "3001230000678",
"account_num_masked": "300123-0000-***",
"print_content": "홍길동송금",
"account_holder_name": "허균",
"bank_tran_id": "F123456789U4BC34239Z",
"bank_tran_date": "20190910",
"bank_code_tran": "097",
"bank_rsp_code": "000",
"bank_rsp_message": "",
"wd_bank_code_std": "097",
"wd_bank_name": "오픈은행",
"wd_account_num": "1101230000678",
"tran_amt": "10000",
"cms_num": "93848103221"
}
본관 : (우)04631 서울특별시 중구 퇴계로 110 (회현동3가)
분당센터 : (우)13556 경기도 성남시 분당구 정자일로213번길 9 (정자동)
Copyright ⓒ 2019 KFTC (Korea Financial Telecommunications & Clearings Institute)
All rights reserved.
