了解深受中国客户欢迎的数字钱包支付宝。 #
支付宝是中国的一个数字钱包，在全球拥有超过 10 亿活跃用户。支付宝用户可以使用登录凭证或支付宝应用程序在网上或移动设备上进行支付。支付宝争议率低，并通过使用客户的登录凭据验证付款来减少欺诈。
特点 #
| 客户所在地 | 中国消费者 海外华人 中国游客 |
|---|---|
| 处理货币 | CNY, GBP, USD, EUR, HKD |
| 结算货币 | 英镑、港币、欧元 |
| 最低交易金额 | 0.01 人民币 |
| 最高交易金额 | 无限制 |
| 退款 | ✅ |
| 部分退款 | ✅ |
| 多次部分退款 | ❌ |
| 扣款 | ❌ |
禁止经营类别 WooshPay 和 Alipay Plus 都有一份禁止使用其服务的企业名单。要在 WooshPay 上使用支付宝 Plus，您的企业不能被限制使用或出现在支付宝的禁止企业名单中。如果您不确定您的企业是否属于被禁企业，或对这些要求如何适用于您有疑问，请联系 support@wooshpay.com.
次级产品 #
| 产品 | 付款方案说明 |
|---|---|
| 网络支付 | 在桌面浏览器上，选择支付宝作为付款方式的商家结账后，会出现一个二维码。然后，购物者打开手机上的支付宝应用程序，扫描浏览器页面上显示的条形码即可完成支付。 |
| APP 支付 | 在手机浏览器上，购物者在商家结账时选择支付宝作为付款方式，并从浏览器跳转到支付宝应用完成付款，然后再跳转回商家浏览器。 |
付款流程 #
网络支付 #
APP 支付 #
整合方法 #
付款方式枚举值： 支付宝
支付宝有两种集成方法
- 直接应用程序接口
- 跳转收银台
| 整合方法 | 付款方案 | 终端类型枚举值 |
|---|---|---|
| 直接应用程序接口 | 网络支付 | 网络 |
| 直接应用程序接口 | APP 支付 | APP |
| 跳转收银台 | 网络支付 | 您不需要确定 终端类型 在结账时。结账时会根据用户的设备自动生成二维码或重定向到支付宝应用。 |
| 跳转收银台 | APP 支付 | 您不需要确定 终端类型 在结账时。结账时会根据用户的设备自动生成二维码或重定向到支付宝应用。 |
直接应用程序接口 #
PaymentIntent 是一个对象，代表您向客户收款的意图，并跟踪付款流程的生命周期。在服务器上创建 PaymentIntent，并指定收款金额和支持的货币。
创建 PaymentIntent #
要直接集成 API，只需一步即可创建 PaymentIntent 并获取 url。以下是创建付款意图的演示：
- 网络支付
- APP 支付
您可以通过更改终端类型的枚举值来控制在 "付款意图 "中生成的付款方案：Payemen_method_options.alipay.terminal_type
网络支付 #
要求
{
"金额"：20,
"货币"："CNY"、
"确认": true、
"payment_method_options"：{
"支付宝"：{
"client_ip"："192.168.0.1",
"终端类型"WEB"、
"os_type"："IOS"IOS
}
},
"付款方式数据"：{
"type"："支付宝"
},
"付款方式类型"： [[
"支付宝"
],
"return_url"："https://wooshpay.com"
}回应
{
"id"："pi_1666729870215872512",
"对象"："payment_intent"、
"创建"：1686214342000,
"货币"："CNY"、
"金额"：20,
"status"："requires_action"、
"livemode": true、
"client_secret": "pi_1666729870215872512_secret_jmGL6NBNInPx5zdjIJ2utli4",
"next_action"：{
"类型"："redirect_to_url"、
"alipay_handle_redirect"：{
"url"："https://open-sea.alipayplus.com/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=28166604009zSv0130nTr0bKfhzSwT08YvSW"
}
},
"payment_method_types"：[
"支付宝
],
"确认方式"："自动"、
"付款方式选项"：{
"支付宝"：{
"terminal_type"："WEB"、
"os_type"："IOS"、
"client_ip"："192.168.0.1"
}
},
"return_url"："https://wooshpay.com"、
"payment_method"："pm_1666729870102626304",
"capture_method"：自动
}The 网址 从 next_action 可以打开，从链接，客户将被重定向到支付宝的结账页面。客户可以扫描二维码或登录钱包进行支付。
APP 支付 #
要求
{
"金额"：20,
"货币"："CNY"、
"确认": true、
"payment_method_options"：{
"支付宝"：{
"client_ip"："192.168.0.1",
"终端类型"APP"、
"os_type"："IOS"IOS
}
},
"payment_method_data"：{
"type"："支付宝"
},
"付款方式类型"： [[
"支付宝"
],
"return_url"："https://wooshpay.com"
}回应
{
"id": "pi_1666732544285999104",
"object": "payment_intent",
"created": 1686214980000,
"currency": "CNY",
"amount": 20,
"status": "requires_action",
"livemode": true,
"client_secret": "pi_1666732544285999104_secret_NRUV59FL6qtFyz2bXVeDyLD4",
"next_action": {
"type": "redirect_to_url",
"alipay_handle_redirect": {
"url": "https://render.alipay.com/p/s/i/?scheme=alipays%3A%2F%2Fplatformapi%2FstartApp%3FappId%3D10000007%26actionType%3Droute%26qrcode%3D281666040092tD6e6GlEzzTlQl6HrEqv3kOI%26externalThrough%3D%257B%2522acTerminalType%2522%253A%2522WAP%2522%257D"
}
},
"payment_method_types": [
"alipay"
],
"confirmation_method": "automatic",
"payment_method_options": {
"alipay": {
"terminal_type": "APP",
"os_type": "IOS",
"client_ip": "192.168.0.1"
}
},
"return_url": "https://wooshpay.com",
"payment_method": "pm_1666732544155975680",
"capture_method": "automatic"
}跳转收银台 #
要支持支付宝付款，结账会话必须满足以下所有条件：
- 所有项目的价格必须使用相同的货币。如果有不同货币的项目，请为每种货币创建单独的结账会话。
- 只能使用一次性细列项目。
启用支付宝作为付款方式
创建新的结账会话时，您需要
将 Alipayplus 添加到 付款方式类型.确保所有 行项目 使用相同的货币。
创建会话 #
您不需要确定 终端类型 创建结账会话。结账时会根据用户的设备自动生成二维码或重定向到支付宝应用程序。
要求
{
"cancel_url"："www.baidu.com"、
"模式"："付款"、
"success_url"："https://wooshpay.com/"、
"付款方式"：[
"支付宝
],
"项目"：[
{
"价格数据{
"currency"："CNY"、
"unit_amount"：100000,
"active": true、
"product_data"：{
"name"："台湾丰利
},
"计费方案"："testscheme"、
"lookup_key"："test_lookup_key
},
"数量"：1
}
]
}回应
{
"id"："cs_1666733999608823808",
"对象"："checkout.session"、
"创建"：1686215327000,
"货币"："CNY"、
"客户"："",
"模式"："付款"、
"livemode": true、
"状态"："open"、
"url"："https://checkout.wooshpay.com/pay/cs_1666733999608823808?key=pk_live_dGVzdDpKeEQzUXhpWDJyYkFRZEo1QWtWN0dHUFo="、
"cancel_url"："www.baidu.com"、
"行项目"：{
"对象"："list"、
"数据"：[
{
"id"："li_1666733999642378240",
"对象"："项目"、
"货币"："CNY"、
"description"："taiwan fengli"、
价格{
"id"："price_1666733999659155456",
"对象"："价格"、
"创建"：1686215327000,
"active": true、
"currency"："CNY"、
"产品"：{
"id"："prod_1666733999675932672",
"对象"："产品"、
"创建"：1686215327000,
"active": true、
"名称"："taiwan fengli"、
"livemode": true、
"更新"： true1686215327000
},
"类型"："one_time"、
"livemode": true、
"unit_amount"：100000,
"billing_scheme"："per_unit"、
"lookup_key"："test_lookup_key
},
"数量"：1,
"amount_subtotal": 100000、
"金额小计"： 100000
}
]
},
"payment_intent"："pi_1666733999864676352",
"付款方式类型"：[
"支付宝
],
"付款状态"未支付"、
"success_url"："https://wooshpay.com/"、
"amount_subtotal": 100000、
"amount_total": 100000、
"billing_address_collection"："auto"、
"expires_at"：1686301726587,
"付款链接"",
"client_secret": "pi_1666733999864676352_secret_5S1FMaseZU6gfIZjl2QlOdY7"
}The 网址 从 next_action 可以打开，从链接，客户将被重定向到支付宝的结账页面。客户可以扫描二维码或登录钱包进行支付。
下一步 #
您可以根据需要为集成添加更多功能
创建 Webhook #
监听 WooshPay 账户上的事件，以便您的集成可以自动触发反应。创建一个 webhook，主要关注 enabled_events 和 url。
创建退款 #
创建退款，将资金返还给客户。您也可以执行部分退款，但并非每种支付方式都支持。部分退款是指只退还原始交易金额的一部分。
