{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/pt-BR/products/payments_mexico/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","tabs","tab","split","img"]},"type":"markdown"},"seo":{"title":"Coletar consentimento com links de consentimento","description":"Belvo provides open finance products for Latin America that allow you to securely access and aggregate financial data as well as accept and issue bank-to-bank payments","siteUrl":"https://developers.belvo.com/","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":"coletar-consentimento-com-links-de-consentimento","__idx":0},"children":["Coletar consentimento com links de consentimento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um link de consentimento permite que você colete uma autorização de débito direto sem precisar construir sua própria interface de usuário. Você cria o link com uma chamada de API e envia a URL para o seu cliente. Seu cliente a abre no navegador, insere sua CLABE, revisa e aceita a autorização de débito direto, e a assina eletronicamente com um código que a Belvo deposita em sua conta."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando seu cliente termina, a Belvo criou um método de pagamento e um consentimento confirmado para ele. São os mesmos recursos que você criaria por conta própria com a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-direct-api-setup","target":"_blank"},"children":["API de Débito Direto"]},", permitindo que você envie solicitações de pagamento imediatamente."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Neste guia, você irá:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Criar um link de consentimento para um cliente existente, com os termos de pagamento que ele deve autorizar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compartilhar o link com seu cliente e ver o que ele faz no widget de link de consentimento."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Lidar com o redirecionamento de volta para sua aplicação."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ouvir os webhooks e confirmar o resultado."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Links de consentimento substituem duas etapas da API"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um link de consentimento substitui as etapas ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Criar um método de pagamento"]}," e ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Criar um consentimento"]}," do guia ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-direct-api-setup","target":"_blank"},"children":["Pagamentos por Débito Direto via API"]},". Você ainda cria o cliente com a API e ainda cria solicitações de pagamento com a API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pré-requisitos","__idx":1},"children":["Pré-requisitos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Antes de começar, certifique-se de:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-authentication-and-environments#api-keys-and-authentication","target":"_blank"},"children":["Gerar suas chaves de API."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/developer_resources/resources-webhooks-payments-mexico","target":"_blank"},"children":["Configurar um webhook para escutar eventos."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-idempotency-and-whitelisting","target":"_blank"},"children":["Configurar a Lista Branca de IPs."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Solicitar ao seu representante da Belvo para habilitar links de consentimento para sua conta. Os links de consentimento usam validação de centavos para entregar o código de assinatura, portanto, o consentimento de validação de centavos deve estar ativo para sua conta."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-direct-api-setup#create-a-customer","target":"_blank"},"children":["Criar um cliente"]}," para a pessoa que você deseja debitar. O widget mostra o nome do cliente e um RFC ou CURP mascarado deste registro, então certifique-se de que os dados estão corretos."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"visão-geral-do-fluxo-de-dados","__idx":2},"children":["Visão geral do fluxo de dados"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"sequenceDiagram\n    participant App as Your application\n    participant Customer as Customer\n    participant Widget as Consent link widget\n    participant Belvo as Belvo\n    participant Bank as Customer's bank\n\n    Note over App,Bank: 1. Create the consent link\n    App->>Belvo: POST /consents/links\n    Belvo-->>App: 201 - Created + id + consentLinkUrl\n\n    Note over App,Bank: 2. Share the link\n    App->>Customer: Send consentLinkUrl (SMS, email, WhatsApp, or redirect)\n    Customer->>Widget: Open consentLinkUrl\n\n    Note over App,Bank: 3. Customer completes the widget\n    Widget->>Belvo: Submit CLABE\n    Belvo->>Bank: Send a $0.01 MXN deposit with a code\n    Widget->>Belvo: Accept the authorization\n    Customer->>Widget: Enter the code from the deposit\n    Widget->>Belvo: Verify the code (electronic signature)\n    Belvo-->>Widget: Link completed\n\n    Note over App,Bank: 4. Confirm the result\n    Belvo->>App: WEBHOOK consent_confirmed (consentId, paymentMethodId)\n    Widget->>App: Redirect to callbackUrl?status=completed\n    App->>Belvo: GET /consents/links/{id}\n    Belvo-->>App: 200 + status completed\n","diagramHtml":"<div class=\"mermaid\" data-processed=\"true\"><svg id=\"mermaid-1790773753513\" width=\"100%\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" style=\"max-width: 1745px;\" viewBox=\"-50 -10 1745 1135\" role=\"graphics-document document\" aria-roledescription=\"sequence\"><g><rect x=\"1495\" y=\"1049\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Bank\" rx=\"3\" ry=\"3\" class=\"actor actor-bottom\"></rect><text x=\"1570\" y=\"1081.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"1570\" dy=\"0\">Customer's bank</tspan></text></g><g><rect x=\"1141\" y=\"1049\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Belvo\" rx=\"3\" ry=\"3\" class=\"actor actor-bottom\"></rect><text x=\"1216\" y=\"1081.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"1216\" dy=\"0\">Belvo</tspan></text></g><g><rect x=\"790\" y=\"1049\" fill=\"#eaeaea\" stroke=\"#666\" width=\"166\" height=\"65\" name=\"Widget\" rx=\"3\" ry=\"3\" class=\"actor actor-bottom\"></rect><text x=\"873\" y=\"1081.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"873\" dy=\"0\">Consent link widget</tspan></text></g><g><rect x=\"490\" y=\"1049\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Customer\" rx=\"3\" ry=\"3\" class=\"actor actor-bottom\"></rect><text x=\"565\" y=\"1081.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"565\" dy=\"0\">Customer</tspan></text></g><g><rect x=\"0\" y=\"1049\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"App\" rx=\"3\" ry=\"3\" class=\"actor actor-bottom\"></rect><text x=\"75\" y=\"1081.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"75\" dy=\"0\">Your application</tspan></text></g><g><line id=\"actor4\" x1=\"1570\" y1=\"65\" x2=\"1570\" y2=\"1049\" class=\"actor-line 200\" stroke-width=\"0.5px\" stroke=\"#999\" name=\"Bank\"></line><g id=\"root-4\"><rect x=\"1495\" y=\"0\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Bank\" rx=\"3\" ry=\"3\" class=\"actor actor-top\"></rect><text x=\"1570\" y=\"32.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"1570\" dy=\"0\">Customer's bank</tspan></text></g></g><g><line id=\"actor3\" x1=\"1216\" y1=\"65\" x2=\"1216\" y2=\"1049\" class=\"actor-line 200\" stroke-width=\"0.5px\" stroke=\"#999\" name=\"Belvo\"></line><g id=\"root-3\"><rect x=\"1141\" y=\"0\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Belvo\" rx=\"3\" ry=\"3\" class=\"actor actor-top\"></rect><text x=\"1216\" y=\"32.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"1216\" dy=\"0\">Belvo</tspan></text></g></g><g><line id=\"actor2\" x1=\"873\" y1=\"65\" x2=\"873\" y2=\"1049\" class=\"actor-line 200\" stroke-width=\"0.5px\" stroke=\"#999\" name=\"Widget\"></line><g id=\"root-2\"><rect x=\"790\" y=\"0\" fill=\"#eaeaea\" stroke=\"#666\" width=\"166\" height=\"65\" name=\"Widget\" rx=\"3\" ry=\"3\" class=\"actor actor-top\"></rect><text x=\"873\" y=\"32.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"873\" dy=\"0\">Consent link widget</tspan></text></g></g><g><line id=\"actor1\" x1=\"565\" y1=\"65\" x2=\"565\" y2=\"1049\" class=\"actor-line 200\" stroke-width=\"0.5px\" stroke=\"#999\" name=\"Customer\"></line><g id=\"root-1\"><rect x=\"490\" y=\"0\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"Customer\" rx=\"3\" ry=\"3\" class=\"actor actor-top\"></rect><text x=\"565\" y=\"32.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"565\" dy=\"0\">Customer</tspan></text></g></g><g><line id=\"actor0\" x1=\"75\" y1=\"65\" x2=\"75\" y2=\"1049\" class=\"actor-line 200\" stroke-width=\"0.5px\" stroke=\"#999\" name=\"App\"></line><g id=\"root-0\"><rect x=\"0\" y=\"0\" fill=\"#eaeaea\" stroke=\"#666\" width=\"150\" height=\"65\" name=\"App\" rx=\"3\" ry=\"3\" class=\"actor actor-top\"></rect><text x=\"75\" y=\"32.5\" dominant-baseline=\"central\" alignment-baseline=\"central\" class=\"actor actor-box\" style=\"text-anchor: middle; font-size: 16px; font-weight: 400;\"><tspan x=\"75\" dy=\"0\">Your application</tspan></text></g></g><style>#mermaid-1790773753513{font-family:\"trebuchet ms\",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-1790773753513 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-1790773753513 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-1790773753513 .error-icon{fill:#552222;}#mermaid-1790773753513 .error-text{fill:#552222;stroke:#552222;}#mermaid-1790773753513 .edge-thickness-normal{stroke-width:1px;}#mermaid-1790773753513 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-1790773753513 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-1790773753513 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-1790773753513 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-1790773753513 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-1790773753513 .marker{fill:#333333;stroke:#333333;}#mermaid-1790773753513 .marker.cross{stroke:#333333;}#mermaid-1790773753513 svg{font-family:\"trebuchet ms\",verdana,arial,sans-serif;font-size:16px;}#mermaid-1790773753513 p{margin:0;}#mermaid-1790773753513 .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-1790773753513 text.actor&gt;tspan{fill:black;stroke:none;}#mermaid-1790773753513 .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-1790773753513 .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-1790773753513 .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-1790773753513 .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-1790773753513 #arrowhead path{fill:#333;stroke:#333;}#mermaid-1790773753513 .sequenceNumber{fill:white;}#mermaid-1790773753513 #sequencenumber{fill:#333;}#mermaid-1790773753513 #crosshead path{fill:#333;stroke:#333;}#mermaid-1790773753513 .messageText{fill:#333;stroke:none;}#mermaid-1790773753513 .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-1790773753513 .labelText,#mermaid-1790773753513 .labelText&gt;tspan{fill:black;stroke:none;}#mermaid-1790773753513 .loopText,#mermaid-1790773753513 .loopText&gt;tspan{fill:black;stroke:none;}#mermaid-1790773753513 .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-1790773753513 .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-1790773753513 .noteText,#mermaid-1790773753513 .noteText&gt;tspan{fill:black;stroke:none;}#mermaid-1790773753513 .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-1790773753513 .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-1790773753513 .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-1790773753513 .actorPopupMenu{position:absolute;}#mermaid-1790773753513 .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-1790773753513 .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-1790773753513 .actor-man circle,#mermaid-1790773753513 line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-1790773753513 :root{--mermaid-font-family:\"trebuchet ms\",verdana,arial,sans-serif;}</style><g></g><defs><symbol id=\"computer\" width=\"24\" height=\"24\"><path transform=\"scale(.5)\" d=\"M2 2v13h20v-13h-20zm18 11h-16v-9h16v9zm-10.228 6l.466-1h3.524l.467 1h-4.457zm14.228 3h-24l2-6h2.104l-1.33 4h18.45l-1.297-4h2.073l2 6zm-5-10h-14v-7h14v7z\"></path></symbol></defs><defs><symbol id=\"database\" fill-rule=\"evenodd\" clip-rule=\"evenodd\"><path transform=\"scale(.5)\" d=\"M12.258.001l.256.004.255.005.253.008.251.01.249.012.247.015.246.016.242.019.241.02.239.023.236.024.233.027.231.028.229.031.225.032.223.034.22.036.217.038.214.04.211.041.208.043.205.045.201.046.198.048.194.05.191.051.187.053.183.054.18.056.175.057.172.059.168.06.163.061.16.063.155.064.15.066.074.033.073.033.071.034.07.034.069.035.068.035.067.035.066.035.064.036.064.036.062.036.06.036.06.037.058.037.058.037.055.038.055.038.053.038.052.038.051.039.05.039.048.039.047.039.045.04.044.04.043.04.041.04.04.041.039.041.037.041.036.041.034.041.033.042.032.042.03.042.029.042.027.042.026.043.024.043.023.043.021.043.02.043.018.044.017.043.015.044.013.044.012.044.011.045.009.044.007.045.006.045.004.045.002.045.001.045v17l-.001.045-.002.045-.004.045-.006.045-.007.045-.009.044-.011.045-.012.044-.013.044-.015.044-.017.043-.018.044-.02.043-.021.043-.023.043-.024.043-.026.043-.027.042-.029.042-.03.042-.032.042-.033.042-.034.041-.036.041-.037.041-.039.041-.04.041-.041.04-.043.04-.044.04-.045.04-.047.039-.048.039-.05.039-.051.039-.052.038-.053.038-.055.038-.055.038-.058.037-.058.037-.06.037-.06.036-.062.036-.064.036-.064.036-.066.035-.067.035-.068.035-.069.035-.07.034-.071.034-.073.033-.074.033-.15.066-.155.064-.16.063-.163.061-.168.06-.172.059-.175.057-.18.056-.183.054-.187.053-.191.051-.194.05-.198.048-.201.046-.205.045-.208.043-.211.041-.214.04-.217.038-.22.036-.223.034-.225.032-.229.031-.231.028-.233.027-.236.024-.239.023-.241.02-.242.019-.246.016-.247.015-.249.012-.251.01-.253.008-.255.005-.256.004-.258.001-.258-.001-.256-.004-.255-.005-.253-.008-.251-.01-.249-.012-.247-.015-.245-.016-.243-.019-.241-.02-.238-.023-.236-.024-.234-.027-.231-.028-.228-.031-.226-.032-.223-.034-.22-.036-.217-.038-.214-.04-.211-.041-.208-.043-.204-.045-.201-.046-.198-.048-.195-.05-.19-.051-.187-.053-.184-.054-.179-.056-.176-.057-.172-.059-.167-.06-.164-.061-.159-.063-.155-.064-.151-.066-.074-.033-.072-.033-.072-.034-.07-.034-.069-.035-.068-.035-.067-.035-.066-.035-.064-.036-.063-.036-.062-.036-.061-.036-.06-.037-.058-.037-.057-.037-.056-.038-.055-.038-.053-.038-.052-.038-.051-.039-.049-.039-.049-.039-.046-.039-.046-.04-.044-.04-.043-.04-.041-.04-.04-.041-.039-.041-.037-.041-.036-.041-.034-.041-.033-.042-.032-.042-.03-.042-.029-.042-.027-.042-.026-.043-.024-.043-.023-.043-.021-.043-.02-.043-.018-.044-.017-.043-.015-.044-.013-.044-.012-.044-.011-.045-.009-.044-.007-.045-.006-.045-.004-.045-.002-.045-.001-.045v-17l.001-.045.002-.045.004-.045.006-.045.007-.045.009-.044.011-.045.012-.044.013-.044.015-.044.017-.043.018-.044.02-.043.021-.043.023-.043.024-.043.026-.043.027-.042.029-.042.03-.042.032-.042.033-.042.034-.041.036-.041.037-.041.039-.041.04-.041.041-.04.043-.04.044-.04.046-.04.046-.039.049-.039.049-.039.051-.039.052-.038.053-.038.055-.038.056-.038.057-.037.058-.037.06-.037.061-.036.062-.036.063-.036.064-.036.066-.035.067-.035.068-.035.069-.035.07-.034.072-.034.072-.033.074-.033.151-.066.155-.064.159-.063.164-.061.167-.06.172-.059.176-.057.179-.056.184-.054.187-.053.19-.051.195-.05.198-.048.201-.046.204-.045.208-.043.211-.041.214-.04.217-.038.22-.036.223-.034.226-.032.228-.031.231-.028.234-.027.236-.024.238-.023.241-.02.243-.019.245-.016.247-.015.249-.012.251-.01.253-.008.255-.005.256-.004.258-.001.258.001zm-9.258 20.499v.01l.001.021.003.021.004.022.005.021.006.022.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.023.018.024.019.024.021.024.022.025.023.024.024.025.052.049.056.05.061.051.066.051.07.051.075.051.079.052.084.052.088.052.092.052.097.052.102.051.105.052.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.048.144.049.147.047.152.047.155.047.16.045.163.045.167.043.171.043.176.041.178.041.183.039.187.039.19.037.194.035.197.035.202.033.204.031.209.03.212.029.216.027.219.025.222.024.226.021.23.02.233.018.236.016.24.015.243.012.246.01.249.008.253.005.256.004.259.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.021.224-.024.22-.026.216-.027.212-.028.21-.031.205-.031.202-.034.198-.034.194-.036.191-.037.187-.039.183-.04.179-.04.175-.042.172-.043.168-.044.163-.045.16-.046.155-.046.152-.047.148-.048.143-.049.139-.049.136-.05.131-.05.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.053.083-.051.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.05.023-.024.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.023.01-.022.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.127l-.077.055-.08.053-.083.054-.085.053-.087.052-.09.052-.093.051-.095.05-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.045-.118.044-.12.043-.122.042-.124.042-.126.041-.128.04-.13.04-.132.038-.134.038-.135.037-.138.037-.139.035-.142.035-.143.034-.144.033-.147.032-.148.031-.15.03-.151.03-.153.029-.154.027-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.01-.179.008-.179.008-.181.006-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.006-.179-.008-.179-.008-.178-.01-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.027-.153-.029-.151-.03-.15-.03-.148-.031-.146-.032-.145-.033-.143-.034-.141-.035-.14-.035-.137-.037-.136-.037-.134-.038-.132-.038-.13-.04-.128-.04-.126-.041-.124-.042-.122-.042-.12-.044-.117-.043-.116-.045-.113-.045-.112-.046-.109-.047-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.05-.093-.052-.09-.051-.087-.052-.085-.053-.083-.054-.08-.054-.077-.054v4.127zm0-5.654v.011l.001.021.003.021.004.021.005.022.006.022.007.022.009.022.01.022.011.023.012.023.013.023.015.024.016.023.017.024.018.024.019.024.021.024.022.024.023.025.024.024.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.052.11.051.114.051.119.052.123.05.127.051.131.05.135.049.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.044.171.042.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.022.23.02.233.018.236.016.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.012.241-.015.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.048.139-.05.136-.049.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.051.051-.049.023-.025.023-.024.021-.025.02-.024.019-.024.018-.024.017-.024.015-.023.014-.023.013-.024.012-.022.01-.023.01-.023.008-.022.006-.022.006-.022.004-.021.004-.022.001-.021.001-.021v-4.139l-.077.054-.08.054-.083.054-.085.052-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.049-.105.048-.106.047-.109.047-.111.046-.114.045-.115.044-.118.044-.12.044-.122.042-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.035-.143.033-.144.033-.147.033-.148.031-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.025-.161.024-.162.023-.163.022-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.011-.178.009-.179.009-.179.007-.181.007-.182.005-.182.004-.184.003-.184.002h-.37l-.184-.002-.184-.003-.182-.004-.182-.005-.181-.007-.179-.007-.179-.009-.178-.009-.176-.011-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.022-.162-.023-.161-.024-.159-.025-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.031-.146-.033-.145-.033-.143-.033-.141-.035-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.04-.126-.041-.124-.042-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.047-.105-.048-.102-.049-.1-.049-.097-.05-.095-.051-.093-.051-.09-.051-.087-.053-.085-.052-.083-.054-.08-.054-.077-.054v4.139zm0-5.666v.011l.001.02.003.022.004.021.005.022.006.021.007.022.009.023.01.022.011.023.012.023.013.023.015.023.016.024.017.024.018.023.019.024.021.025.022.024.023.024.024.025.052.05.056.05.061.05.066.051.07.051.075.052.079.051.084.052.088.052.092.052.097.052.102.052.105.051.11.052.114.051.119.051.123.051.127.05.131.05.135.05.139.049.144.048.147.048.152.047.155.046.16.045.163.045.167.043.171.043.176.042.178.04.183.04.187.038.19.037.194.036.197.034.202.033.204.032.209.03.212.028.216.027.219.025.222.024.226.021.23.02.233.018.236.017.24.014.243.012.246.01.249.008.253.006.256.003.259.001.26-.001.257-.003.254-.006.25-.008.247-.01.244-.013.241-.014.237-.016.233-.018.231-.02.226-.022.224-.024.22-.025.216-.027.212-.029.21-.03.205-.032.202-.033.198-.035.194-.036.191-.037.187-.039.183-.039.179-.041.175-.042.172-.043.168-.044.163-.045.16-.045.155-.047.152-.047.148-.048.143-.049.139-.049.136-.049.131-.051.126-.05.123-.051.118-.052.114-.051.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.052.07-.051.065-.051.06-.051.056-.05.051-.049.023-.025.023-.025.021-.024.02-.024.019-.024.018-.024.017-.024.015-.023.014-.024.013-.023.012-.023.01-.022.01-.023.008-.022.006-.022.006-.022.004-.022.004-.021.001-.021.001-.021v-4.153l-.077.054-.08.054-.083.053-.085.053-.087.053-.09.051-.093.051-.095.051-.097.05-.1.049-.102.048-.105.048-.106.048-.109.046-.111.046-.114.046-.115.044-.118.044-.12.043-.122.043-.124.042-.126.041-.128.04-.13.039-.132.039-.134.038-.135.037-.138.036-.139.036-.142.034-.143.034-.144.033-.147.032-.148.032-.15.03-.151.03-.153.028-.154.028-.156.027-.158.026-.159.024-.161.024-.162.023-.163.023-.165.021-.166.02-.167.019-.169.018-.169.017-.171.016-.173.015-.173.014-.175.013-.175.012-.177.01-.178.01-.179.009-.179.007-.181.006-.182.006-.182.004-.184.003-.184.001-.185.001-.185-.001-.184-.001-.184-.003-.182-.004-.182-.006-.181-.006-.179-.007-.179-.009-.178-.01-.176-.01-.176-.012-.175-.013-.173-.014-.172-.015-.171-.016-.17-.017-.169-.018-.167-.019-.166-.02-.165-.021-.163-.023-.162-.023-.161-.024-.159-.024-.157-.026-.156-.027-.155-.028-.153-.028-.151-.03-.15-.03-.148-.032-.146-.032-.145-.033-.143-.034-.141-.034-.14-.036-.137-.036-.136-.037-.134-.038-.132-.039-.13-.039-.128-.041-.126-.041-.124-.041-.122-.043-.12-.043-.117-.044-.116-.044-.113-.046-.112-.046-.109-.046-.106-.048-.105-.048-.102-.048-.1-.05-.097-.049-.095-.051-.093-.051-.09-.052-.087-.052-.085-.053-.083-.053-.08-.054-.077-.054v4.153zm8.74-8.179l-.257.004-.254.005-.25.008-.247.011-.244.012-.241.014-.237.016-.233.018-.231.021-.226.022-.224.023-.22.026-.216.027-.212.028-.21.031-.205.032-.202.033-.198.034-.194.036-.191.038-.187.038-.183.04-.179.041-.175.042-.172.043-.168.043-.163.045-.16.046-.155.046-.152.048-.148.048-.143.048-.139.049-.136.05-.131.05-.126.051-.123.051-.118.051-.114.052-.11.052-.106.052-.101.052-.096.052-.092.052-.088.052-.083.052-.079.052-.074.051-.07.052-.065.051-.06.05-.056.05-.051.05-.023.025-.023.024-.021.024-.02.025-.019.024-.018.024-.017.023-.015.024-.014.023-.013.023-.012.023-.01.023-.01.022-.008.022-.006.023-.006.021-.004.022-.004.021-.001.021-.001.021.001.021.001.021.004.021.004.022.006.021.006.023.008.022.01.022.01.023.012.023.013.023.014.023.015.024.017.023.018.024.019.024.02.025.021.024.023.024.023.025.051.05.056.05.06.05.065.051.07.052.074.051.079.052.083.052.088.052.092.052.096.052.101.052.106.052.11.052.114.052.118.051.123.051.126.051.131.05.136.05.139.049.143.048.148.048.152.048.155.046.16.046.163.045.168.043.172.043.175.042.179.041.183.04.187.038.191.038.194.036.198.034.202.033.205.032.21.031.212.028.216.027.22.026.224.023.226.022.231.021.233.018.237.016.241.014.244.012.247.011.25.008.254.005.257.004.26.001.26-.001.257-.004.254-.005.25-.008.247-.011.244-.012.241-.014.237-.016.233-.018.231-.021.226-.022.224-.023.22-.026.216-.027.212-.028.21-.031.205-.032.202-.033.198-.034.194-.036.191-.038.187-.038.183-.04.179-.041.175-.042.172-.043.168-.043.163-.045.16-.046.155-.046.152-.048.148-.048.143-.048.139-.049.136-.05.131-.05.126-.051.123-.051.118-.051.114-.052.11-.052.106-.052.101-.052.096-.052.092-.052.088-.052.083-.052.079-.052.074-.051.07-.052.065-.051.06-.05.056-.05.051-.05.023-.025.023-.024.021-.024.02-.025.019-.024.018-.024.017-.023.015-.024.014-.023.013-.023.012-.023.01-.023.01-.022.008-.022.006-.023.006-.021.004-.022.004-.021.001-.021.001-.021-.001-.021-.001-.021-.004-.021-.004-.022-.006-.021-.006-.023-.008-.022-.01-.022-.01-.023-.012-.023-.013-.023-.014-.023-.015-.024-.017-.023-.018-.024-.019-.024-.02-.025-.021-.024-.023-.024-.023-.025-.051-.05-.056-.05-.06-.05-.065-.051-.07-.052-.074-.051-.079-.052-.083-.052-.088-.052-.092-.052-.096-.052-.101-.052-.106-.052-.11-.052-.114-.052-.118-.051-.123-.051-.126-.051-.131-.05-.136-.05-.139-.049-.143-.048-.148-.048-.152-.048-.155-.046-.16-.046-.163-.045-.168-.043-.172-.043-.175-.042-.179-.041-.183-.04-.187-.038-.191-.038-.194-.036-.198-.034-.202-.033-.205-.032-.21-.031-.212-.028-.216-.027-.22-.026-.224-.023-.226-.022-.231-.021-.233-.018-.237-.016-.241-.014-.244-.012-.247-.011-.25-.008-.254-.005-.257-.004-.26-.001-.26.001z\"></path></symbol></defs><defs><symbol id=\"clock\" width=\"24\" height=\"24\"><path transform=\"scale(.5)\" d=\"M12 2c5.514 0 10 4.486 10 10s-4.486 10-10 10-10-4.486-10-10 4.486-10 10-10zm0-2c-6.627 0-12 5.373-12 12s5.373 12 12 12 12-5.373 12-12-5.373-12-12-12zm5.848 12.459c.202.038.202.333.001.372-1.907.361-6.045 1.111-6.547 1.111-.719 0-1.301-.582-1.301-1.301 0-.512.77-5.447 1.125-7.445.034-.192.312-.181.343.014l.985 6.238 5.394 1.011z\"></path></symbol></defs><defs><marker id=\"arrowhead\" refX=\"7.9\" refY=\"5\" markerUnits=\"userSpaceOnUse\" markerWidth=\"12\" markerHeight=\"12\" orient=\"auto-start-reverse\"><path d=\"M -1 0 L 10 5 L 0 10 z\"></path></marker></defs><defs><marker id=\"crosshead\" markerWidth=\"15\" markerHeight=\"8\" orient=\"auto\" refX=\"4\" refY=\"4.5\"><path fill=\"none\" stroke=\"#000000\" stroke-width=\"1pt\" d=\"M 1,2 L 6,7 M 6,2 L 1,7\" style=\"stroke-dasharray: 0, 0;\"></path></marker></defs><defs><marker id=\"filled-head\" refX=\"15.5\" refY=\"7\" markerWidth=\"20\" markerHeight=\"28\" orient=\"auto\"><path d=\"M 18,7 L9,13 L14,7 L9,1 Z\"></path></marker></defs><defs><marker id=\"sequencenumber\" refX=\"15\" refY=\"15\" markerWidth=\"60\" markerHeight=\"40\" orient=\"auto\"><circle cx=\"15\" cy=\"15\" r=\"6\"></circle></marker></defs><g><rect x=\"50\" y=\"75\" fill=\"#EDF2AE\" stroke=\"#666\" width=\"1545\" height=\"42\" class=\"note\"></rect><text x=\"823\" y=\"80\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"noteText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\"><tspan x=\"823\">1. Create the consent link</tspan></text></g><g><rect x=\"50\" y=\"235\" fill=\"#EDF2AE\" stroke=\"#666\" width=\"1545\" height=\"42\" class=\"note\"></rect><text x=\"823\" y=\"240\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"noteText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\"><tspan x=\"823\">2. Share the link</tspan></text></g><g><rect x=\"50\" y=\"395\" fill=\"#EDF2AE\" stroke=\"#666\" width=\"1545\" height=\"42\" class=\"note\"></rect><text x=\"823\" y=\"400\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"noteText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\"><tspan x=\"823\">3. Customer completes the widget</tspan></text></g><g><rect x=\"50\" y=\"771\" fill=\"#EDF2AE\" stroke=\"#666\" width=\"1545\" height=\"42\" class=\"note\"></rect><text x=\"823\" y=\"776\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"noteText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\"><tspan x=\"823\">4. Confirm the result</tspan></text></g><text x=\"644\" y=\"132\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">POST /consents/links</text><line x1=\"76\" y1=\"171\" x2=\"1212\" y2=\"171\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"647\" y=\"186\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">201 - Created + id + consentLinkUrl</text><line x1=\"1215\" y1=\"225\" x2=\"79\" y2=\"225\" class=\"messageLine1\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"stroke-dasharray: 3, 3; fill: none;\"></line><text x=\"319\" y=\"292\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Send consentLinkUrl (SMS, email, WhatsApp, or redirect)</text><line x1=\"76\" y1=\"331\" x2=\"561\" y2=\"331\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"718\" y=\"346\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Open consentLinkUrl</text><line x1=\"566\" y1=\"385\" x2=\"869\" y2=\"385\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"1043\" y=\"452\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Submit CLABE</text><line x1=\"874\" y1=\"491\" x2=\"1212\" y2=\"491\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"1392\" y=\"506\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Send a $0.01 MXN deposit with a code</text><line x1=\"1217\" y1=\"545\" x2=\"1566\" y2=\"545\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"1043\" y=\"560\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Accept the authorization</text><line x1=\"874\" y1=\"599\" x2=\"1212\" y2=\"599\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"718\" y=\"614\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Enter the code from the deposit</text><line x1=\"566\" y1=\"653\" x2=\"869\" y2=\"653\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"1043\" y=\"668\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Verify the code (electronic signature)</text><line x1=\"874\" y1=\"707\" x2=\"1212\" y2=\"707\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"1046\" y=\"722\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Link completed</text><line x1=\"1215\" y1=\"761\" x2=\"877\" y2=\"761\" class=\"messageLine1\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"stroke-dasharray: 3, 3; fill: none;\"></line><text x=\"647\" y=\"828\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">WEBHOOK consent_confirmed (consentId, paymentMethodId)</text><line x1=\"1215\" y1=\"867\" x2=\"79\" y2=\"867\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"476\" y=\"882\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">Redirect to callbackUrl?status=completed</text><line x1=\"872\" y1=\"921\" x2=\"79\" y2=\"921\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"644\" y=\"936\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">GET /consents/links/{id}</text><line x1=\"76\" y1=\"975\" x2=\"1212\" y2=\"975\" class=\"messageLine0\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"fill: none;\"></line><text x=\"647\" y=\"990\" text-anchor=\"middle\" dominant-baseline=\"middle\" alignment-baseline=\"middle\" class=\"messageText\" dy=\"1em\" style=\"font-size: 16px; font-weight: 400;\">200 + status completed</text><line x1=\"1215\" y1=\"1029\" x2=\"79\" y2=\"1029\" class=\"messageLine1\" stroke-width=\"2\" stroke=\"none\" marker-end=\"url(#arrowhead)\" style=\"stroke-dasharray: 3, 3; fill: none;\"></line></svg></div>"},"children":["sequenceDiagram\n    participant App as Your application\n    participant Customer as Customer\n    participant Widget as Consent link widget\n    participant Belvo as Belvo\n    participant Bank as Customer's bank\n\n    Note over App,Bank: 1. Create the consent link\n    App->>Belvo: POST /consents/links\n    Belvo-->>App: 201 - Created + id + consentLinkUrl\n\n    Note over App,Bank: 2. Share the link\n    App->>Customer: Send consentLinkUrl (SMS, email, WhatsApp, or redirect)\n    Customer->>Widget: Open consentLinkUrl\n\n    Note over App,Bank: 3. Customer completes the widget\n    Widget->>Belvo: Submit CLABE\n    Belvo->>Bank: Send a $0.01 MXN deposit with a code\n    Widget->>Belvo: Accept the authorization\n    Customer->>Widget: Enter the code from the deposit\n    Widget->>Belvo: Verify the code (electronic signature)\n    Belvo-->>Widget: Link completed\n\n    Note over App,Bank: 4. Confirm the result\n    Belvo->>App: WEBHOOK consent_confirmed (consentId, paymentMethodId)\n    Widget->>App: Redirect to callbackUrl?status=completed\n    App->>Belvo: GET /consents/links/{id}\n    Belvo-->>App: 200 + status completed\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"criar-um-link-de-consentimento","__idx":3},"children":["Criar um link de consentimento"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para criar um link de consentimento, faça uma chamada ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /consents/links"]}," com o ID do cliente e os termos de pagamento que ele deve autorizar."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Sandbox","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","data-title":"Create a Consent Link Request (Sandbox)","header":{"title":"Create a Consent Link Request (Sandbox)","controls":{"copy":{}}},"source":"curl -i -X POST \\\n  'https://api.sandbox.directdebit.belvo.com/consents/links' \\\n  -H 'Content-Type: application/json' \\\n  -H 'api-key-id: YOUR_API_KEY_ID' \\\n  -H 'api-key-secret: YOUR_API_KEY_SECRET' \\\n  -d '{\n    \"customerId\": \"0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c\",\n    \"expiresIn\": 72,\n    \"callbackUrl\": \"https://www.your-app.com/direct-debit/return\",\n    \"terms\": {\n      \"chargeType\": \"RECURRING\",\n      \"chargeAmount\": 420.00,\n      \"paymentFrequency\": \"MONTHLY\",\n      \"serviceOrCreditDescription\": \"Préstamo personal\",\n      \"termDescription\": \"12 meses\",\n      \"interestRate\": \"1,0% mensual\",\n      \"numberOfCharges\": 12,\n      \"firstChargeDate\": \"2026-11-10\",\n      \"isPayrollLinked\": false\n    }\n  }'\n","lang":"curl"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Produção","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","data-title":"Create a Consent Link Request (Production)","header":{"title":"Create a Consent Link Request (Production)","controls":{"copy":{}}},"source":"curl -i -X POST \\\n  'https://api.directdebit.belvo.com/consents/links' \\\n  -H 'Content-Type: application/json' \\\n  -H 'api-key-id: YOUR_API_KEY_ID' \\\n  -H 'api-key-secret: YOUR_API_KEY_SECRET' \\\n  -d '{\n    \"customerId\": \"0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c\",\n    \"expiresIn\": 72,\n    \"callbackUrl\": \"https://www.your-app.com/direct-debit/return\",\n    \"terms\": {\n      \"chargeType\": \"RECURRING\",\n      \"chargeAmount\": 420.00,\n      \"paymentFrequency\": \"MONTHLY\",\n      \"serviceOrCreditDescription\": \"Préstamo personal\",\n      \"termDescription\": \"12 meses\",\n      \"interestRate\": \"1,0% mensual\",\n      \"numberOfCharges\": 12,\n      \"firstChargeDate\": \"2026-11-10\",\n      \"isPayrollLinked\": false\n    }\n  }'\n","lang":"curl"},"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":{"width":"20%","data-label":"Parâmetro"},"children":["Parâmetro "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obrigatório"},"children":["Obrigatório"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["true"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," do cliente que deve autorizar o débito direto. O cliente deve pertencer à sua conta."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["objeto"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["false"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Os termos de pagamento que seu cliente revisa e autoriza no widget. Para detalhes, veja a tabela ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#terms-object"},"children":["Objeto Terms"]}," abaixo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresIn"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["inteiro"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["false"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O número de horas até que o link expire. Mínimo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},", máximo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["720"]}," (30 dias). Padrão: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["72"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["false"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A URL para a qual o widget envia seu cliente de volta quando ele termina ou sai do fluxo. A Belvo adiciona o resultado como parâmetros de consulta. A URL deve usar ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https"]},", não deve conter credenciais e pode ter no máximo 2048 caracteres. Você só pode defini-la quando criar o link. Para detalhes, veja ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#handle-the-redirect-to-your-callback-url"},"children":["Como lidar com o redirecionamento para sua URL de callback"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"objeto-de-termos","__idx":4},"children":["Objeto de Termos"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Todos os termos são opcionais. O widget só mostra os termos que você envia, então envie todos os termos que se aplicam ao acordo com seu cliente."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Envie valores brutos, não texto formatado"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeAmount"]}," como um número JSON (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["420.00"]},"), não como uma string. A Belvo rejeita valores pré-formatados como ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"$420.00 MXN\""]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"420.00\""]},". O valor está sempre em pesos mexicanos (MXN), e a Belvo o formata para seu cliente."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeType"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFrequency"]}," em maiúsculas (por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECURRING"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY"]},"). A Belvo rejeita valores em minúsculas."]}]},{"$$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":{"width":"22%","data-label":"Parâmetro"},"children":["Parâmetro "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeType"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["string (enum)"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O tipo de cobrança que seu cliente autoriza. Pode ser um dos seguintes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECURRING"]},": Cobranças que se repetem em um cronograma, como parcelas de empréstimos ou assinaturas."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SINGLE"]},": Uma única cobrança."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SINGLE"]},", o widget rotula o valor e a data como uma cobrança única (\"Monto de cargo (cargo único)\" e \"Fecha del cargo\")."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O valor de cada cobrança, em MXN. Deve ser pelo menos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},". A Belvo arredonda para duas casas decimais. Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1234.5"]}," é mostrado para seu cliente como \"$1,234.50 MXN\"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFrequency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (enum)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Com que frequência você cobra seu cliente. Pode ser um dos seguintes: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTHLY"]}," (mostrado como \"Mensual\"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BIWEEKLY"]}," (mostrado como \"Quincenal\"), ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WEEKLY"]}," (mostrado como \"Semanal\")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviceOrCreditDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uma descrição do serviço ou crédito, em espanhol. Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Préstamo personal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["termDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uma descrição do prazo do acordo, em espanhol. Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12 meses"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interestRate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A taxa de juros, formatada como você deseja que seu cliente a leia. Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1,0% mensual"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numberOfCharges"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O número total de cobranças. Deve ser pelo menos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstChargeDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A data da primeira cobrança, no formato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},". Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026-11-10"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isPayrollLinked"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indica se o crédito está vinculado à folha de pagamento do seu cliente."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Permita que seu cliente revise o contrato completo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente só pode abrir o contrato completo de débito direto (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revisar contrato de domiciliación"]},") quando o link tiver um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeAmount"]},", e também um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFrequency"]}," para cobranças ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECURRING"]},". Certifique-se de enviar esses termos."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você receberá a seguinte resposta da nossa API. Certifique-se de salvar o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," para verificar o status do link mais tarde, e enviar o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentLinkUrl"]}," para seu cliente."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Create a Consent Link Response Body","header":{"title":"Create a Consent Link Response Body","controls":{"copy":{}}},"source":"{\n  \"id\": \"b8e1c2f4-5a6d-4e7f-8a9b-0c1d2e3f4a5b\", // [!code highlight]\n  \"consentLinkUrl\": \"https://portal.sandbox.directdebit.belvo.com/consent.html?token=aB3dE6fG9hJ2kL5mN8pQ1rS4\", // [!code highlight]\n  \"status\": \"active\",\n  \"step\": \"bank_account\",\n  \"customerId\": \"0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c\",\n  \"terms\": {\n    \"chargeType\": \"RECURRING\",\n    \"chargeAmount\": 420,\n    \"paymentFrequency\": \"MONTHLY\",\n    \"serviceOrCreditDescription\": \"Préstamo personal\",\n    \"termDescription\": \"12 meses\",\n    \"interestRate\": \"1,0% mensual\",\n    \"numberOfCharges\": 12,\n    \"firstChargeDate\": \"2026-11-10\",\n    \"isPayrollLinked\": false\n  },\n  \"expiresAt\": \"2026-10-03T15:00:00.000Z\",\n  \"callbackUrl\": \"https://www.your-app.com/direct-debit/return\"\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":{"width":"20%","data-label":"Parâmetro"},"children":["Parâmetro "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O ID da Belvo do link de consentimento."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentLinkUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A URL que você envia para seu cliente."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O status do link. Para os valores possíveis, veja ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#consent-link-statuses"},"children":["Status dos links de consentimento"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A tela em que seu cliente está enquanto o link está ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]},". Para os valores possíveis, veja ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#consent-link-steps"},"children":["Etapas dos links de consentimento"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," ao qual o link pertence."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terms"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Os termos, exatamente como você os enviou."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O timestamp ISO-8601 quando o link expira."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O timestamp ISO-8601 quando seu cliente completou o link. Presente apenas para links ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A URL de callback, se você definiu uma."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"compartilhe-o-link-com-seu-cliente","__idx":5},"children":["Compartilhe o link com seu cliente"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Envie o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentLinkUrl"]}," para seu cliente por SMS, email ou WhatsApp, ou redirecione-o a partir do seu aplicativo. O widget funciona em qualquer navegador móvel ou desktop, está em espanhol e não requer que seu cliente faça login."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Trate o link como um segredo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Qualquer pessoa com o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentLinkUrl"]}," pode abrir o widget para seu cliente. Envie-o apenas para seu cliente e não o registre ou adicione a ferramentas de análise. Se você achar que um link foi compartilhado com a pessoa errada, revogue-o e crie um novo. Veja ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#manage-consent-links"},"children":["Gerenciar links de consentimento"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-seu-cliente-vê","__idx":6},"children":["O que seu cliente vê"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente passa pelas seguintes telas. O widget salva o progresso deles, então, se fecharem a página e abrirem o link novamente antes que ele expire, continuarão na mesma tela."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-bem-vindo","__idx":7},"children":["1. Bem-vindo"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A tela de boas-vindas explica como o processo funciona:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Seu cliente confirma e revisa o débito direto."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Belvo deposita $0,01 MXN na conta deles, com um código."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Seu cliente insere o código para autorizar o débito direto."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para continuar, seu cliente deve aceitar os Termos e Condições e o Aviso de Privacidade da Belvo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se você definir um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]},", uma seta para trás permite que seu cliente saia do fluxo. A Belvo os redireciona para o seu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=cancelled&error=user_cancelled"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-welcome.a498caa25266e37c64e65d0fc0d10dab1806499c37b62529baab42104292239e.9c1bb791.png","alt":"Tela de boas-vindas do link de consentimento","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-confirme-os-dados-pessoais-e-clabe","__idx":8},"children":["2. Confirme os dados pessoais e CLABE"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O widget mostra o nome completo do seu cliente e o RFC ou CURP mascarado do registro do cliente. Seu cliente não pode editar esses valores."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente insere sua CLABE de 18 dígitos. O widget verifica se a CLABE é válida, e a Belvo identifica o banco a partir dela. A conta deve estar no nome do seu cliente. Links de consentimento aceitam apenas contas CLABE, não cartões de débito."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando seu cliente toca em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continuar"]},", a Belvo cria o método de pagamento e imediatamente envia o depósito de $0,01 MXN com o código."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se o nome ou ID estiver errado, seu cliente pode tocar em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No soy yo"]}," e depois em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salir sin autorizar"]},". A Belvo os redireciona para o seu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=cancelled&error=customer_data_mismatch"]},". Corrija os dados do cliente e crie um novo link."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-bank-account.f030a3f117d425f25a7c9cbdc5c3e215b50aa5413a6afad8074a233063da2caa.9c1bb791.png","alt":"Tela de dados pessoais e CLABE do link de consentimento","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-revise-e-aceite-a-autorização","__idx":9},"children":["3. Revise e aceite a autorização"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O widget mostra um resumo dos termos que você enviou, junto com o número da conta mascarado, o banco e o nome da sua empresa como beneficiário. Ele também informa ao seu cliente que nada será cobrado hoje."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para cobranças ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECURRING"]},", o título diz \"Revisa y autoriza tus cargos recurrentes\". Para cobranças ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SINGLE"]},", diz \"Revisa y autoriza tu cargo único\". O resumo possui apenas uma linha para cada termo que você enviou."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando seu cliente toca em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continuar"]},", ele aceita a autorização. A Belvo sela o documento de autorização e o armazena como o arquivo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contract"]}," do consentimento."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-authorization-recurring.2053a4ae05b067b9f5ee136cfa6b83f9d4c44ff8ba6e61a15d9a2753b960ef18.9c1bb791.png","alt":"Resumo da autorização para cobranças recorrentes","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cobrança única"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este link de exemplo tem ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"chargeType\": \"SINGLE\""]}," e envia apenas ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeAmount"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstChargeDate"]},", então o resumo mostra o valor, a data da cobrança, a conta e o beneficiário."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-authorization-single.71112f12c40d26d7998ff190e161585d6d0551ee40ffb1c5af5a6a481cb7b849.9c1bb791.png","alt":"Resumo da autorização para uma cobrança única","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revisão do contrato"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Com ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revisar contrato de domiciliación"]},", seu cliente lê o contrato completo de débito direto, preenchido com seus dados e seus termos, e pode baixar uma cópia em PDF antes de aceitar."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-authorization-contract.d6d6369567ac112285d1c03dc6f9a761beabf2d7a58b457ade0fa4e3a59b12fb.9c1bb791.png","alt":"Revisão do contrato de débito direto","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-aguarde-o-depósito","__idx":10},"children":["4. Aguarde o depósito"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se o depósito ainda não chegou, o widget informa ao seu cliente para procurar um depósito de $0,01 MXN no aplicativo bancário. O código está na descrição da transação."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O widget verifica o depósito automaticamente e avança para a próxima tela quando ele chega. Se o depósito já tiver chegado enquanto seu cliente estava revisando a autorização, o widget pula esta tela."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-awaiting-deposit.1d5b2164768bee49048c5f07335b66b44d28f585eb6d1b63fa7341229c23e237.9c1bb791.png","alt":"Aguardando o depósito de verificação","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-insira-o-código-e-autorize","__idx":11},"children":["5. Insira o código e autorize"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente insere o código de 6 dígitos da descrição do depósito e toca em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Autorizar"]},". Inserir o código é a assinatura eletrônica do seu cliente para a autorização."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente tem 3 tentativas para inserir o código correto. Se não conseguir encontrar o depósito, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No recibí el depósito"]}," explica onde encontrar o código. Se seu cliente inseriu a CLABE errada, o depósito nunca chega. Eles podem encerrar o fluxo a partir do mesmo diálogo, e você precisará criar um novo link para eles."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-verification.b2d6c3fe5b2551a194cda1ce1ccb3be493fdad267090a6effce172ffaf92dbde.9c1bb791.png","alt":"Tela de código de verificação","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"6-autorização-confirmada","__idx":12},"children":["6. Autorização confirmada"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando o código está correto, o consentimento é confirmado e o link é ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},". O widget mostra um resumo dos termos autorizados."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando seu cliente toca em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cerrar"]},", a Belvo os redireciona para o seu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status=completed"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-success.2a425bda7fb9eb6cbb2ccfdf38d3494538e05b52e7150c435aaaf023ffe8e649.9c1bb791.png","alt":"Tela de autorização confirmada","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contrato assinado"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Com ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contrato de domiciliación"]},", seu cliente vê a evidência da assinatura eletrônica: a data e hora da assinatura (horário da Cidade do México), o folio da assinatura, o dispositivo, um endereço IP mascarado e os detalhes do depósito de verificação. Eles também podem baixar o contrato assinado como um PDF."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-signed-contract.462c6902f898a68d9a0d1b28ebd5ddac8e3c2a66b351b6ce5c67e1a4a125cec1.9c1bb791.png","alt":"Contrato assinado com detalhes da assinatura eletrônica","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"telas-de-erro","__idx":13},"children":["Telas de erro"]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Link indisponível"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O widget exibe esta tela quando o link está expirado, revogado, já concluído, falhou ou é inválido. Por razões de segurança, o widget mostra a mesma mensagem em todos os casos. Seu cliente é solicitado a pedir um novo link para você."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-unavailable.496bac1d344d298a9ad21c88e71adcdf690cd640b086f1ddba9e9f7c7e0a484e.9c1bb791.png","alt":"Tela de link indisponível","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Split","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Falha na autorização"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O widget exibe esta tela quando a Belvo não consegue completar uma ação enquanto seu cliente está no fluxo, por exemplo, quando a validação da conta falha após a submissão do CLABE. A tela inclui um ID que seu cliente pode compartilhar com o suporte da Belvo em cobros@belvo.com."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mx-pay-dd-consent-link-failure.c26eeb35840d9f15d1c383fb5bd882c2053243c3b1842261f23103fbf047a5e6.9c1bb791.png","alt":"Tela de falha na autorização","withLightbox":false,"width":"75%"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lidar-com-o-redirecionamento-para-sua-url-de-callback","__idx":14},"children":["Lidar com o redirecionamento para sua URL de callback"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se você definir um ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]},", a Belvo redireciona seu cliente para ela quando ele termina ou sai do fluxo. A Belvo mantém quaisquer parâmetros de consulta que sua URL já tenha e adiciona os seguintes:"]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"error"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Quando"},"children":["Quando"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não presente"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente autorizou o débito direto e tocou em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cerrar"]}," na tela de confirmação."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente saiu da tela de boas-vindas."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancelled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_data_mismatch"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente informou que o nome ou ID no widget não é dele."]}]}]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","data-title":"Exemplo de redirecionamento","header":{"title":"Exemplo de redirecionamento","controls":{"copy":{}}},"source":"https://www.your-app.com/direct-debit/return?status=completed\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O redirecionamento nunca inclui o token de link ou quaisquer dados do cliente."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Não confie apenas no redirecionamento"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use o redirecionamento para atualizar sua interface de usuário, mas sempre confirme o resultado com a API ou webhooks antes de criar solicitações de pagamento. Qualquer pessoa pode abrir sua URL de callback com quaisquer parâmetros, e seu cliente pode fechar a página sem ser redirecionado. Além disso, ignore quaisquer valores de parâmetros que você não reconheça, pois podemos adicionar novos."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ouça-os-webhooks-e-confirme-o-resultado","__idx":15},"children":["Ouça os webhooks e confirme o resultado"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Um link de consentimento cria um método de pagamento regular e consentimento, então você recebe os mesmos webhooks que no fluxo de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-direct-api-setup","target":"_blank"},"children":["Pagamentos por Débito Direto via API"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consent_update"]}," com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consent_confirmed"]},": Seu cliente inseriu o código correto e o consentimento está confirmado. O campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.id"]}," é o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentId"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.paymentMethodId"]}," é o método de pagamento que o link criou."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method_update"]}," com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method_registration_successful"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method_registration_failed"]},": O resultado da validação da conta. Métodos de pagamento criados por um link de consentimento têm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ConsentLink"]}," como sua ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reference"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para payloads completos de webhooks, veja nossa documentação de ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/developer_resources/resources-webhooks-payments-mexico","target":"_blank"},"children":["Webhooks de Pagamento (México)"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para verificar o status do link a qualquer momento, faça uma chamada ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /consents/links/{id}"]},". Um status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}," significa que seu cliente finalizou o fluxo."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Sandbox","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","data-title":"Get a Consent Link Request (Sandbox)","header":{"title":"Get a Consent Link Request (Sandbox)","controls":{"copy":{}}},"source":"curl -i -X GET \\\n  'https://api.sandbox.directdebit.belvo.com/consents/links/{id}' \\\n  -H 'api-key-id: YOUR_API_KEY_ID' \\\n  -H 'api-key-secret: YOUR_API_KEY_SECRET'\n","lang":"curl"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Produção","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","data-title":"Get a Consent Link Request (Production)","header":{"title":"Get a Consent Link Request (Production)","controls":{"copy":{}}},"source":"curl -i -X GET \\\n  'https://api.directdebit.belvo.com/consents/links/{id}' \\\n  -H 'api-key-id: YOUR_API_KEY_ID' \\\n  -H 'api-key-secret: YOUR_API_KEY_SECRET'\n","lang":"curl"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para identificar o método de pagamento que o link criou, use o valor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.paymentMethodId"]}," do webhook ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consent_confirmed"]},". Não procure apenas pelo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_id"]},", pois seu cliente pode ter mais de um método de pagamento. Para confirmar a qual cliente o método de pagamento pertence, faça uma chamada ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/apis/belvopaymentsmexico/payment-methods-(direct-debit-mexico)/detaildirectdebitpaymentmethod","target":"_blank"},"children":["GET para obter os detalhes de um método de pagamento"]}," e compare seu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer"]}," com o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," do link. Isso apenas confirma o cliente: se você criou mais de um link de consentimento para o mesmo cliente, isso não indica qual link criou o método de pagamento."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Feito!"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Seu cliente autorizou o débito direto, e você tem um método de pagamento com consentimento confirmado. Agora você pode ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-direct-api-setup#create-a-payment-request","target":"_blank"},"children":["criar solicitações de pagamento"]}," para este cliente."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"testar-links-de-consentimento-no-sandbox","__idx":16},"children":["Testar links de consentimento no Sandbox"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No Sandbox, a Belvo não envia um depósito real de $0,01 MXN, então você não pode ler um código de um extrato bancário. Em vez disso, você controla o resultado do fluxo com a CLABE e o código que seu testador insere no widget. Use o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consentLinkUrl"]}," que você obtém da ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/pt-br/products/payments_mexico/direct-debit-authentication-and-environments#sandbox","target":"_blank"},"children":["API do Sandbox"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"escolha-o-resultado-da-validação-da-conta","__idx":17},"children":["Escolha o resultado da validação da conta"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Insira uma das seguintes CLABEs na tela de dados pessoais e CLABE:"]},{"$$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":{"width":"25%","data-label":"CLABE"},"children":["CLABE "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Resultado"},"children":["Resultado"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["012180000000000015"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A validação da conta falha. O método de pagamento é ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},", o status do link muda para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},", e o widget mostra uma tela de erro. Para mais detalhes, veja ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#error-screens"},"children":["Telas de erro"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["012180000000000028"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O depósito nunca chega. O método de pagamento permanece em ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending_validation"]},", e o link fica na etapa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_deposit"]}," até expirar. Use-o para testar a tela de espera."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Qualquer outra CLABE válida"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O depósito chega imediatamente. O link avança para a etapa de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verification"]}," assim que seu testador aceita a autorização, e o widget pula a tela de espera."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Os métodos de pagamento que você cria com essas CLABEs usam ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}," ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}," como sua ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reference"]}," em vez de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ConsentLink"]},". As CLABEs mágicas funcionam apenas no Sandbox. Em Produção, a Belvo as trata como qualquer outra CLABE."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"insira-o-código-de-verificação","__idx":18},"children":["Insira o código de verificação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No Sandbox, o código de verificação é sempre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123456"]},". Insira qualquer outro código para testar a mensagem de código incorreto. Seu testador tem 3 tentativas para inserir o código correto."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testar-outros-status-de-link","__idx":19},"children":["Testar outros status de link"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Expirado:"]}," crie um link com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"expiresIn\": 1"]}," e abra-o após uma hora."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revogado:"]}," faça uma chamada ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /consents/links/{id}/revoke"]}," e, em seguida, abra o link."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"referência-de-link-de-consentimento","__idx":20},"children":["Referência de link de consentimento"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-dos-links-de-consentimento","__idx":21},"children":["Status dos links de consentimento"]},{"$$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":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O link pode ser usado. Verifique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}," para ver em qual tela seu cliente está."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente autorizou o débito direto. O consentimento está confirmado."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O link atingiu sua data de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expiresAt"]}," antes de seu cliente completá-lo."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revoked"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Você revogou o link."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A validação da conta falhou, por exemplo, porque o titular da conta não corresponde ao cliente. Crie um novo link para que seu cliente possa tentar novamente com uma conta diferente."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apenas links ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}," podem ser abertos. Para qualquer outro status, o widget mostra a tela ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Link indisponível"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"etapas-do-link-de-consentimento","__idx":22},"children":["Etapas do link de consentimento"]},{"$$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":"Etapa"},"children":["Etapa"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente ainda não enviou sua CLABE."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente enviou sua CLABE e está revisando a autorização."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["awaiting_deposit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seu cliente aceitou a autorização e está aguardando o depósito de $0,01 MXN."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O depósito chegou e seu cliente deve inserir o código."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Quando um link está ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["completed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step"]}," mantém a última etapa em que seu cliente estava. Sempre verifique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," primeiro."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gerenciar-links-de-consentimento","__idx":23},"children":["Gerenciar links de consentimento"]},{"$$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":"Requisição"},"children":["Requisição"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /consents/links"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lista seus links de consentimento, paginados. Suporta os parâmetros de consulta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /consents/links/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Obtém os detalhes de um link de consentimento."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /consents/links/{id}/revoke"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revoga um link de consentimento. O link não poderá mais ser aberto. Revogar um link não altera um método de pagamento ou consentimento que o link já criou."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"erros","__idx":24},"children":["Erros"]},{"$$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 HTTP"},"children":["Status HTTP"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrição"},"children":["Descrição"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O corpo da solicitação é inválido. Por exemplo, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeAmount"]}," é uma string ou menor que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeType"]}," está em minúsculas, ou ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackUrl"]}," não usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O cliente ou link de consentimento não existe ou não pertence à sua conta."]}]}]}]}]}]},"headings":[{"value":"Coletar consentimento com links de consentimento","id":"coletar-consentimento-com-links-de-consentimento","depth":1},{"value":"Pré-requisitos","id":"pré-requisitos","depth":2},{"value":"Visão geral do fluxo de dados","id":"visão-geral-do-fluxo-de-dados","depth":2},{"value":"Criar um link de consentimento","id":"criar-um-link-de-consentimento","depth":2},{"value":"Objeto de Termos","id":"objeto-de-termos","depth":3},{"value":"Compartilhe o link com seu cliente","id":"compartilhe-o-link-com-seu-cliente","depth":2},{"value":"O que seu cliente vê","id":"o-que-seu-cliente-vê","depth":2},{"value":"1. Bem-vindo","id":"1-bem-vindo","depth":3},{"value":"2. Confirme os dados pessoais e CLABE","id":"2-confirme-os-dados-pessoais-e-clabe","depth":3},{"value":"3. Revise e aceite a autorização","id":"3-revise-e-aceite-a-autorização","depth":3},{"value":"4. Aguarde o depósito","id":"4-aguarde-o-depósito","depth":3},{"value":"5. Insira o código e autorize","id":"5-insira-o-código-e-autorize","depth":3},{"value":"6. Autorização confirmada","id":"6-autorização-confirmada","depth":3},{"value":"Telas de erro","id":"telas-de-erro","depth":3},{"value":"Lidar com o redirecionamento para sua URL de callback","id":"lidar-com-o-redirecionamento-para-sua-url-de-callback","depth":2},{"value":"Ouça os webhooks e confirme o resultado","id":"ouça-os-webhooks-e-confirme-o-resultado","depth":2},{"value":"Testar links de consentimento no Sandbox","id":"testar-links-de-consentimento-no-sandbox","depth":2},{"value":"Escolha o resultado da validação da conta","id":"escolha-o-resultado-da-validação-da-conta","depth":3},{"value":"Insira o código de verificação","id":"insira-o-código-de-verificação","depth":3},{"value":"Testar outros status de link","id":"testar-outros-status-de-link","depth":3},{"value":"Referência de link de consentimento","id":"referência-de-link-de-consentimento","depth":2},{"value":"Status dos links de consentimento","id":"status-dos-links-de-consentimento","depth":3},{"value":"Etapas do link de consentimento","id":"etapas-do-link-de-consentimento","depth":3},{"value":"Gerenciar links de consentimento","id":"gerenciar-links-de-consentimento","depth":3},{"value":"Erros","id":"erros","depth":3}],"frontmatter":{"seo":{"title":"Coletar consentimento com links de consentimento"}},"lastModified":"2026-10-08T16:03:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/pt-br/products/payments_mexico/direct-debit-consent-links","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}