支付宝 Plus 支付 #
支付宝 Plus 是来自中国的数字钱包,为东南亚和中国的用户提供服务。支付宝 Plus 用户可以使用登录凭证或支付宝 Plus 支持的特定应用程序在网上或移动设备上进行支付。
特点 #
客户所在地
- 中国消费者
- 海外华人
- 中国游客
- 东南亚消费者
预付货币
CNY, HKD, GBP, IDR, MR, PHP, THB
钱包清单
- 支付宝香港
- 达纳
- TNG
- BPI
- Rabbit LINE Pay
- GCash
- Boost
- Akulaku PayLater
禁止经营类别
WooshPay 和 Alipay Plus 都有一份禁止使用其服务的企业名单。要在 WooshPay 上使用支付宝 Plus,您的企业不能被限制使用 Stripe 或出现在支付宝的禁止企业名单上。如果您不确定您的企业是否属于被禁企业,或对这些要求如何适用于您有疑问,请联系 [email protected]。
服务器到服务器集成 #
使用支付宝 Plus,客户可以从您的网站或应用程序跳转付款,通过不同的钱包授权付款,然后返回您的网站或应用程序,您会立即收到付款成功或失败的通知。
概述 #
如果要直接集成 API,只需一步就能创建付款意向并获取网址,以下是创建付款意向的演示:
- 创建付款意向
- 退款
- 网络钩子
1.创建 PaymentIntent #
PaymentIntent 是一个对象,代表您向客户收款的意图,并跟踪付款流程的生命周期。在服务器上创建 PaymentIntent,并指定收款金额和支持的货币。如果您已有 Payment Intents 集成,请将 alipayplus 添加到支付方式类型列表中。
{
"金额":200、
"货币": "IDR", //不同的货币可能导致不同的钱包
"确认":true、
"付款方式":{
"alipayplus":{
"终端类型": "WEB
}
},
"支付方式数据":{
"类型": "支付宝plus"
},
"return_url": "https://wooshpay.com"
}
回应
{
"id":"pi_1646355176136638464",
"对象":"payment_intent"、
"创建":1681356636000,
"货币":"IDR"、
"金额":200,
"status":"requires_action"、
"livemode": true、
"client_secret": "pi_1646355176136638464_secret_gxkV1LYb76c2nFvtzDmHevyw",
"next_action":{
"alipayplus_handle_redirect":{
"normalUrl":"https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040092tDht8YNMR2t2u648Mu5v476I"
}
},
"payment_method_types":[
"支付宝"、
"微信支付"、
卡"、
"支付宝plus
],
"确认方式":"自动"、
"付款方式选项":{
"alipayplus":{
"terminal_type":"WEB
}
},
"return_url":"https://wooshpay.com"、
"payment_method":"pm_1646355176006615040",
"capture_method":自动
}
从 下一个行动
打开链接后,客户会看到不同货币的钱包,客户可以扫描二维码或登录钱包,选择想要支付的货币。
2.退款 #
您可以使用 API 或控制面板部分或全部退还任何成功付款。要查看所有退款列表,请访问控制面板中的退款支付页面。
要使用 API 退款,请创建一个退款,提供 PaymentIntent。
要求 创建退款
{
"reason": "requested_by_customer"、
"payment_intent":"pi_1575055712604651520"
}
回应
{
"id":"re_1575092157281206272",
"对象": "退款
"created":1664366209000,
"金额":20、
"货币": "人民币
"元数据":null、
"reason": "requested_by_customer"、
"状态": "成功
"description":空、
"payment_intent":"pi_1575055712604651520",
"失败原因":空
}
3.网络钩子 #
监听 WooshPay 账户上的事件,以便您的集成可以自动触发反应。创建一个网络钩子,主要关注 启用的事件
与 网址
.
接收网络钩子的步骤:
- 确定要监控的事件和要解析的事件有效载荷。
- 在本地服务器上创建一个 Webhook 端点,作为 HTTP 端点(URL)。
- 测试 webhook 端点是否正常工作,并查看是否收到回调。
要求
{
"url": "https://apitest.wooshpay.com/v1/receives"、
"description": "I_am_description"、
"enabled_events":[
"payment_intent.created"、
"payment_intent.payment_failed"、
"付款成功"、
"收费.退款.更新
],
"api_version":"1.0.1"
}
回应
{
"id":"we_1575093135514533888",
"对象": "webhook_endpoint"、
"created":1664366442000,
"description": "I_am_description"、
"元数据":null、
"status": "enabled"、
"url": "https://apitest.wooshpay.com/v1/receives"、
"livemode":false、
"api_version":"1.0.1",
"enabled_events":[
"payment_intent.created"、
"payment_intent.payment_failed"、
"付款成功"、
"收费.退款.更新
]
}
跳转收银台 #
要支持 Alipayplus 支付,结账会话必须满足以下所有条件:
- 所有细列项目的价格必须使用同一种货币。
如果有不同货币的项目,请为每种货币创建单独的结账会话。 - 只能使用一次性细列项目。
启用 Alipayplus 作为支付方式 #
创建新的结账会话时,您需要
将 Alipayplus 添加到 付款方式类型
.
确保所有 行项目
使用相同的货币。
要求 创建会话
{
"cancel_url":"www.baide.com"、
"模式":"付款"、
"success_url":"www.wooshpay.com"、
"payment_method_options":{ //add alipayplus as payment method
"alipayplus":{
"terminal_type":"WEB
}
},
"行项目":[
{
"price_data":{
"currency":"GBP"、
"product": null、
"unit_amount":5,
"active": true、
"元数据":{
"key1":"value1"、
"key2":"value2"
},
"昵称":"fengli"、
"product_data":{
"id": null、
"名称":"taiwan fengli"、
"active": true、
"description":"非常美味"、
"元数据{
"key1":"value1"、
"key2":"value2"
},
"url":"www.baidu.com"
},
"billing_scheme":"testscheme"、
"lookup_key":"test_lookup_key
},
"数量":1
}
]
}
回应
{
"id":"cs_1597163428114333696",
"对象":"checkout.session"、
"创建":1669628410000,
"currency":"GBP"、
"客户":"",
"模式":"付款"、
"livemode": true、
"shipping": null、
"状态":"open"、
"url":"https://checkout.wooshpay.com/pay/cs_1597163428114333696?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo="、
"cancel_url":"www.baidu.com"、
"client_reference_id": null、
"customer_email": null、
"line_items":{
"对象":"list"、
"数据": [[
{
"id":"li_1597163428139499520",
"对象":"项目"、
"货币":"GBP"、
"description":"taiwan fengli"、
价格{
"id":"price_1597163428152082432",
"对象":"价格"、
"创建":1669628410000,
"active": true、
"currency":"GBP"、
"元数据":{
"key1":"value1"、
"key2":"value2"
},
"昵称":"fengli"、
"产品":{
"id":"prod_1597163428164665344",
"对象":"产品"、
"创建":1669628410000,
"active": true、
"description":"非常美味"、
"元数据":{
"key1":"value1"、
"key2":"value2"
},
"名称":"taiwan fengli"、
"livemode": true、
"url":"www.baidu.com"、
"更新":1669628410000,
"images": null
},
"类型":"one_time"、
"livemode": true、
"unit_amount":5,
"billing_scheme":"per_unit"、
"lookup_key":"test_lookup_key
},
"数量":1,
"amount_subtotal": 5、
"amount_total": 5
}
],
"url": null、
"has_more": null
},
"payment_intent":"pi_1597163428336631808",
"payment_method_types": null、
"payment_status":"unpaid"、
"success_url":"www.wooshpay.com"、
"amount_subtotal": 5、
"amount_total": 5、
"billing_address_collection":"auto"、
"expires_at":1669714809783,
"payment_link":"",
"payment_method_options": null、
"phone_number_collection": null、
"shipping_address_collection": null、
"client_secret": "pi_1597163428336631808_secret_pxwFDDYAbSnC99NpAKVwE1Sr"
}
该网址将引导客户进入 WooshPay 的结账页面,客户将看到基于货币的不同钱包,客户可以选择他们想要支付的钱包,扫描二维码或登录钱包。