# Payments API - Brazil | Developer Documentation

<div id="bkmrk-payments-api---brazi">## Payments API - Brazil

<div><span>Updated: Nov 14, 2025</span></div><div>Payments API enable businesses to accept payments from their customers via WhatsApp. Businesses send `order_details` messages ([Orders API](/books/meta-whatsapp/page/orders-developer-documentation)) to their customers, then get notified about payment status updates via webhook notifications.</div><div>Based on the selected use case, businesses can collect payment from the customers using one of the following integrations:</div>
<span>[Dynamic Pix Codes](/books/meta-whatsapp/page/offsite-pix-payments-developer-documentation)</span><span>[Payment Links](/books/meta-whatsapp/page/payment-links-developer-documentation)</span><span>[Boleto](/books/meta-whatsapp/page/boleto-developer-documentation)</span><span>[One-click offsite card payment](/books/meta-whatsapp/page/one-click-payments-developer-documentation)</span><span>[Order Details Template](/documentation/business-messaging/whatsapp/payments/payments-br/orderdetailstemplate)</span><div id="bkmrk-how-it-works"><div id="bkmrk-how-it-works-1"><div>### How It Works

</div></div></div><div>First, the business composes and sends an `order_details` message, which is a new type of interactive message. It contains the same 4 main components: header, body, footer, and action. Inside the action component, the business includes all the information needed for the customer to complete their payment.</div><div>Each `order_details` message **must** contain a **unique `reference_id`** provided by the business. This reference id is used throughout the flow to track the order.</div><div>Once the message is sent, the business waits for a payment or transaction status update. The type of the update depends on the integration type (e.g.: [Pix](/books/meta-whatsapp/page/offsite-pix-payments-developer-documentation), [Payment Links](/books/meta-whatsapp/page/payment-links-developer-documentation), etc.). WhatsApp does **NOT** support payment reconciliations. The business must reconcile the payment with their payment service provider (PSP) using the `reference_id` of the order.</div><div id="bkmrk-purchase-flow-in-app"><div id="bkmrk-purchase-flow-in-app-1"><div>### Purchase Flow in App

</div></div></div><div>In the WhatsApp customer app, the purchase flow has the following steps:</div>
<span>Buyers communicate with businesses and select a product.</span><span>Businesses send an `order_details` message to the buyer.</span><span>Buyers pay the order. For Pix, they will switch to their bank app and use the Pix Copy and Paste functionality. For Payment Links, the payment/checkout link opens in the web browser, and they complete the payment there.</span><span>Businesses send an `order_status` message indicating that the order is now `processing`.</span></div>