支付链接
Quick Reference
WhatAPI 生成的支付 URL
Why无需嵌入结账代码即可全渠道分发
Difficulty初级
Prerequisites身份验证 → 钱包
支付链接生成可打开 A55 结账的可分享 URL——适合发票、客服协助销售与轻量店铺且无需嵌入式 SDK。
为何使用支付链接
| 收益 | 说明 |
|---|---|
| 代码最少 | 从 API（应用程序编程接口）或控制台生成链接 |
| 全渠道 | WhatsApp、邮件、短信、社交 |
| 托管结账 | 与标准结账相同的方式 |
| 单次或复用 | is_checkout 控制行为 |
创建链接
POST https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/
Authorization: Bearer $ACCESS_TOKEN
响应返回指向 https://pay.a55.tech/checkout/{uuid} 的 url（确切路径以 API 响应为准）。
分发
- 邮件——嵌入发票与提醒。
- WhatsApp / SMS——粘贴 HTTPS 链接。
- 社交——在活动中发布链接。
- QR code——为店内或印刷品编码 URL。
is_checkout 标志
| 值 | 行为 |
|---|---|
true | 单次使用，结账式流程 |
false | 撤销前可复用 |
运营细节
请与集成经理确认过期、最大兑换次数与幂等规则——可能因产品配置而异。
示例
- cURL
- JSON 请求体
curl -sS -X POST 'https://core-manager.a55.tech/api/v1/bank/wallet/payment-link/' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 10000,
"currency": "BRL",
"is_checkout": true
}'
{
"wallet_uuid": "00000000-0000-4000-8000-000000000001",
"amount": 10000,
"currency": "BRL",
"is_checkout": true
}
与 SDK 嵌入
A55Pay.open({ checkoutUuid: '<uuid-from-payment-link>' });
安全分享
仅使用 HTTPS。勿在公开渠道粘贴密钥或预授权令牌。