{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/en-US/guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["code-group"]},"type":"markdown"},"seo":{"title":"KYC Requirements","description":"Documentação oficial da API da plataforma de crédito embarcado Dinie. Integre produtos de crédito diretamente na sua aplicação.","siteUrl":"https://docs.dinie.com","lang":"pt-BR","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"kyc-requirements","__idx":0},"children":["KYC Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Understand the document types and verifications each customer needs to complete in order to be approved."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verification-flow","__idx":1},"children":["Verification Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a customer reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending_kyc"]}," status, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.kyc"]}," array lists all required documents and verifications. The verification flow works in two steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Early upload via API (optional):"]}," the partner uploads documents they already have for the customer (identity, proof of address, company documents, etc.) through the API. This speeds up the process because those documents will already be ready when the customer starts the biometrics session."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Biometrics session (required):"]}," the partner generates a session URL and presents it to the customer. In the session, the customer submits remaining documents, takes a selfie, and confirms the submission. The confirmation is what triggers the evaluation of all documents."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The selfie can only be captured by the customer in the biometrics session."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Info:"]}," The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]}," array is only available from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending_kyc"]}," status onward. During the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creating"]}," status, co-owner enrichment is still in progress and requirements have not been resolved yet."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirement-structure","__idx":2},"children":["Requirement Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All requirements share the same base structure:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"requirement_id\": \"identity_12345678900\",\n  \"requirement_type\": \"identity\",\n  \"label\": \"Documento de identidade\",\n  \"mandatory\": true,\n  \"subject\": {\n    \"name\": \"Joao Silva\",\n    \"cpf\": \"12345678900\",\n    \"subject_type\": \"applicant\"\n  },\n  \"submitted\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requirement_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requirement identifier. Use this value when uploading documents."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requirement_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requirement type. Determines which evidence and attachments are accepted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Human-readable requirement name for display to the user."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mandatory"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", the requirement must be completed for the customer to proceed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person or company the requirement refers to. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for company-wide requirements."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submitted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submission state. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when no document has been submitted."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-vs-company-requirements","__idx":3},"children":["Person vs. Company Requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requirements can be tied to a person (partner or applicant) or to the company as a whole."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Person requirements include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]}," field with data about who must submit the document:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\"subject\": {\n  \"name\": \"Joao Silva\",\n  \"cpf\": \"12345678900\",\n  \"subject_type\": \"applicant\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject_type"]}," can be:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicant"]}," for the registration holder"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["co_owner"]}," for partners identified during enrichment"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Company requirements (such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_document"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["articles_of_association"]},") do not have a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},". They apply to the registered company."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"early-upload-via-api","__idx":4},"children":["Early Upload via API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the partner already has the customer's documents, they can upload them through the API before the biometrics session. Documents uploaded early do not need to be submitted again in the session."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v3/customers/{customer_id}/kyc-attachments"]}," endpoint accepts individual uploads per requirement. Each upload requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requirement_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]},", and the file."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tip:"]}," Early upload is optional, but reduces what the customer needs to do in the biometrics session. The more documents the partner uploads, the faster the customer completes verification."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirement-types","__idx":5},"children":["Requirement Types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"identity---identity-document","__idx":6},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]}," - Identity Document"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Photo identity document for a person (applicant or co-owner). Accepts CNH or RG as evidence."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CNH"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type: \"cnh\""]},"): accepts two submission forms."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Physical CNH (front and back):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Front"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["front"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Back"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["back"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Digital CNH (single file):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["RG"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type: \"rg\""]},"):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Front"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["front"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Back"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["back"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"import fs from \"fs\";\n\n// Physical CNH - upload front and back\nawait client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"identity_12345678900\",\n  evidenceType: \"cnh\",\n  attachmentType: \"front\",\n  file: fs.createReadStream(\"/path/to/cnh-front.jpg\"),\n});\n\nawait client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"identity_12345678900\",\n  evidenceType: \"cnh\",\n  attachmentType: \"back\",\n  file: fs.createReadStream(\"/path/to/cnh-back.jpg\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"# Physical CNH - upload front and back\nclient.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"identity_12345678900\",\n  evidence_type: \"cnh\",\n  attachment_type: \"front\",\n  file: File.open(\"/path/to/cnh-front.jpg\")\n)\n\nclient.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"identity_12345678900\",\n  evidence_type: \"cnh\",\n  attachment_type: \"back\",\n  file: File.open(\"/path/to/cnh-back.jpg\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"# Physical CNH - upload front and back\nclient.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"identity_12345678900\",\n    evidence_type=\"cnh\",\n    attachment_type=\"front\",\n    file=open(\"/path/to/cnh-front.jpg\", \"rb\"),\n)\n\nclient.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"identity_12345678900\",\n    evidence_type=\"cnh\",\n    attachment_type=\"back\",\n    file=open(\"/path/to/cnh-back.jpg\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"# Physical CNH - front\ncurl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=identity_12345678900\" \\\n  -F \"evidence_type=cnh\" \\\n  -F \"attachment_type=front\" \\\n  -F \"file=@/path/to/cnh-front.jpg\"\n\n# Physical CNH - back\ncurl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=identity_12345678900\" \\\n  -F \"evidence_type=cnh\" \\\n  -F \"attachment_type=back\" \\\n  -F \"file=@/path/to/cnh-back.jpg\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tip:"]}," The digital CNH is uploaded as a single PDF file, no need to separate front and back."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"selfie---selfie","__idx":7},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selfie"]}," - Selfie"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Photo of the person's face for biometric validation. Always tied to a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Photo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["photo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warning:"]}," The selfie can only be captured by the customer in the biometrics session. It cannot be uploaded through the API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"proof_of_address---proof-of-address","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof_of_address"]}," - Proof of Address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Proof of address for the person. Always tied to a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"proof_of_address_12345678900\",\n  evidenceType: \"proof_of_address\",\n  attachmentType: \"file\",\n  file: fs.createReadStream(\"/path/to/proof-of-address.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"proof_of_address_12345678900\",\n  evidence_type: \"proof_of_address\",\n  attachment_type: \"file\",\n  file: File.open(\"/path/to/proof-of-address.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"proof_of_address_12345678900\",\n    evidence_type=\"proof_of_address\",\n    attachment_type=\"file\",\n    file=open(\"/path/to/proof-of-address.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=proof_of_address_12345678900\" \\\n  -F \"evidence_type=proof_of_address\" \\\n  -F \"attachment_type=file\" \\\n  -F \"file=@/path/to/proof-of-address.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"company_document---company-document","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_document"]}," - Company Document"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Company incorporation document. No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},", applies to the registered company."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ccmei"]}," (Certificado da Condição de Microempreendedor Individual)."]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"company_document\",\n  evidenceType: \"ccmei\",\n  attachmentType: \"file\",\n  file: fs.createReadStream(\"/path/to/ccmei.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"company_document\",\n  evidence_type: \"ccmei\",\n  attachment_type: \"file\",\n  file: File.open(\"/path/to/ccmei.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"company_document\",\n    evidence_type=\"ccmei\",\n    attachment_type=\"file\",\n    file=open(\"/path/to/ccmei.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=company_document\" \\\n  -F \"evidence_type=ccmei\" \\\n  -F \"attachment_type=file\" \\\n  -F \"file=@/path/to/ccmei.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ei_mei_documents---eimei-documents","__idx":10},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_mei_documents"]}," - EI/MEI Documents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Composite requirement that requires two documents: the EI registration and the CCMEI. Both must be submitted. No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EI Registration"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_registration_requirement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CCMEI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ccmei"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type"]}," for both is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_mei"]},"."]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"// EI Registration\nawait client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"ei_mei_documents\",\n  evidenceType: \"ei_mei\",\n  attachmentType: \"ei_registration_requirement\",\n  file: fs.createReadStream(\"/path/to/ei-registration.pdf\"),\n});\n\n// CCMEI\nawait client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"ei_mei_documents\",\n  evidenceType: \"ei_mei\",\n  attachmentType: \"ccmei\",\n  file: fs.createReadStream(\"/path/to/ccmei.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"# EI Registration\nclient.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"ei_mei_documents\",\n  evidence_type: \"ei_mei\",\n  attachment_type: \"ei_registration_requirement\",\n  file: File.open(\"/path/to/ei-registration.pdf\")\n)\n\n# CCMEI\nclient.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"ei_mei_documents\",\n  evidence_type: \"ei_mei\",\n  attachment_type: \"ccmei\",\n  file: File.open(\"/path/to/ccmei.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"# EI Registration\nclient.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"ei_mei_documents\",\n    evidence_type=\"ei_mei\",\n    attachment_type=\"ei_registration_requirement\",\n    file=open(\"/path/to/ei-registration.pdf\", \"rb\"),\n)\n\n# CCMEI\nclient.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"ei_mei_documents\",\n    evidence_type=\"ei_mei\",\n    attachment_type=\"ccmei\",\n    file=open(\"/path/to/ccmei.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"# EI Registration\ncurl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=ei_mei_documents\" \\\n  -F \"evidence_type=ei_mei\" \\\n  -F \"attachment_type=ei_registration_requirement\" \\\n  -F \"file=@/path/to/ei-registration.pdf\"\n\n# CCMEI\ncurl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=ei_mei_documents\" \\\n  -F \"evidence_type=ei_mei\" \\\n  -F \"attachment_type=ccmei\" \\\n  -F \"file=@/path/to/ccmei.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"income_statement---income-statement","__idx":11},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["income_statement"]}," - Income Statement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Company income statement. No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"income_statement\",\n  evidenceType: \"income_statement\",\n  attachmentType: \"file\",\n  file: fs.createReadStream(\"/path/to/income-statement.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"income_statement\",\n  evidence_type: \"income_statement\",\n  attachment_type: \"file\",\n  file: File.open(\"/path/to/income-statement.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"income_statement\",\n    evidence_type=\"income_statement\",\n    attachment_type=\"file\",\n    file=open(\"/path/to/income-statement.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=income_statement\" \\\n  -F \"evidence_type=income_statement\" \\\n  -F \"attachment_type=file\" \\\n  -F \"file=@/path/to/income-statement.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"articles_of_association---articles-of-association","__idx":12},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["articles_of_association"]}," - Articles of Association"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Company's articles of association or equivalent document. No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"articles_of_association\",\n  evidenceType: \"articles_of_association\",\n  attachmentType: \"file\",\n  file: fs.createReadStream(\"/path/to/articles-of-association.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"articles_of_association\",\n  evidence_type: \"articles_of_association\",\n  attachment_type: \"file\",\n  file: File.open(\"/path/to/articles-of-association.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"articles_of_association\",\n    evidence_type=\"articles_of_association\",\n    attachment_type=\"file\",\n    file=open(\"/path/to/articles-of-association.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=articles_of_association\" \\\n  -F \"evidence_type=articles_of_association\" \\\n  -F \"attachment_type=file\" \\\n  -F \"file=@/path/to/articles-of-association.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"eireli_incorporation_statement---eireli-incorporation-statement","__idx":13},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eireli_incorporation_statement"]}," - EIRELI Incorporation Statement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incorporation statement for an Empresa Individual de Responsabilidade Limitada. No ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachment"},"children":["Attachment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"attachment_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attachment_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["File"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"eireli_incorporation_statement\",\n  evidenceType: \"eireli_incorporation_statement\",\n  attachmentType: \"file\",\n  file: fs.createReadStream(\"/path/to/incorporation-statement.pdf\"),\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"eireli_incorporation_statement\",\n  evidence_type: \"eireli_incorporation_statement\",\n  attachment_type: \"file\",\n  file: File.open(\"/path/to/incorporation-statement.pdf\")\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"eireli_incorporation_statement\",\n    evidence_type=\"eireli_incorporation_statement\",\n    attachment_type=\"file\",\n    file=open(\"/path/to/incorporation-statement.pdf\", \"rb\"),\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=eireli_incorporation_statement\" \\\n  -F \"evidence_type=eireli_incorporation_statement\" \\\n  -F \"attachment_type=file\" \\\n  -F \"file=@/path/to/incorporation-statement.pdf\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"email---co-owner-email","__idx":14},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," - Co-owner Email"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Person-level requirement for collecting the email address of co-owners who need to digitally sign the CCB. Each co-owner generates an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email_{cpf}"]}," requirement with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subject"]}," field identifying the person."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The primary applicant's email is provided during customer creation. This requirement only appears for co-owners who need to sign the CCB."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submission is done via the KYC attachment upload endpoint, using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}," field instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]},":"]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"await client.customers.uploadKycAttachment(customer.id, {\n  requirementId: \"email_12345678900\",\n  evidenceType: \"email\",\n  attachmentType: \"email\",\n  value: \"co-owner@example.com\",\n});\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n  customer.id,\n  requirement_id: \"email_12345678900\",\n  evidence_type: \"email\",\n  attachment_type: \"email\",\n  value: \"co-owner@example.com\"\n)\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"client.customers.upload_kyc_attachment(\n    customer.id,\n    requirement_id=\"email_12345678900\",\n    evidence_type=\"email\",\n    attachment_type=\"email\",\n    value=\"co-owner@example.com\",\n)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/kyc-attachments\" \\\n  -H \"Authorization: Bearer dinie_at_...\" \\\n  -F \"requirement_id=email_12345678900\" \\\n  -F \"evidence_type=email\" \\\n  -F \"attachment_type=email\" \\\n  -F \"value=co-owner@example.com\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"biometrics-session","__idx":15},"children":["Biometrics Session"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After uploading the documents they already have (or even without uploading any), the partner must generate a biometrics session and present the URL to the customer. In the session, the customer submits remaining documents, captures the selfie, and confirms the submission."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The confirmation in the biometrics session triggers the evaluation of all documents, including those uploaded early via the API."]},{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"tabs"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","data-title":"Node.js","header":{"title":"Node.js","controls":{"copy":{}}},"source":"const session = await client.customers.createBiometricsSession(customer.id);\n\n// Present this URL to the customer\nconsole.log(session.session_url);\nconsole.log(session.expires_at);  // Expires in 30 minutes\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","data-title":"Ruby","header":{"title":"Ruby","controls":{"copy":{}}},"source":"session = client.customers.create_biometrics_session(customer.id)\n\n# Present this URL to the customer\nputs session.session_url\nputs session.expires_at  # Expires in 30 minutes\n","lang":"ruby"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"session = client.customers.create_biometrics_session(customer.id)\n\n# Present this URL to the customer\nprint(session.session_url)\nprint(session.expires_at)  # Expires in 30 minutes\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X POST \"https://sandbox.api.dinie.com.br/v3/customers/${CUSTOMER_ID}/biometrics\" \\\n  -H \"Authorization: Bearer dinie_at_...\"\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Info:"]}," The biometrics session expires in 30 minutes. Generate a new session if it times out."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"review-status","__idx":16},"children":["Review Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After confirmation in the biometrics session, each requirement goes through review. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submitted.review_status"]}," field indicates the outcome:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Document submitted, awaiting review"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accepted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Document approved"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Document rejected. Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["review_reason"]}," for details"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a document is rejected, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submitted.review_reason"]}," field contains the reason. Upload a new document for the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requirement_id"]}," to replace the previous one."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tracking-progress","__idx":17},"children":["Tracking Progress"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.kyc_updated"]}," webhook fires whenever a document is successfully submitted. The payload includes the updated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]}," array with the state of all requirements."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When all mandatory requirements are accepted, the customer status advances to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["under_review"]}," and then to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-reference","__idx":18},"children":["Quick Reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"evidence_type"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evidence_type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attachments"},"children":["Attachments"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Formats"},"children":["Formats"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Subject"},"children":["Subject"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"API Upload"},"children":["API Upload"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cnh"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["front"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["back"]}," (physical) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}," (digital)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG or PDF"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rg"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["front"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["back"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selfie"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selfie"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["photo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Biometrics only"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof_of_address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proof_of_address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["company_document"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ccmei"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_mei_documents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_mei"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ei_registration_requirement"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ccmei"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["income_statement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["income_statement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["articles_of_association"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["articles_of_association"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eireli_incorporation_statement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eireli_incorporation_statement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PDF, JPEG, PNG"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["text (value)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Person"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":19},"children":["Related Guides"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en-us/guides/customer-registration"},"children":["Registration and Offers"]}," for the full onboarding flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/en-us/apis/concepts/webhooks"},"children":["Webhooks"]}," to configure notification endpoints"]}]}]},"headings":[{"value":"KYC Requirements","id":"kyc-requirements","depth":1},{"value":"Verification Flow","id":"verification-flow","depth":2},{"value":"Requirement Structure","id":"requirement-structure","depth":2},{"value":"Person vs. Company Requirements","id":"person-vs-company-requirements","depth":2},{"value":"Early Upload via API","id":"early-upload-via-api","depth":2},{"value":"Requirement Types","id":"requirement-types","depth":2},{"value":"identity - Identity Document","id":"identity---identity-document","depth":3},{"value":"selfie - Selfie","id":"selfie---selfie","depth":3},{"value":"proof_of_address - Proof of Address","id":"proof_of_address---proof-of-address","depth":3},{"value":"company_document - Company Document","id":"company_document---company-document","depth":3},{"value":"ei_mei_documents - EI/MEI Documents","id":"ei_mei_documents---eimei-documents","depth":3},{"value":"income_statement - Income Statement","id":"income_statement---income-statement","depth":3},{"value":"articles_of_association - Articles of Association","id":"articles_of_association---articles-of-association","depth":3},{"value":"eireli_incorporation_statement - EIRELI Incorporation Statement","id":"eireli_incorporation_statement---eireli-incorporation-statement","depth":3},{"value":"email - Co-owner Email","id":"email---co-owner-email","depth":3},{"value":"Biometrics Session","id":"biometrics-session","depth":2},{"value":"Review Status","id":"review-status","depth":2},{"value":"Tracking Progress","id":"tracking-progress","depth":2},{"value":"Quick Reference","id":"quick-reference","depth":2},{"value":"Related Guides","id":"related-guides","depth":2}],"frontmatter":{"seo":{"title":"KYC Requirements"}},"lastModified":"2026-03-19T21:33:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/en-us/guides/kyc-requirements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}