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?