Resumo

Quer otimizar os pagamentos no WhatsApp? O Modelo de Botão de Checkout (Checkout Button Template) do Facebook facilita para as empresas receberem pagamentos diretamente no chat. Este guia oferece uma visão geral rápida de como esses modelos funcionam com a WhatsApp Cloud API, para que você possa começar a oferecer uma experiência de checkout simplificada aos seus clientes.

Instruções

O Modelo de Botão de Checkout é um recurso da WhatsApp Cloud API que permite incorporar um botão de Pagar Agora ou Comprar Agora diretamente em uma mensagem. Ao ser tocado, o botão abre uma experiência de pagamento segura para que o cliente possa concluir a compra com apenas alguns cliques.

O que você precisa para começar

Antes de usar os modelos de botão de checkout, certifique-se de que você possui:

  • Uma Conta Comercial do WhatsApp (WABA) verificada

  • Acesso à WhatsApp Cloud API

  • Uma conta de pagamento Meta (configurada via Meta Commerce Manager)

  • Uma vitrine hospedada ou experiência de pagamento (via Meta ou provedor terceirizado)

Como funcionam os modelos de botão de checkout

O botão de checkout é enviado usando um modelo de mensagem que inclui:

  • Cabeçalho: Opcional, pode incluir texto ou mídia

  • Corpo: Descreve o produto ou a solicitação de pagamento

  • Botão: Aciona o fluxo de checkout quando tocado

Assim que o cliente toca no botão, ele será direcionado para uma experiência de pagamento pré-configurada. Isso pode ser uma página de checkout único ou vinculada a um produto ou carrinho específico.

Principais benefícios

  • Compras mais rápidas: Os clientes não precisam sair do WhatsApp para pagar

  • Melhor engajamento: Reduz desistências durante o checkout

  • Transações seguras: Os pagamentos são processados por meio da infraestrutura verificada da Meta

Exemplos de uso

  • Compartilhar uma mensagem de “Pagar Agora” após a confirmação do pedido

  • Enviar um link de pagamento para pré-vendas ou assinaturas

  • Habilitar recompras rápidas para clientes recorrentes

Endpoint

POST https://{your-account-endpoint}/api/v1/checkout_button_template

O endpoint checkout_button_template permite incorporar um botão de Pagar Agora ou Comprar Agora diretamente em uma mensagem. Ao ser tocado, o botão abre uma experiência de pagamento segura para que o cliente possa concluir a compra com apenas alguns cliques.

Nota: Este endpoint de API está disponível atualmente em Beta Privado e é acessível apenas para clientes selecionados. Entre em contato com a equipe de Suporte da Wati caso precise de acesso.

Passo 1: Localize o seu endpoint de API

Você pode encontrar seu endpoint de API específico em sua conta Wati. Vá para Connectors (Conectores) > API Tokens. Ele terá um aspecto semelhante a este: https://live-mt-server.wati.io

Seu endpoint final para enviar o pedido será:

POST https://{your-account-endpoint}/api/v1/checkout_button_template

Aqui está a lista de parâmetros para este endpoint:

phone_number : Este é o número de telefone do destinatário da mensagem.

template_name : É o nome do modelo que você criou.

custom_params : Depende das variáveis presentes no modelo.

order_details : A quantidade em order_details deve ser a mesma que o número de cartões de carrossel no modelo.

reference_id : Este é um ID exclusivo para cada pedido.

Passo 2: Como enviar o Modelo de Botão de Checkout usando o endpoint da API

Aqui está um exemplo de payload para um checkout_button_template com 3 cartões de carrossel:

Exemplo de payload


