Payments API (Brazil only)

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

Sobre a Payments API Brazil

Payments API Brazil (Native Payments Brazil) é a solução de pagamentos da Meta para o Brasil, que utiliza os meios de pagamento dentro da Cloud API do WhatsApp. Ela permite que empresas enviem uma solicitação de pagamento (como 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.

• Compatível com PIX, boleto, Link de Pagamento e Pagamento com um-clique

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 método de pagamento escolhido.

3

Pagamento fora do WhatsApp

O usuário copia o código PIX, obtém boleto, link de pagamento ou pagamento em um-clique e realiza o pagamento pelo aplicativo do 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?

Payments API Brazil (Native Payments Brazil) is Meta’s payment solution for Brazil, utilizing payment methods within the WhatsApp Cloud API. It allows businesses to send a payment request (using a dynamic PIX code, for example) 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.

• Compatibe with PIX code, boleto, payment link, and one-click payment

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 the chosen payment method.

3

Payment outside WhatsApp

The user copies the PIX code, gets boleto, payment link or one-click payment and completes payment via 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.