메인 콘텐츠로 건너뛰기
POST
curl
프로덕션에서는 계좌 확인이 나이지리아, 가나, 케냐에서 실행됩니다. 다른 국가는 code: country_not_covered와 함께 404로 응답하며 요금이 청구되지 않습니다. 지원 국가는 계속 늘어나며, 은행 인증 요금에서 현재 각 국가에서 제공하는 항목을 언제나 확인할 수 있습니다.
백엔드에서 이름과 계좌를 보내고 결과를 읽으면 됩니다. 이는 사람 없이 진행하는 은행 인증 단계의 계좌 확인입니다.

국가별 형식에 맞춰 계좌 정보 보내기

일부 국가는 bic를 요구하며, 법인 계좌의 경우 registration_id를 요구하기도 합니다. 공백, 하이픈, 점은 무시됩니다. 해당 국가의 확인에 필요한 키를 보내지 않으면 누락된 키를 명시한 400 응답이 반환됩니다. 예: "field": "account.bank_code", "reason": "required". 개인 계좌를 확인하려면 holder.full_name을, 법인 계좌를 확인하려면 holder.business_name을 보내십시오.

계좌 소유자의 동의 보내기

일부 국가에서는 계좌 확인을 실행하기 전에 계좌 소유자의 명시적인 동의가 필요합니다. 제품에서 동의를 받은 후 "consent": true를 보내십시오. 동의 없이 해당 국가에서 확인을 요청하면 400(field: consent, reason: required)으로 거부되며 요금이 청구되지 않습니다. 그 밖의 국가에서는 consent가 선택 사항이며, 보내면 Didit이 확인 요금과 함께 이를 기록합니다. 샌드박스 키는 라이브 키와 같은 국가에서 동의를 요구합니다.

결과 확인하기

요금 청구와 재시도

은행이 응답한 각 확인은 결과와 관계없이 계좌 소속 국가의 계좌 확인 요금으로 한 번 청구됩니다. 오류로 응답한 요청은 절대 청구되지 않습니다. 여기에는 거부된 요청 본문(400), 크레딧 없음(402), 아직 확인을 지원하지 않는 계좌(404), 응답할 수 없는 은행(503)이 포함됩니다. 확인 결과를 다시 조회하는 엔드포인트는 없으며, 멱등성 키도 지원하지 않습니다. 재시도한 요청은 새로운 request_id로 새 확인을 실행하고 다시 청구되므로, 응답을 반드시 저장하십시오. Didit은 요금, 요청 ID, 국가, 결과 및 마스킹된 계좌 정보만 저장하며, 이름이나 전체 계좌 번호는 저장하지 않습니다.

샌드박스에서 테스트하기

샌드박스 API 키는 은행을 호출하지 않으며 요금도 청구되지 않습니다. IBAN의 마지막 4개 문자, IBAN이 없으면 계좌 번호의 마지막 4개 문자에 따라 응답이 결정됩니다. IBAN, CLABE, CBU에는 검증 숫자가 포함되어 있습니다. 모든 형식 검사를 통과하는 샌드박스 값을 사용하십시오.

접근

애플리케이션의 x-api-key나 클라이언트 자격 증명 베어러 토큰으로 인증하십시오. 범위가 지정된 API 키에는 세션에 대한 쓰기 권한이 필요합니다. 이 엔드포인트는 API 키당 분당 300건의 쓰기 한도를 다른 쓰기 엔드포인트와 공유합니다.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json
country
string
필수

ISO 3166-1 alpha-3 코드 형식의 계정 국가입니다(예: NGA). 소문자도 허용됩니다.

Required string length: 3
예시:

"NGA"

account
object
필수

해당 국가의 표기 방식에 따른 계좌입니다: iban 또는 해당 국가에 필요한 은행 또는 지점 코드(sort_code, routing_number, transit_institution, bsb, ifsc, bank_code 또는 bic)가 포함된 account_number입니다. 멕시코는 clabe, 아르헨티나는 cbu_cvu를 사용하며 은행을 이미 식별합니다. 기업 계좌의 경우 국가에서 요구하면 registration_id를 추가합니다. 공백, 대시 및 마침표는 무시됩니다. 해당 국가의 검증에 사용되지 않는 키는 무시되며, 필요한 키가 제공되지 않으면 해당 키를 명시하는 400이 반환됩니다.

예시:
holder
object
필수

계좌 확인 대상 이름입니다. full_name과 business_name 중 정확히 하나만 전송하세요.

vendor_data
string | null

이 검사에 대한 귀하 고유의 참조값이며, 변경 없이 반환됩니다.

예시:

"payout_20481"

계좌 명의인이 이 검사에 명시적으로 동의한 경우 true로 설정합니다. 해당 동의가 필요한 계좌 검사 국가에서는 필수 항목입니다. 동의가 없으면 field가 consent이고 reason이 required인 400 오류와 함께 검사가 거부되며 요금이 청구되지 않습니다. 그 외 지역에서는 선택 사항이며, 전송 시 Didit이 검사 요금 청구와 함께 이를 기록합니다.

예시:

true

응답

은행이 응답했습니다. 결과와 관계없이 확인 비용이 청구됩니다.

request_id
string<uuid>
필수

이 검사의 ID입니다.

result
enum<string>
필수

match: 은행에서 보낸 이름으로 계좌를 보유하고 있습니다. close_match: 유사한 이름(예: 중간 이름 누락 또는 오타)으로 보유하고 있습니다. no_match: 다른 이름으로 보유하고 있거나 해당 계좌가 존재하지 않습니다. cannot_verify: 은행이 이름을 비교하지 않고 응답했습니다(예: 차단되었거나 해지된 계좌).

사용 가능한 옵션:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
필수

close_match인 경우 및 은행이 이를 반환한 경우에만 해당합니다: 은행에 보관된 계좌의 예금주명입니다. 그렇지 않으면 null입니다.

account
string
필수

마지막 4자리를 제외하고 마스킹된 계좌입니다.

vendor_data
string | null
필수

전송하신 그대로의 귀하 고유 참조값입니다.

created_at
string<date-time>
필수

검사가 실행된 시점(UTC)입니다.

마지막 수정일 2026년 11월 7일