摘要
想要简化 WhatsApp 上的支付流程?Facebook 的“结账按钮模板”(Checkout Button Template) 让商家能够直接在聊天中收取款项。本指南将简要介绍这些模板如何与 WhatsApp Cloud API 配合使用,助您开始为客户提供无缝的结账体验。
说明
“结账按钮模板”是 WhatsApp Cloud API 的一项功能,允许您将 “立即支付”或“立即购买” (Pay Now or Buy Now) 按钮直接嵌入消息中。点击该按钮后,系统会打开一个安全的支付界面,客户只需点击几下即可完成购买。
入门须知
在使用结账按钮模板之前,请确保您已具备以下条件:
经过验证的 WhatsApp Business Account (WABA)
访问 WhatsApp Cloud API 的权限
一个 Meta 支付账户(通过 Meta Commerce Manager 设置)
一个托管的店面或支付体验(通过 Meta 或第三方提供商)
结账按钮模板的工作原理
结账按钮通过包含以下内容的消息模板发送:
页眉 (Header):可选,可包含文本或媒体
正文 (Body):描述产品或支付请求
按钮 (Button):点击后触发结账流程
客户点击按钮后,将被引导至预先配置的支付界面。这可以是单次结账页面,也可以链接到特定的产品或购物车。
主要优势
更快的购买速度:客户无需离开 WhatsApp 即可完成支付
更好的参与度:减少结账过程中的用户流失
安全交易:通过 Meta 的验证基础设施处理支付
示例用例
在订单确认后分享“立即支付”消息
为预购或订阅服务发送支付链接
为回头客启用快速复购
端点
POST https://{your-account-endpoint}/api/v1/checkout_button_template
checkout_button_template 端点允许您将 “立即支付”或“立即购买” 按钮直接嵌入消息中。点击该按钮后,系统会打开一个安全的支付界面,客户只需点击几下即可完成购买。
注意:此 API 端点目前处于 Private Beta(私有测试)阶段,仅对受邀客户开放。如果您需要访问权限,请联系 Wati 支持团队。
第 1 步:找到您的 API 端点
您可以在您的 Wati 账户中找到具体的 API 端点。前往 Connectors(连接器)> API Tokens(API 令牌)。它看起来像这样:https://live-mt-server.wati.io
您发送订单的最终端点将是:
POST https://{your-account-endpoint}/api/v1/checkout_button_template
以下是此端点的参数列表:
phone_number:消息接收者的电话号码。
template_name:您创建的模板名称。
custom_params:取决于模板中的变量。
order_details:order_details 的数量应与模板中轮播卡片的数量相同。
reference_id:每个订单的唯一 ID。
第 2 步:如何通过 API 端点发送结账按钮模板
以下是带有 3 张轮播卡片的 checkout_button_template 示例负载:
示例负载
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
}
}
]
}'
如何在 Wati 中创建结账按钮模板
本指南将引导您完成通过几个步骤创建“结账按钮模板”的过程:
1. 登录您的 Wati 账户。
2. 前往 Campaigns(营销活动)并选择 Template Messages(模板消息)。
3. 点击 New Template Message(新建模板消息)。
4. 输入模板的 名称,以便日后轻松查找。
5. 在 Category(类别)下,选择 Marketing(营销)。
6. 选择您希望模板使用的 语言。
7. 在 Select Marketing Template(选择营销模板)下,选择 Checkout Template(结账模板)。
8. 输入您的 正文内容 - 这是您的客户将看到的主要消息。
9. 根据您的要求添加轮播卡片。
注意:
您最多可以添加 5 张卡片。
对于每张卡片,您可以添加一张图片或一段视频。
您可以为每张卡片插入按钮,以便您的客户可以采取行动并进行互动。
Did this answer your question?