{"openapi":"3.0.3","info":{"title":"APICK 계좌 예금주 실명 조회","version":"1.0.0","description":"해당 계좌의 예금주 실명을 확인합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/account_realname":{"post":{"summary":"계좌 예금주 실명 조회","description":"해당 계좌의 예금주 실명을 확인합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"은행코드":{"type":"string","description":"조회한 계좌의 은행 코드 3자리입니다. 예: 004"},"은행명":{"type":"string","description":"조회한 계좌의 은행명입니다. 은행코드 조회 API의 name과 같은 표기입니다. 예: 국민"},"계좌번호":{"type":"string","description":"조회한 계좌번호입니다. 요청한 계좌와 같은지 확인할 때 씁니다."},"계좌실명":{"type":"string","description":"예금주명입니다. 일부 계좌는 일정 길이(10자)에서 잘려 제공될 수 있으므로 위 '예금주명 길이'를 참고해 비교하세요."},"success":{"type":"integer","description":"처리 상태입니다. 1이면 예금주명을 받은 정상 응답(요금 차감), 0이면 실패 응답(차감 없음)입니다."},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없으며, 값이 있으면 아래 오류 응답 표에서 원인과 조치를 확인하세요."}},"description":"조회 결과 묶음입니다. 실패하면 아래 네 필드 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상적으로 받아 처리했는지 여부입니다. 예금주명을 받았는지는 data.계좌실명으로 확인하세요."},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. data.error가 있는 실패 응답은 0입니다."},"ms":{"type":"integer","description":"요청을 받아 응답을 만들기까지 걸린 시간(밀리초)입니다. 네트워크 왕복 시간은 포함되지 않습니다."},"pl_id":{"type":"integer","description":"포인트 차감 기록 번호입니다. 차감이 있었던 호출에만 값이 있으며 과금 문의 때 사용합니다."}},"description":"호출 공통 정보입니다. 처리 여부·차감 포인트·처리 시간·차감 기록 번호가 들어 있습니다."}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"account_num":{"type":"string","description":"조회할 계좌번호입니다. 하이픈 없이 숫자만 입력하며, 은행별 자릿수가 다릅니다. 예금주·은행 코드와 함께 확인하세요. (string)","example":"12345678901234"},"bank_code":{"type":"string","description":"은행코드. bank_name과 둘 중 하나는 필수이며 함께 보내면 bank_code가 우선합니다. (string)","example":"004"},"bank_name":{"type":"string","description":"은행의 표시 이름입니다. 예: 국민, 신한. bank_code 대신 사용할 수 있지만, 코드가 더 정확하므로 가능하면 bank_code를 함께 보내세요. (string)"}},"required":["account_num"]}}}}}}},"x-code-tables":[{"title":"오류 응답","columns":["HTTP","data.error","원인·조치"],"rows":[["400","입력 항목이 잘못됐습니다.","account_num이 없거나, bank_code와 bank_name이 모두 없습니다."],["400","잘못된 은행명 또는 은행코드를 입력했습니다.","목록에 없는 코드나 은행명입니다. 은행코드 조회 API의 code·name 값을 그대로 쓰세요."],["400","존재하지 않거나 잘못된 형식의 계좌번호입니다.","해당 은행에 그 계좌가 없거나 자릿수가 맞지 않습니다. 고객에게 계좌번호와 은행을 다시 확인받으세요."],["424","알 수 없는 이유로 금융정보를 불러오지 못했습니다.","은행 점검 시간이거나 일시적인 실패입니다. 잠시 후 다시 요청하세요."]]}],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}