支付宝 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 或出现在支付宝的禁止企业名单上。如果您不确定您的企业是否属于被禁企业，或对这些要求如何适用于您有疑问，请联系 support@wooshpay.com。
服务器到服务器集成 #
使用支付宝 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 的结账页面，客户将看到基于货币的不同钱包，客户可以选择他们想要支付的钱包，扫描二维码或登录钱包。
