{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/smart_collections_brazil/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition"]},"type":"markdown"},"seo":{"title":"Statuses and webhooks","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":"statuses-and-webhooks","__idx":0},"children":["Statuses and webhooks"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Smart Collections is currently in Beta. Some contracts on this page are still being confirmed with our engineering team, so treat them as provisional and expect refinements before general availability, including:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook payloads and event codes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API reference updates for the Collection Instructions, Payment Authorization, and Charge endpoints"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Field names and documentation improvements (terminology, diagrams)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your Belvo account manager to join the Beta program."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page is the reference for the object statuses and webhooks used across both phases of Smart Collections. For the step-by-step flow, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/smart_collections_brazil/smart-collections-balance-checking","target":"_blank"},"children":["Phase 1"]}," and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/smart_collections_brazil/smart-collections-payments","target":"_blank"},"children":["Phase 2"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"statuses","__idx":1},"children":["Statuses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"collection-instruction","__idx":2},"children":["Collection Instruction"]},{"$$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":"30%","data-label":"Status"},"children":["Status "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PROCESSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Created. Belvo is monitoring (or has finished monitoring) its items. An instruction stays ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PROCESSING"]}," until you cancel it; check each item's status to see how monitoring ended."]}]},{"$$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":["You cancelled the instruction. Any items that were still being monitored were cancelled too."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"collection-instruction-item","__idx":3},"children":["Collection Instruction item"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE_SETTLED"]}," sends a webhook. To read the status of any item, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/smart_collections_brazil/smart-collections-balance-checking#check-the-status-of-your-items","target":"_blank"},"children":["get the instruction's details"]},"."]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"stateDiagram-v2\n [*] --> PENDING\n PENDING --> PROCESSING: a balance check starts\n PROCESSING --> PENDING: not enough funds yet\n PROCESSING --> CHARGE_SETTLED: enough funds, webhook sent\n PROCESSING --> POLICY_EXPIRED: no collection window left\n PROCESSING --> CHARGE_REJECTED: the account can't be read\n PENDING --> COMPLETED: you mark it complete\n PENDING --> CANCELLED: you cancel it\n PROCESSING --> CANCELLED: you cancel it\n","diagramHtml":"

a balance check starts

not enough funds yet

enough funds, webhook sent

no collection window left

the account can't be read

you mark it complete

you cancel it

you cancel it

PENDING

PROCESSING

CHARGE_SETTLED

POLICY_EXPIRED

CHARGE_REJECTED

COMPLETED

CANCELLED

"},"children":["stateDiagram-v2\n [*] --> PENDING\n PENDING --> PROCESSING: a balance check starts\n PROCESSING --> PENDING: not enough funds yet\n PROCESSING --> CHARGE_SETTLED: enough funds, webhook sent\n PROCESSING --> POLICY_EXPIRED: no collection window left\n PROCESSING --> CHARGE_REJECTED: the account can't be read\n PENDING --> COMPLETED: you mark it complete\n PENDING --> CANCELLED: you cancel it\n PROCESSING --> CANCELLED: you cancel it\n"]},{"$$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":"30%","data-label":"Status"},"children":["Status "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Waiting for the next scheduled balance check."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PROCESSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A balance check is in progress."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE_SETTLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The balance covered the item's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," and Belvo sent you ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]},". Monitoring stops. Despite its name, this status does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," mean a Charge was made: you create the Charge yourself in Phase 2."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POLICY_EXPIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All of the item's collection windows ended without enough balance. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No webhook is sent."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE_REJECTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Belvo couldn't read the balance of any of the user's accounts (for example, the data consent is no longer valid). ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No webhook is sent."]}]}]},{"$$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":["An internal error stopped monitoring. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No webhook is sent."]}]}]},{"$$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":["You ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/smart_collections_brazil/smart-collections-balance-checking#mark-an-item-as-complete","target":"_blank"},"children":["marked the item as complete"]}," (you collected it outside Belvo), so Belvo stopped monitoring it."]}]},{"$$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":["You cancelled the item (or its whole instruction)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-authorization-and-charge","__idx":4},"children":["Payment Authorization and Charge"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Phase 2 uses Smart Transfers Payment Authorizations and Charges. For their statuses, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/payments_brazil/payments-brazil-smart-transfers-api-guide#statuses-reference","target":"_blank"},"children":["Smart Transfers statuses reference"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhooks","__idx":5},"children":["Webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Smart Collections uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["two webhook channels"]},". You must configure an endpoint on each."]},{"$$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":"Channel"},"children":["Channel "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"12%","data-label":"Phase"},"children":["Phase "]},{"$$mdtype":"Tag","name":"th","attributes":{"width":"33%","data-label":"Events"},"children":["Events "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Versioning"},"children":["Versioning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aggregation (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COLLECTIONS"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phase 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None (aggregation webhooks are unversioned)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phase 2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_AUTHORIZATION"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payments-BR.V2"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"phase-1-item_ready_to_charge-aggregation","__idx":6},"children":["Phase 1: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]}," (Aggregation)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sent once, when the balance of one of the user's accounts covers an item's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},". The item moves to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE_SETTLED"]}," and Belvo stops monitoring it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"item_ready_to_charge webhook","header":{"title":"item_ready_to_charge webhook","controls":{"copy":{}}},"source":"{\n \"webhook_id\": \"e29b41d4a7164a4fae1112b8c9d3f5a2\",\n \"webhook_type\": \"COLLECTIONS\",\n \"webhook_code\": \"item_ready_to_charge\",\n \"process_type\": null,\n \"link_id\": \"3fa85f64-5717-4562-b3fc-2c963f66afa6\", // [!code warning]\n \"external_id\": null,\n \"data\": {\n \"item_id\": \"b2c3d4e5-f6a7-8901-bcde-f12345678901\",\n \"external_id\": \"inv-2026-001\",\n \"amount\": \"150.50\"\n }\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":"30%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A unique ID for this webhook delivery. Use it to detect and discard duplicate deliveries."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COLLECTIONS"]}," for this event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]}," for this event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["process_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for this event."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["link_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of the OFDA Link this Collection Instruction monitors."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for this event. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.external_id"]}," instead."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.item_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of the Collection Instruction item whose balance condition was met."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.external_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_id"]}," you set on that item, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," if you didn't set one."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The item's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},": what you should collect in Phase 2, as a string."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Identifies the item, not the account or the policy"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payload tells you which ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["item"]}," matched, but not which of the user's accounts had the balance, nor which ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["collection_policy"]}," window was open. To charge a specific account, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/products/smart_collections_brazil/smart-collections-payments","target":"_blank"},"children":["Phase 2"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer_resources/resources-webhooks-aggregation","target":"_blank"},"children":["Aggregation Webhooks"]}," for the general Aggregation webhook envelope."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"No webhook when monitoring ends without funds"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Items that end in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POLICY_EXPIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE_REJECTED"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}," don't trigger a webhook. Track your items' last ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," and reconcile any that never produced an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"phase-2-payment_authorization-and-charge-payments","__idx":7},"children":["Phase 2: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAYMENT_AUTHORIZATION"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHARGE"]}," (Payments)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are standard ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payments-BR.V2"]}," webhooks. They only tell you that a resource changed, so you ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," the resource to read its status:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Payments V2 webhook","header":{"title":"Payments V2 webhook","controls":{"copy":{}}},"source":"{\n \"schema_version\": \"2.0.0\",\n \"resource\": \"CHARGE\",\n \"resource_id\": \"0d3ffb69-f83b-456e-ad8e-208d0998d71d\",\n \"resource_version\": \"V2\",\n \"timestamp\": \"2026-10-16T15:00:07Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the payload format and how to fetch full details, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer_resources/resources-webhooks-payments-brazil","target":"_blank"},"children":["Payments Webhooks (Brazil)"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"webhook-reliability","__idx":8},"children":["Webhook reliability"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Separate settings per channel:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COLLECTIONS"]}," webhooks are configured separately from Payments webhooks in the Belvo dashboard, each with its own URL and optional Bearer token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication:"]}," Belvo doesn't sign webhooks (no HMAC). Restrict your endpoint with an IP allowlist of Belvo's IPs, and optionally set a Bearer token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Retries:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["item_ready_to_charge"]}," is retried up to three times only when Belvo can't connect to your endpoint, so make sure your endpoint is reachable and responds quickly. For Payments webhook retries, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer_resources/resources-webhooks-payments-brazil","target":"_blank"},"children":["Payments Webhooks (Brazil)"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ordering:"]}," webhooks can arrive out of order or very close together. Because Payments webhooks don't carry the status, doing a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," per webhook keeps your view of the status correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recovering missed events:"]}," there is no event replay. Run a recurring task that checks authorizations and Charges that aren't yet in a final status, and Collection Instruction items you're still waiting on."]}]}]},"headings":[{"value":"Statuses and webhooks","id":"statuses-and-webhooks","depth":1},{"value":"Statuses","id":"statuses","depth":2},{"value":"Collection Instruction","id":"collection-instruction","depth":3},{"value":"Collection Instruction item","id":"collection-instruction-item","depth":3},{"value":"Payment Authorization and Charge","id":"payment-authorization-and-charge","depth":3},{"value":"Webhooks","id":"webhooks","depth":2},{"value":"Phase 1: item_ready_to_charge (Aggregation)","id":"phase-1-item_ready_to_charge-aggregation","depth":3},{"value":"Phase 2: PAYMENT_AUTHORIZATION and CHARGE (Payments)","id":"phase-2-payment_authorization-and-charge-payments","depth":3},{"value":"Webhook reliability","id":"webhook-reliability","depth":3}],"frontmatter":{"seo":{"title":"Statuses and webhooks"}},"lastModified":"2026-10-20T20:55:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/smart_collections_brazil/smart-collections-statuses-and-webhooks","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}