Resumen
¿Quieres agilizar los pagos en WhatsApp? La plantilla de botón de pago de Facebook facilita que las empresas reciban pagos directamente en el chat. Esta guía te ofrece una visión general rápida de cómo funcionan estas plantillas con la WhatsApp Cloud API, para que puedas empezar a ofrecer una experiencia de pago fluida a tus clientes.
Instrucciones
La plantilla de botón de pago (Checkout Button Template) es una función de la WhatsApp Cloud API que te permite integrar un botón de Pagar ahora o Comprar ahora directamente en un mensaje. Al tocarlo, el botón abre una experiencia de pago segura para que el cliente pueda completar su compra con solo unos clics.
Lo que necesitas para empezar
Antes de usar las plantillas de botones de pago, asegúrate de tener:
Una cuenta de WhatsApp Business verificada (WABA)
Acceso a la WhatsApp Cloud API
Una cuenta de pago de Meta (configurada a través de Meta Commerce Manager)
Una tienda alojada o experiencia de pago (a través de Meta o de un proveedor externo)
Cómo funcionan las plantillas de botones de pago
El botón de pago se envía utilizando una plantilla de mensaje que incluye:
Encabezado: Opcional, puede incluir texto o medios
Cuerpo: Describe el producto o la solicitud de pago
Botón: Activa el flujo de pago cuando se toca
Una vez que el cliente toca el botón, será redirigido a una experiencia de pago preconfigurada. Esta puede ser una página de pago único o estar vinculada a un producto o carrito específico.
Beneficios clave
Compras más rápidas: Los clientes no necesitan salir de WhatsApp para pagar
Mejor interacción: Reduce el abandono durante el proceso de pago
Transacciones seguras: Los pagos se gestionan a través de la infraestructura verificada de Meta
Casos de uso de ejemplo
Compartir un mensaje de "Pagar ahora" después de la confirmación del pedido
Enviar un enlace de pago para pedidos anticipados o suscripciones
Habilitar pedidos rápidos para clientes recurrentes
Endpoint
POST https://{your-account-endpoint}/api/v1/checkout_button_template
El endpoint checkout_button_template te permite integrar un botón de Pagar ahora o Comprar ahora directamente en un mensaje. Al tocarlo, el botón abre una experiencia de pago segura para que el cliente pueda completar su compra con solo unos clics.
Nota: Este endpoint de la API se encuentra actualmente en Beta privada y solo es accesible para clientes seleccionados. Contacta al equipo de soporte de Wati si necesitas acceso.
Paso 1: Localiza tu endpoint de API
Puedes encontrar tu endpoint de API específico en tu cuenta de Wati. Ve a Connectors > API Tokens. Se verá algo así: https://live-mt-server.wati.io
Tu endpoint final para enviar el pedido será:
POST https://{your-account-endpoint}/api/v1/checkout_button_template
Aquí tienes la lista de parámetros para este endpoint:
phone_number : Este es el número de teléfono del destinatario del mensaje.
template_name : Es el nombre de la plantilla que creaste.
custom_params : Esto depende de las variables en la plantilla.
order_details : La cantidad de order_details debe ser la misma que la cantidad de tarjetas de carrusel en la plantilla.
reference_id : Este es un ID único para cada pedido.
Paso 2: Cómo enviar la plantilla de botón de pago usando el endpoint de la API
Aquí tienes una carga útil de ejemplo (payload) para una checkout_button_template con 3 tarjetas de carrusel:
Carga útil de ejemplo
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
}
}
]
}'
Cómo crear una plantilla de botón de pago en Wati
Esta guía te guía por los pasos para crear la plantilla de botón de pago en unos pocos clics:
1. Inicia sesión en tu cuenta de Wati.
2. Ve a Campaigns y selecciona Template Messages.
3. Haz clic en New Template Message.
4. Ingresa un nombre para tu plantilla para que puedas encontrarla fácilmente más tarde.
5. En Category, elige Marketing.
6. Selecciona el idioma en el que quieres que esté la plantilla.
7. En Select Marketing Template, elige Checkout Template.
8. Ingresa tu body content: este es el mensaje principal que verá tu cliente.
9. Agrega tarjetas de carrusel según tus requisitos.
Nota:
Puedes agregar hasta 5 tarjetas.
Para cada tarjeta, puedes agregar una imagen o un video.
Puedes insertar botones para cada tarjeta para que tus clientes puedan tomar medidas e interactuar.
Did this answer your question?