Ir al contenido principal

Cómo usar la plantilla de botón de pago API

Actualizado hace más de 2 semanas

Resumen

¿Quieres agilizar los pagos en WhatsApp? La Plantilla de Botón de Pago de Facebook facilita que las empresas recolecten pagos directamente en el chat. Esta guía te brinda una visión general de cómo funcionan estas plantillas con la API de WhatsApp Cloud, para que puedas ofrecer una experiencia de checkout fluida a tus clientes.

Instrucciones

La Plantilla de Botón de Pago es una funcionalidad de la API de WhatsApp Cloud que te permite incorporar 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 en solo unos pocos 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)

  • Una cuenta de pago de Meta (configurada mediante Meta Commerce Manager)

  • Una tienda en línea o experiencia de pago hospedada (a través de Meta o proveedor de terceros)

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 solicitud de pago

  • Botón: Inicia el flujo de pago al hacer clic

Una vez que el cliente haga clic en el botón, será dirigido a una experiencia de pago preconfigurada. Esto puede ser una página de pago única o 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 engagement: Reduce las deserciones durante el pago

  • Transacciones seguras: Los pagos se gestionan mediante la infraestructura verificada de Meta

Casos de uso

  • Compartir un mensaje "Pagar ahora" después de la confirmación del pedido

  • Enviar un enlace de pago para pre-órdenes 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 permite incrustar directamente un botón de Pagar ahora o Comprar ahora en un mensaje. Al hacer clic, el botón abre una experiencia de pago segura para que el cliente pueda completar su compra en solo unos pocos clics.

Paso 1: Buscar tu endpoint de API

Puedes encontrar tu endpoint de API específico en la sección /api-docs de tu cuenta de Wati. Se verá algo así: https://live-server-xxxx.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 detalles del pedido debe ser la misma que el número 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 API

Aquí tienes un ejemplo de carga útil para un checkout_button_template con las 3 tarjetas de carrusel:

Ejemplo de carga útil

curl --location 'https://mt-dev-gke-server.watiapp.io/103128/api/v1/checkout_
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqd
--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": "Maharastra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"name": "Blue Elf Aloe"
,
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"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": "Maharastra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"name": "Blue Elf Aloe"
,
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"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": "Maharastra",
"in_pin_code": "400051",
"house_number": "12",
"tower_number": "5",
"building_name": "One BKC",
"landmark_area": "Near BKC Circle"
}
]
},
"order": {
"items": [
{
"amount": {
"offset": 100,
"value": 200
},
"sale_amount": {
"offset": 100,
"value": 150
},
"name": "Blue Elf Aloe"
,
"quantity": 1,
"country_of_origin": "India",
"importer_name": "Lucky Shrub Imports and Exports",
"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 lleva paso a paso a través de los pasos para crear la Plantilla de Botón de Pago en pocos clics:

1. Inicia sesión en tu cuenta de Wati.

2. Ve a Transmisiones y selecciona Tus Plantillas.

3. Haz clic en Nuevo Mensaje de Plantilla.

4. Ingresa un nombre para tu plantilla para que puedas encontrarla fácilmente más tarde.

5. En Categoría, elige Marketing.

6. Selecciona el idioma en el que quieres que la plantilla esté.

7. En Seleccionar Plantilla de Marketing, elige Plantilla de Pago.

8. Ingresa tu contenido del cuerpo - este es el mensaje principal que verá tu cliente.

9. Agrega tarjetas de carrusel según tus necesidades.

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 acciones e interactuar.

¿Ha quedado contestada tu pregunta?