--- title: 프로세스 생성 description: 검증 프로세스를 생성합니다. 사용자를 Unico가 호스팅하는 캡처 경험으로 이동시키는 여정 URL과 SDK 토큰을 반환합니다. canonical: https://developer.unico.io/ko/developers/api-reference/post-processes locale: ko generated_by: markdown-export --- - [/ko/](/ko/) - API 레퍼런스 - 프로세스 생성 **이 페이지에서# 프로세스 생성 이것은 모든 Unico API 통합의 진입점입니다. 백엔드가 이를 호출하여 프로세스를 생성하고, 프론트엔드는 반환된 토큰을 사용하여 iFrame을 렌더링하거나 사용자를 리디렉션하거나 네이티브 SDK를 초기화합니다. 전체 통합 플로우는 [플로우](/ko/developers/start/flows)를 참조하세요. ### Endpoint​ 환경URL**프로덕션**`POST https://api.idcloud.unico.app/client/v1/process`**샌드박스**`POST https://api.idcloud.uat.unico.app/client/v1/process` ### 요청​ 헤더 헤더값`Authorization``Bearer `([인증](/ko/developers/start/authentication) 참조)`Content-Type``application/json` 본문 매개변수 필드 요구사항은 flow에 따라 다릅니다필드가 필수인지, 선택인지, 해당되지 않는지는 통합하는 `flow`에 따라 다릅니다 — 이 표만으로 필드의 요구사항을 단정하기 전에, 사용 중인 특정 레시피에 대해 [플로우](/ko/developers/start/flows)를 확인하세요. 필드유형설명`callbackUri`string여정이 끝난 후 사용자가 리디렉션되는 URL입니다. 콜백이 앱 내부에서 처리되는 네이티브 SDK flow의 경우 `/`를 사용하세요.`flow`stringflow 식별자입니다 — 실행될 기능을 결정합니다. 예: `idunicodocs`, `idunicosign`, `idchecktrust`, `idtoken`, `idsmart`. [사용 가능한 플로우](/ko/developers/start/flows)를 참조하세요.`purpose`string비즈니스 목적입니다. 허용되는 값: `creditprocess`, `biometryonboarding`, `carpurchase`, `ageverification`.`person.duiType`enum문서 유형입니다. 아래의 [`duiType` 값](#duitype-values)을 참조하세요.`person.duiValue`string형식 없는 문서 번호입니다.`person.friendlyName`string여정 UI에 표시되는 사용자의 표시 이름입니다. 최대 50자.`person.phone`string구분자 없는 DDI + DDD + 번호 형식의 전화번호입니다. SMS 또는 WhatsApp으로 알림을 보낼 때 필수입니다.`person.email`string이메일 주소입니다. 전자서명이 포함된 flow에서는 필수입니다.`person.​notifications`array여정 링크를 전송할 알림 채널입니다. 각 항목은 `NOTIFICATION_CHANNEL_WHATSAPP`, `NOTIFICATION_CHANNEL_SMS`, 또는 `NOTIFICATION_CHANNEL_EMAIL` 값을 가진 `notificationChannel`을 포함합니다.`references`array1:1 검증 및 스마트 재검증 flow를 위한 참조 입력입니다. 각 항목은 `referenceType`(`REFERENCE_TYPE_IMAGE_BASE64` 또는 `REFERENCE_TYPE_PROCESS_ID`)과 `referenceContent`(base64로 인코딩된 이미지 또는 프로세스 UUID)를 포함합니다. 항목은 최대 1개까지만 전송하세요 — 더 긴 배열은 `400`으로 거부되며, `referenceContent`는 비어 있으면 안 됩니다.`useCase`string스마트 재검증 시나리오입니다. 🇧🇷 `idsmart`, `idsmart_r2`, `idsmart_tp1`에서 필수입니다. 예: `USE_CASE_LOGIN`, `USE_CASE_FIN_TRANSACTIONS`.`clientReference`string귀사 시스템 내 사용자의 고유 식별자입니다. **[다중 계정](/ko/capabilities/multi-accounts) 기능에는 필수입니다.** 귀사 기준으로 고유해야 하며, 최대 256자, 공백 없음.`companyBranchId`string (UUID)지점 ID입니다. 서비스 계정에 연결된 지점이 두 개 이상인 경우에만 필수입니다.`expiresIn`string생성 시점부터의 프로세스 유효 기간입니다. 형식: `"3600s"`. 생략하면 기본값은 7일입니다.`flowConfig`objectflow별 설정 오버라이드입니다.`flowConfig.​biometryCapture.​enabledBackCamera`boolean기기의 후면 카메라를 사용합니다. 문서 캡처 또는 전자서명 flow와는 호환되지 않습니다.`contextualization`object캡처를 설명하기 위해 여정 중 사용자에게 표시되는 거래 컨텍스트입니다. 특정 국가에 국한되지 않고 모든 지역의 고객이 사용할 수 있습니다.`contextualization.​company_name`string여정 중 표시되는 회사 이름입니다. 최대 20자.`contextualization.​currency`string사용자에게 표시되는 통화 코드입니다. 허용되는 값: `BRL`, `MXN`, `USD`.`contextualization.​price`number사용자에게 표시되는 거래 금액입니다.`contextualization.​locale`object여정 중 표시되는 현지화된 텍스트입니다. 키: `ptBr`, `enUs`, `esMx` — 고객의 지역과 관계없이 텍스트에 지원되는 언어는 이것뿐입니다.`contextualization.locale.{ptBr|enUs|esMx}.reason`string여정 중 표시되는 캡처에 대한 짧은 이유입니다. 최대 50자.`contextualization.locale.{ptBr|enUs|esMx}.title`string여정 중 표시되는 고객 안내문의 제목입니다. 최대 100자. `text`와 함께 제공해야 합니다. HTML 태그는 제거됩니다.`contextualization.locale.{ptBr|enUs|esMx}.text`string여정 중 표시되는 고객 안내문의 본문입니다. 최대 210자. `title`과 함께 제공해야 합니다. HTML 태그는 제거됩니다.`imageBase64`string직접 전송되는 셀피입니다. SDK의 캡처 JWT를 받습니다.`document.purpose`enum문서의 용도입니다. 고정된 값: `DOCUMENT_PURPOSE_ONBOARDING`, `DOCUMENT_PURPOSE_CREDIT_PROCESS`, `DOCUMENT_PURPOSE_CAR_PURCHASE`, `DOCUMENT_PURPOSE_PAY_BY_PAYCHECK`, `DOCUMENT_PURPOSE_FGTS`. Face Document Match flow에서만 사용됩니다.`document.​files[].​data`bytes새로운 문서 캡처로, base64로 인코딩됩니다. 브라질에 국한되지 않고 전 세계적으로 사용 가능합니다. `document.documentId`와는 상호 배타적입니다.`document.documentId`string (UUID)새로운 캡처 대신 동일한 사용자가 이미 캡처한 문서를 재사용합니다. `document.files[]`와는 상호 배타적입니다.`expectedResult`object테스트/샌드박스 환경에서 기능의 결과를 모의(mock)하고 응답에 `simulated: true`를 표시합니다. [결과 시뮬레이션(Test Mock)](/ko/developers/start/test-mock)을 참조하세요. **`duiType` 값**국가값설명AR`DUI_TYPE_AR_PASSPORT`아르헨티나 여권AR`DUI_TYPE_AR_DNI`아르헨티나 DNIAR`DUI_TYPE_AR_LNC`아르헨티나 운전면허증(Licencia Nacional de Conducir)AT`DUI_TYPE_AT_STNR`오스트리아 납세자 번호(STNR)BE`DUI_TYPE_BE_NN`벨기에 국민 번호(NN)BR`DUI_TYPE_BR_CPF`브라질 CPFBR`DUI_TYPE_BR_PASSPORT`브라질 여권BR`DUI_TYPE_BR_CNPJ`브라질 CNPJCA`DUI_TYPE_CA_SIN`캐나다 SINCH`DUI_TYPE_CH_AHV`스위스 AHV/AVS 번호CL`DUI_TYPE_CL_RUN`칠레 RUNCL`DUI_TYPE_CL_PASSPORT`칠레 여권CL`DUI_TYPE_CL_LICENCIA_CONDUCIR`칠레 운전면허증(Licencia de Conducir)CO`DUI_TYPE_CO_NIT`콜롬비아 NITCO`DUI_TYPE_CO_PASSPORT`콜롬비아 여권CO`DUI_TYPE_CO_LICENCIA_CONDUCCION`콜롬비아 운전면허증(Licencia de Conducción)CO`DUI_TYPE_CO_CC`콜롬비아 시민증(Cédula de Ciudadanía)DE`DUI_TYPE_DE_IDNR`독일 세무 식별 번호(IdNr)DK`DUI_TYPE_DK_CPR`덴마크 CPREC`DUI_TYPE_EC_NI`에콰도르 NIES`DUI_TYPE_ES_NIE`스페인 외국인 식별 번호(NIE)ES`DUI_TYPE_ES_DNI`스페인 국민 신분증(DNI)FI`DUI_TYPE_FI_HETU`핀란드 개인 식별 번호(HETU)FR`DUI_TYPE_FR_SPI`프랑스 세무 참조 번호(SPI)GB`DUI_TYPE_GB_NINO`영국 국민보험번호(NINO)GT`DUI_TYPE_GT_CUI`과테말라 CUIID`DUI_TYPE_ID_NIK`인도네시아 NIKIE`DUI_TYPE_IE_PPSN`아일랜드 개인 공공 서비스 번호(PPSN)IT`DUI_TYPE_IT_CF`이탈리아 세무 번호(CF)LK`DUI_TYPE_LK_NIC`스리랑카 NICLU`DUI_TYPE_LU_MATRICULE`룩셈부르크 국민 식별 번호(Matricule)MX`DUI_TYPE_MX_CURP`멕시코 CURPMX`DUI_TYPE_MX_RFC_PERSONA_FISICA`멕시코 RFC(개인)MX`DUI_TYPE_MX_LICENCIA_CONDUCIR`멕시코 운전면허증(Licencia de Conducir)NG`DUI_TYPE_NG_NIN`나이지리아 NINNG`DUI_TYPE_NG_BVN`나이지리아 은행 인증 번호(BVN)NG`DUI_TYPE_NG_BVN_TOKEN`나이지리아 BVN 토큰(해시)NG`DUI_TYPE_NG_NIN_TOKEN`나이지리아 NIN 토큰(해시)NL`DUI_TYPE_NL_BSN`네덜란드 시민 서비스 번호(BSN)NO`DUI_TYPE_NO_FNR`노르웨이 국민 식별 번호(Fødselsnummer)PE`DUI_TYPE_PE_RUC`페루 RUCPE`DUI_TYPE_PE_DNI`페루 DNIPE`DUI_TYPE_PE_PASSPORT`페루 여권PL`DUI_TYPE_PL_PESEL`폴란드 PESELPT`DUI_TYPE_PT_NIF`포르투갈 납세자 번호(NIF)SE`DUI_TYPE_SE_PNR`스웨덴 개인번호(PNR)SE`DUI_TYPE_SE_SAMORDNINGSNUMMER`스웨덴 조정 번호(Samordningsnummer)TR`DUI_TYPE_TR_TCKN`튀르키예 국민 식별 번호(TCKN)US`DUI_TYPE_US_SSN`미국 SSNUS`DUI_TYPE_US_PASSPORT`미국 여권US`DUI_TYPE_US_DRIVER_LICENSE`미국 운전면허증US`DUI_TYPE_US_PASSPORT_CARD`미국 여권 카드US`DUI_TYPE_US_POLYCARBONATE_PASSPORT`미국 폴리카보네이트 여권US`DUI_TYPE_US_ID_CARD`미국 ID 카드UY`DUI_TYPE_UY_CI`우루과이 CIZZ`DUI_TYPE_ZZ_EMAIL`이메일 주소ZZ`DUI_TYPE_ZZ_PHONE_NUMBER`전화번호 문서 없이 프로세스 생성하기flow가 선택적 문서를 허용하는 경우 `person.duiType`과 `person.duiValue`를 생략할 수 있습니다. 캡처 후 프로세스는 백엔드가 [프로세스 문서 설정](/ko/developers/api-reference/set-process-document)으로 문서를 전송할 때까지 `AWAITING_FOR_DOCUMENT` 상태로 대기합니다. ### 예제​ cURLNode.js``` curl -X POST https://api.idcloud.unico.app/client/v1/process \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "flow": "idunicodocs_r2", "purpose": "biometryonboarding", "clientReference": "pedido-88216", "callbackUri": "https://your-app.example.com/onboarding/callback", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" } }' ``` ``` import fetch from 'node-fetch';const res = await fetch('https://api.idcloud.unico.app/client/v1/process', { method: 'POST', headers: { Authorization: `Bearer ${process.env.UNICO_ACCESS_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ flow: 'idunicodocs_r2', purpose: 'biometryonboarding', clientReference: 'pedido-88216', callbackUri: 'https://your-app.example.com/onboarding/callback', person: { duiType: 'DUI_TYPE_BR_CPF', duiValue: '12345678909', }, }),});const { process: proc } = await res.json();// proc.userRedirectUrl, proc.token, proc.webAppToken ``` ### 응답​ 200 OK ``` { "process": { "id": "b7c1f0a2-63d4-4f3e-9a17-2c8e5d41b0aa", "flow": "idunicodocs_r2", "state": "PROCESS_STATE_CREATED", "result": "PROCESS_RESULT_UNSPECIFIED", "purpose": "biometryonboarding", "clientReference": "pedido-88216", "person": { "duiType": "DUI_TYPE_BR_CPF", "duiValue": "12345678909" }, "capacities": [ "PROCESS_CAPACITY_IDLIVE", "PROCESS_CAPACITY_IDUNICO", "PROCESS_CAPACITY_IDDOCS" ], "authenticationInfo": { "authenticationId": "" }, "companyData": { "branchId": "", "countryCode": "BRA" }, "callbackUri": "https://your-app.example.com/onboarding/callback", "userRedirectUrl": "https://cadastro.unico.app/flow?id=b7c1f0a2-63d4-4f3e-9a17-2c8e5d41b0aa", "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…", "webAppToken": "eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0…", "simulated": false }} ``` 필드유형설명`process.id`string (UUID)프로세스 식별자입니다. [프로세스 조회](/ko/developers/api-reference/get-process)를 통해 결과를 가져오는 데 사용하세요.`process.state`enum`PROCESS_STATE_CREATED` — 프로세스가 생성되었으며 여정이 아직 시작되지 않았습니다. `PROCESS_STATE_FAILED` — 프로세스 생성에 실패했습니다.`process.result`enum검증 결과입니다. `state = PROCESS_STATE_FINISHED`인 경우에만 존재합니다 — 특정 flow가 반환할 수 있는 결과 값은 [플로우](/ko/developers/start/flows)를 참조하세요.`process.flow`string생성 시 전송된 flow 식별자입니다.`process.purpose`string생성 시 전송된 비즈니스 목적입니다.`process.callbackUri`string생성 시 전송된 콜백 URI입니다.`process.​clientReference`string생성 시 전송된 귀사의 내부 식별자입니다. 요청에 제공된 경우에만 존재합니다.`process.​companyBranchId`string (UUID)지점 ID입니다. 요청에 제공된 경우에만 존재합니다.`process.​userRedirectUrl`string사용자를 리디렉션할 URL입니다(Web Redirect 및 iFrame 통합). 이 URL을 수정하지 마세요.`process.token`string**Web SDK iFrame**을 초기화하기 위한 JWT입니다.`process.webAppToken`string**네이티브 SDK**(Android, iOS, Flutter)를 초기화하기 위한 JWT입니다.`process.createdAt`string (date-time)프로세스가 생성된 시각의 타임스탬프입니다.`process.expiresAt`string (date-time)이 시각 이후 프로세스가 만료되어 더 이상 완료할 수 없게 되는 타임스탬프입니다.`process.capacities`array이 프로세스에 설정된 기능입니다.`process.​authenticationInfo`object프로세스의 인증 정보입니다(생성 시점에는 비어 있습니다).`process.person`object생성 시 전송된 `person` 객체의 에코입니다.`process.​companyData.​branchId`string (UUID)프로세스와 연관된 지점 ID입니다.`process.​companyData.​countryCode`string지점과 연관된 국가 코드입니다(예: `BR`, `MX`). ### 오류 코드​ 400 Bad Request401 Unauthorized403 Forbidden404 Not Found429 Too Many Requests500 Internal Server Error코드메시지설명`3`invalid flow지정된 flow가 존재하지 않을 때.`3`invalid person: friendly name exceeds 50 characters.표시 이름이 50자를 초과할 때.`3`invalid purpose제공된 purpose가 유효하지 않을 때.`3`invalid callbackUri: unable to parse callbackUri: parse "": empty url, invalid callbackUri: url:제공된 callbackUri가 유효하지 않을 때.`3`invalid person: email required for notification channel NOTIFICATION_CHANNEL_EMAIL, invalid email address for notification channel NOTIFICATION_CHANNEL_EMAIL제공된 이메일이 유효하지 않고 이메일 알림이 설정되어 있을 때.`3`invalid person: phone number required for notification channel NOTIFICATION_CHANNEL_WHATSAPP, phone number does not contain 13 chars for notification channel NOTIFICATION_CHANNEL_WHATSAPP제공된 전화번호가 유효하지 않고 SMS 또는 WhatsApp 알림이 설정되어 있을 때.`3`idnsv2/GetPublicID request error: rpc error: code = InvalidArgument desc = invalid dui value제공된 식별자(duiValue)가 유효하지 않을 때.`3`invalid expiresIn argument`expiresIn` 값이 유효하지 않을 때.`3`invalid company_name argument in process contextualization, max length is 20`contextualization.​company_name`이 20자를 초과할 때.`3`title and text must be provided together in process contextslocale에서 `title` 또는 `text` 중 하나만 제공될 때.`3`invalid title argument in process contexts, max length is 100locale의 `title`이 100자를 초과할 때.`3`invalid text argument in process contexts, max length is 210locale의 `text`가 210자를 초과할 때.`3`invalid reason argument in process contexts, max length is 50locale의 `reason`이 50자를 초과할 때.`3`The references array must contain at most one element.`references`에 항목이 두 개 이상 전송될 때.`3`The references[].referenceContent field is missing.`referenceContent`가 비어 있을 때.`3`The references[].referenceType field must be IMAGE_BASE64 or PROCESS_ID.`referenceType`이 지원되는 값 중 하나가 아닐 때.`3`A reference is required for this flow.flow에서 참조가 필요하지만 전송되지 않았을 때. `referenceType`이 `PROCESS_ID` 또는 `IMAGE_BASE64`인 `references[0]`을 전송하세요.`9`The referenceProcessId field is invalid.참조 프로세스가 존재하지 않거나 재사용할 수 없을 때. 전송한 필드명을 알려줍니다 — 해당 필드를 보냈다면 `bioTokenId`.`3`INVALID_IMAGE이미지가 유효한 base64가 아니거나 인젝션 시도처럼 보일 때.`3`INVALID_DUI문서 번호가 표준이 아니거나 존재하지 않을 때.`3`IMAGE_TOO_LARGE이미지가 최대 크기인 800KB를 초과할 때.`3`UNSUPPORTED_IMAGE_FORMAT이미지 형식이 PNG, JPEG, WebP가 아닐 때.`3`MISSING_IMAGE이 flow에 이미지가 필수이지만 전송되지 않았을 때.`3`MISSING_NAME이 flow에 이름이 필수이지만 전송되지 않았을 때.`3`MISSING_DUI이 flow에 문서 번호가 필수이지만 전송되지 않았을 때.`3`MISSING_PERSON이 flow에 `person` 객체가 필수이지만 전송되지 않았을 때.`3`INVALID_REQUEST요청 본문이 null이거나 해석할 수 없을 때.`3`TOKEN_ALREADY_USED캡처 토큰이 이미 사용되었을 때. 이 토큰은 1회용입니다.`3`TOKEN_EXPIRED캡처 토큰이 만료되었을 때. 10분 이내에 사용해야 합니다.`3`INVALID_BUNDLE요청이 보안 요구사항을 충족하지 않을 때.`3`INVALID_NAME이름이 허용된 최대 길이를 초과할 때.`3`INVALID_EMAIL이메일 주소의 형식이 잘못되었거나 너무 길 때.`3`INVALID_PHONE전화번호가 20자를 초과할 때.`3`INVALID_DUI_TYPE문서 유형이 지원되는 값 중 하나가 아닐 때.`3`INVALID_CLIENT_REFERENCE`clientReference`가 너무 길거나 공백 또는 `#`을 포함할 때.`3`INVALID_CONSENT_TYPE`consentType`이 `NONE`, `DIRECT`, `INDIRECT` 중 하나가 아닐 때.`3`INVALID_USE_CASE`useCase`를 인식할 수 없거나 너무 길 때.`3`INVALID_DEVICE_TRUST_TOKENdevice-trust 토큰이 유효하지 않거나 이미 사용되었을 때.`3`TOO_MANY_REFERENCES`references`에 항목이 두 개 이상 전송될 때.`3`INVALID_REFERENCE_TYPE`referenceType`이 `IMAGE_BASE64` 또는 `PROCESS_ID`가 아닐 때.`3`INVALID_REFERENCE_PROCESS참조 프로세스 ID가 유효한 식별자가 아닐 때.`3`REFERENCE_PROCESS_NOT_FOUND참조된 프로세스가 존재하지 않을 때.`3`REFERENCE_PROCESS_NOT_READY참조된 프로세스에 재사용 가능한 결과가 없거나 이미 사용되었을 때.`3`REFERENCE_SELFIE_NOT_FOUND참조된 프로세스에 재사용할 셀피가 없을 때.`3`INVALID_CAPTURE_TOKEN캡처된 이미지가 캡처 SDK에서 생성한 유효한 토큰이 아닐 때.`3`INVALID_CAPTURE_SIGNATURE캡처 토큰의 서명이 검증되지 않을 때.`3`PRIOR_CAPTURE_NOT_FOUND이 요청이 기반으로 하는 이전 캡처를 찾을 수 없을 때. 프로세스를 다시 시작하세요.`3`PRIOR_CAPTURE_IN_PROGRESS이전 캡처가 아직 완료되지 않았을 때. 잠시 후 다시 시도하세요.`3`PRIOR_CAPTURE_FAILED이전 캡처를 완료할 수 없었을 때. 프로세스를 다시 시작하세요.`3`INVALID_DOCUMENT문서 파일을 읽을 수 없거나, 비밀번호로 보호되어 있거나, 지원되지 않는 형식일 때.`3`INVALID_AUTH_PROCESS`document.authProcessId`가 유효하지 않거나, 만료되었거나, 다른 사람에게 속할 때.`3`INVALID_DOCUMENT_PURPOSE`document.purpose`가 지원되는 값 중 하나가 아닐 때.`3`PROCESS_REUSE_NOT_ENABLEDflow가 이미지 없이 이전 프로세스를 재사용하는 것을 허용하지 않을 때. 대신 이미지를 전송하세요.`9`PROCESS_FAILED프로세스가 생성 중 종단 오류에 도달했을 때.`9`Tenant API key is not configuredAPI Key가 올바르게 설정되지 않았을 때.Bearer 토큰이 누락, 만료, 또는 유효하지 않습니다. [인증](/ko/developers/start/authentication)을 참조하세요.메시지설명Jwt header is an invalid JSON사용된 access token에 잘못된 문자가 포함되어 있을 때.Jwt is expired사용된 access token이 만료되었을 때.코드메시지설명`7`INVALID_API_KEYAPI key가 유효하지 않거나 누락되었을 때.`7`INVALID_AUTH_TOKEN인증 토큰이 유효하지 않을 때.`7`PERMISSION_DENIED자격 증명은 유효하지만 이 작업에 대한 권한이 없을 때.`7`TOKEN_TENANT_MISMATCH캡처 토큰이 다른 테넌트를 위해 발급되었을 때.`7`MISSING_ACCESS_TOKENauthorization 헤더가 누락되었을 때.코드메시지설명`5`NO_RESULTS_FOUND요청에서 참조한 문서를 찾을 수 없을 때.레이트 리밋에 도달했습니다. 시스템이 HTTP 429 오류를 수신하면 연쇄적인 장애를 방지하고 제한이 악화되지 않도록 메커니즘을 구현해야 합니다. **모범 사례:** **쿨다운 기간(backoff):** 시스템에서 후속 요청을 즉시 중지하거나 줄이세요. 실패한 요청을 촘촘한 루프에서 지속적으로 재시도하지 마세요. **큐잉 및 스로틀링(Queueing & throttling):** 재전송하기 전에 발신 요청을 버퍼링하거나 대기열에 넣어 트래픽 흐름을 제어하세요. **지터를 포함한 지수 백오프(Exponential backoff with jitter):** 재시도 시 시도 간 대기 시간을 기하급수적으로 늘리고(예: 1초, 2초, 4초, 8초) 작은 무작위 지연("지터")을 추가하여 대기열의 모든 요청이 정확히 같은 밀리초에 재시도하는 허드 효과를 방지하세요. 경고백오프 없이 레이트 리밋이 적용된 엔드포인트에 지속적으로 요청을 보내면 **제한 기간이 연장되고** 시스템의 운영 처리량에 심각한 영향을 미칠 수 있습니다. 요청을 적절히 스로틀링하면 더 원활하고 탄력적인 통합이 보장됩니다. 기본 제한, 요청 증가 및 추가 세부 정보는 [레이트 리밋](/ko/developers/start/rate-limits)을 참조하세요.코드메시지설명`13`Internal failure! Try again later내부 오류가 발생했을 때. ### 다음 단계​ 사용자가 여정을 완료한 후, [프로세스 조회](/ko/developers/api-reference/get-process)를 호출하여 결과를 가져오거나 [webhook](/ko/developers/webhooks-and-events)을 기다리세요. 모든 레시피 조합과 가능한 결과 값을 확인하려면 [플로우](/ko/developers/start/flows)를 참조하세요. 실제 생체 인식 캡처 없이 결과를 테스트하려면 [결과 시뮬레이션(Test Mock)](/ko/developers/start/test-mock)을 참조하세요. 마지막 업데이트 2026년 10월 8일**에