Payments API Brazil

This document covers how to use 360Dialog Message APIs to leverage dynamic PIX code for native payments in Brazil and create a bot flow for order management via Whatsapp channel.

O que é a Payments API Brazil?

Native Payments é a solução de pagamentos da Meta para o Brasil, que utiliza o PIX dentro da Cloud API do WhatsApp. Ela permite que empresas enviem uma solicitação de pagamento (com um código PIX dinâmico) diretamente em uma conversa no WhatsApp.

Benefícios:

• O usuário não precisa sair do WhatsApp para concluir a compra.

• Agiliza o checkout e reduz o abandono de carrinho.

• Funciona para compras em e-commerce, agendamento de serviços e pagamento de faturas.

Como funciona

1. Seleção do produto: O usuário recebe um catálogo de produtos pelo WhatsApp e escolhe o que deseja comprar.

2. Solicitação de pagamento: Após a escolha, a empresa envia um resumo do pedido com o código PIX dinâmico.

3. Pagamento fora do WhatsApp: O usuário copia o código PIX e realiza o pagamento pelo aplicativo do seu banco.

4. Atualização de status: A empresa acompanha o pagamento via seu próprio gateway e informa o status ao usuário no WhatsApp.

Observações importantes

• O fluxo com PIX funciona apenas com números de telefone brasileiros (da empresa e do usuário).

• A Meta não monitora o status do pagamento — isso deve ser feito pelo seu gateway de pagamento.

• A funcionalidade está disponível somente no Brasil por enquanto.

Assista a este vídeo com um exemplo de bot que permite ao usuário final selecionar um produto, pagar com código PIX dinâmico e receber a confirmação do pedido:

Payments API: Bot Demo

---

English

What it is Payments API Brazil?

Native Payments is Meta’s payment solution for Brazil that uses PIX within the WhatsApp Cloud API. It allows businesses to send a payment request (using a dynamic PIX code) directly in a WhatsApp chat.

Benefits:

• Users don’t need to leave WhatsApp to complete their purchase.

• Speeds up checkout, reduces cart abandonment.

• Works for e-commerce, service bookings, and invoice payments.

How it works

1. Product selection: The user receives a product catalog in WhatsApp and chooses what to buy.

2. Payment request: After the selection, the business sends an order summary with a dynamic PIX code.

3. Payment outside WhatsApp: The user copies the PIX code and completes payment via their banking app.

4. Status update: The business tracks the payment via its own payment gateway and updates the user via WhatsApp.

Important Notes:

• The PIX flow only works for Brazilian phone numbers (business + user).

• Meta does not track the payment status — this must be done through your own payment gateway.

• The feature is only available in Brazil for now.

Refer to this video for a sample bot that allows an end-user to select a product, use Dynamic PIX code for payment for an order, and receive an order status message at the end:

Payments API Brazil: Demo Bot.