curl --request POST \
--url 'https://live-mt-server.wati.io/{tenantId}/api/v1/checkout_button_template' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"phone_number": "918606328257",
"template_name": "checkout_button_template_yzn_1",
"custom_params": [
{
"name": "name",
"value": "TEST_NAME"
}
],
"order_details": [
{
"reference_id": "yzn-test-7",
"type": "physical-goods",
"currency": "INR",
"payment_settings": [
{
"type": "payment_gateway",
"payment_gateway": {
"type": "razorpay",
"configuration_name": "razorpay_test_payment_2"
}
}
],
"shipping_info": {
"country": "IN",
"addresses": [
{
"name": "Nidhi Tripathi",
"phone_number": "919000090000",
"address": "Bandra Kurla Complex",
"city": "Mumbai",
"state": "Maharashtra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"name": "Blue Elf Aloe",
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"importer_address": {
"address_line1": "One BKC",
"address_line2": "Bandra Kurla Complex",
"city": "Mumbai",
"zone_code": "MH",
"postal_code": "400051",
"country_code": "IN"
}
}
],
"subtotal": {
"offset": 100,
"value": 150
},
"shipping": {
"offset": 100,
"value": 20
},
"tax": {
"offset": 100,
"value": 10
},
"discount": {
"offset": 100,
"value": 15,
"description": "Additional 10% off"
},
"status": "pending",
"expiration": {
"timestamp": "1726627150",
"description": "description"
}
},
"total_amount": {
"offset": 100,
"value": 165
}
},
{
"reference_id": "yzn-test-8",
"type": "physical-goods",
"currency": "INR",
"payment_settings": [
{
"type": "payment_gateway",
"payment_gateway": {
"type": "razorpay",
"configuration_name": "razorpay_test_payment_2"
}
}
],
"shipping_info": {
"country": "IN",
"addresses": [
{
"name": "Nidhi Tripathi",
"phone_number": "919000090000",
"address": "Bandra Kurla Complex",
"city": "Mumbai",
"state": "Maharashtra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"name": "Blue Elf Aloe",
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"importer_address": {
"address_line1": "One BKC",
"address_line2": "Bandra Kurla Complex",
"city": "Mumbai",
"zone_code": "MH",
"postal_code": "400051",
"country_code": "IN"
}
}
],
"subtotal": {
"offset": 100,
"value": 150
},
"shipping": {
"offset": 100,
"value": 20
},
"tax": {
"offset": 100,
"value": 10
},
"discount": {
"offset": 100,
"value": 15,
"description": "Additional 10% off"
},
"status": "pending",
"expiration": {
"timestamp": "1726627150",
"description": "description"
}
},
"total_amount": {
"offset": 100,
"value": 165
}
},
{
"reference_id": "yzn-test-9",
"type": "physical-goods",
"currency": "INR",
"payment_settings": [
{
"type": "payment_gateway",
"payment_gateway": {
"type": "razorpay",
"configuration_name": "razorpay_test_payment_2"
}
}
],
"shipping_info": {
"country": "IN",
"addresses": [
{
"name": "Nidhi Tripathi",
"phone_number": "919000090000",
"address": "Bandra Kurla Complex",
"city": "Mumbai",
"state": "Maharashtra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"name": "Blue Elf Aloe",
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"importer_address": {
"address_line1": "One BKC",
"address_line2": "Bandra Kurla Complex",
"city": "Mumbai",
"zone_code": "MH",
"postal_code": "400051",
"country_code": "IN"
}
}
],
"subtotal": {
"offset": 100,
"value": 150
},
"shipping": {
"offset": 100,
"value": 20
},
"tax": {
"offset": 100,
"value": 10
},
"discount": {
"offset": 100,
"value": 15,
"description": "Additional 10% off"
},
"status": "pending",
"expiration": {
"timestamp": "1726627150",
"description": "description"
}
},
"total_amount": {
"offset": 100,
"value": 165
}
}
]
}'

Como criar um Modelo de Botão de Checkout no Wati

Este guia orienta você pelas etapas para criar o Modelo de Botão de Checkout com apenas alguns cliques:

1. Faça login na sua conta Wati.

2. Vá para Campaigns (Campanhas) e selecione Template Messages (Modelos de Mensagem).

3. Clique em New Template Message (Novo Modelo de Mensagem).

4. Insira um nome para o seu modelo para que você possa encontrá-lo facilmente mais tarde.

5. Em Category (Categoria), escolha Marketing.

6. Selecione o idioma que você deseja que o modelo tenha.

7. Em Select Marketing Template (Selecionar Modelo de Marketing), escolha Checkout Template (Modelo de Checkout).

8. Insira o conteúdo do corpo - esta é a mensagem principal que seu cliente verá.

9. Adicione cartões de carrossel de acordo com suas necessidades.

Nota:

  • Você pode adicionar até 5 cartões.

  • Para cada cartão, você pode adicionar uma imagem ou um vídeo.

  • Você pode inserir botões para cada cartão para que seus clientes possam realizar ações e interagir.

Did this answer your question?