订阅
订阅支付是指客户与商家之间建立的一种协议，允许商家根据预先设定的时间表自动收取客户的付款。
请求参数
POST
| 名称 | 类型 | 长度 | 必填 | 签名 | 描述 |
|---|---|---|---|---|---|
| subProductType | String | 16 | Yes | Yes | 子产品类型，订阅支付使用 SUBSCRIBE |
| subscription | String | / | No | Yes | 订阅付款所需的订阅信息。 格式为 json 字符串。 请参阅对象 Subscription |
订阅支付请求参数请参考收银台支付接口
json
{
// 其他参数请参考收银台支付接口
"subProductType": "SUBSCRIBE",
"subscription": "{\"merchantCustId\":\"1720507855183939880.4680922699\",\"requestType\":\"0\",\"expireDate\":\"2030-11-11\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\"}"
}1
2
3
4
5
2
3
4
5
SubProductType
| 代码 | 描述 |
|---|---|
| DIRECT | 直接支付 |
| SUBSCRIBE | 订阅支付 |
| INSTALLMENT | 分期支付 |
| TOKEN | token支付 |
| AUTO_DEBIT | 代扣 |
Subscription
托管订阅（自动扣款）
订阅测试卡
json
卡号：4000000000002701
有效期：05/26
CVV：123
持卡人姓名：CL BRW21
2
3
4
2
3
4
json
卡号：5200000000001013
有效期：05/26
CVV：123
持卡人姓名：CL BRW21
2
3
4
2
3
4
json
卡号：4000000000001091
有效期：05/26
CVV：123
持卡人姓名：CL BRW21
2
3
4
2
3
4
json
卡号：4000000000001109
有效期：05/26
CVV：123
持卡人姓名：CL BRW21
2
3
4
2
3
4
json
卡号：5200000000001039
有效期：05/26
CVV：123
持卡人姓名：CL BRW21
2
3
4
2
3
4
订阅首购
升降级
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| requestType | String | 1 | Yes | 订阅请求类型，请参阅 |
| merchantCustId | String | 40 | Yes | 商户系统中的用户唯一标识，用于关联用户与订阅信息。此ID将用于订阅的创建、查询和管理，请确保其在商户系统中的唯一性。 |
| productName | String | 256 | No | 订阅产品名称，用于区分不同的订阅服务或套餐。不传入时，每个用户仅能创建一个订阅；传入时，同一用户可订阅多个不同产品。 |
| frequencyType | String | 1 | No | 订阅周期单位：D-天 M-月Y-年决定账单周期的基本时间单位。 |
| frequencyPoint | String | 2 | Yes | 建议的订阅周期值。 |
| cycleCount | int | 256 | No | 循环期数，支持1-100。 |
| expireDate | String | 10 | Yes | 订阅终止日期，格式为yyyy-MM-dd。超过此日期后，托管系统将不再触发扣款。 |
| mode | String | 1 | Yes | 签约模式：1 - 先签约后扣款，需分两步完成2 - 签约并立即扣款，一步完成（默认值） |
| selfExecute | String | 1 | Yes | 订阅扣款模式：1 - 系统自动扣款（推荐）：由支付系统按照设定的频率自动执行周期性扣款2 - 商户触发扣款：需要商户系统主动调用API发起每期扣款非托管订阅 |
| bindCard | String | 300 | No | 订阅信用卡绑定选项：true - 完成订阅并将卡信息绑定到用户ID false - 仅完成订阅但不绑定卡信息 |
| trialFromPlan | String | 256 | No | 试用期计费模式: 0 - 试用期不计入订阅计划（不收费） 1 - 试用期计入订阅计划（收费） |
| trialDays | int | 256 | No | 试用期天数，支持范围 3-365 天。当设置试用期时，与 trialEnd 二选一。 |
| trialEnd | String | 256 | No | 试用期结束日期，格式为yyyy-MM-dd。当设置试用期时，与trialDays二选一。 |
| notificationEmail | String | 256 | No | 买家订阅后邮件通知地址（含订阅扣款成功、取消订阅等其他邮件通知）。 |
| metaData | String | 2048 | No | 商户自定义信息，用于存储业务数据。支持JSON格式，在查询订阅时原样返回。 |
json
// 试用首购 - 每天扣款一次，共30天，前3天为试用期且包含在订阅计划内，试用结束后自动扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_1640247522000\",\"productName\":\"自动扣30天-试用3天（含）-1天1次\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"cycleCount\":30,\"selfExecute\":\"1\",\"trialFromPlan\":\"1\",\"trialDays\":3,\"notificationEmail\":\"abel.wang@onerway.com\"}"1
2
2
json
// 试用首购 - 每天扣款一次，共33天，前3天为试用期且不包含在订阅计划内，试用结束后自动扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_1640247522000\",\"productName\":\"自动扣30天-试用1天（不含）-1天1次\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"cycleCount\":30,\"selfExecute\":\"1\",\"trialFromPlan\":\"0\",\"trialEnd\":\"2024-11-07\",\"notificationEmail\":\"abel.wang@onerway.com\"}"1
2
2
json
// 非试用首购 - 每天扣款一次直到指定过期日期（2024-12-04），无试用期，立即开始自动扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_1640247522099\",\"productName\":\"自动扣30天-无试用-1天1次-到期时间6\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"expireDate\":\"2024-12-04\",\"selfExecute\":\"1\",\"notificationEmail\":\"abel.wang@onerway.com\"}"1
2
2
json
// 仅签约模式 - 每月扣款一次，签约但不立即扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_1640247522100\",\"productName\":\"仅签约-1月1次\",\"frequencyType\":\"M\",\"frequencyPoint\":\"1\",\"expireDate\":\"2025-12-04\",\"selfExecute\":\"1\",\"notificationEmail\":\"abel.wang@onerway.com\",\"mode\":\"1\"}"1
2
2
json
// 升降级 - 每天扣款一次，共30天，立即升级, 补差价30
"subscription": "{\"requestType\":\"2\",\"tokenId\":\"tokenId_xxx\",\"contractId\":\"contractId_xxx\",\"productName\":\"订阅升级-立即生效并补差价\",\"proration\":\"30\",\"merchantCustId\":\"custId_xxx\"}"1
2
2
非托管订阅（商户发起扣款）
注意
- 商户需自行管理订阅周期和发起扣款操作
- 不支持升降级、邮件通知、订阅管理页面
- 订阅频率由商户控制，仅支持按天
首次订阅
续期订阅
| 名称 | 类型 | 长度 | 必填 | 描述 |
|---|---|---|---|---|
| requestType | String | 1 | Yes | 订阅请求类型：固定值为0（首购）。 |
| merchantCustId | String | 40 | Yes | 商户系统中的用户唯一标识，用于关联用户与订阅信息。此ID将用于订阅的创建、查询和管理，请确保其在商户系统中的唯一性。 |
| productName | String | 256 | No | 订阅产品名称，用于区分不同的订阅服务或套餐。不传入时，每个用户仅能创建一个订阅；传入时，同一用户可订阅多个不同产品。 |
| frequencyType | String | 1 | No | 订阅周期单位：非托管订阅模式下仅支持D（天）。 |
| frequencyPoint | String | 2 | Yes | 建议的订阅周期值，表示每隔多少天。 |
| expireDate | String | 10 | Yes | 建议的订阅终止日期，格式为yyyy-MM-dd。 |
| mode | String | 1 | Yes | 签约模式：1 - 先签约后扣款，需分两步完成2 - 签约并立即扣款，一步完成（默认值） |
| selfExecute | String | 1 | Yes | 订阅扣款模式： 非托管订阅固定为 2 - 商户触发扣款：由商户系统负责计算扣款时间并主动调用API发起每期扣款 |
订阅支付请求参数说明
进行订阅支付时，请参考标准收银台支付或SDK下单请求中的信用卡支付，并注意以下修改：
- 将
subProductType参数值由DIRECT修改为SUBSCRIBE - 添加
subscription参数包含订阅详情
json
{
// 关键参数示例
"subProductType": "SUBSCRIBE", // 必须设置为SUBSCRIBE
"subscription": "..." // json格式订阅请求参数
}1
2
3
4
5
2
3
4
5
json
// 非托管订阅 - 仅签约模式，不立即扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_xxx\",\"productName\":\"非托管-仅签约\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"expireDate\":\"2025-01-01\",\"selfExecute\":\"2\",\"mode\":\"1\"}"1
2
2
json
// 非托管订阅 - 立即扣款模式，立即扣款
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"custId_xxx\",\"productName\":\"非托管-立即扣款\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"expireDate\":\"2025-01-01\",\"selfExecute\":\"2\",\"mode\":\"2\"}"1
2
2
json
// 非托管订阅 - 续期扣款，使用已有订阅合同发起新一期扣款
"subscription": "{\"requestType\":\"1\",\"contractId\":\"contractId_xxx\",\"tokenId\":\"tokenId_xxx\",\"merchantCustId\":\"custId_xxx\"}"1
2
2
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| respCode | String | 来自 Onerway 的响应码 |
| respMsg | String | 来自 Onerway 的响应信息 |
| data | Object | 响应数据。 请参阅对象 data |
data
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| transactionId | String | Yes | Onerway创建的交易订单号，对应商户订单号 |
| merchantTxnId | String | Yes | 顾客每次付款的订单号。 |
| merchantNo | String | Yes | 商户号。 商户注册时, OnerWay会为商户创建商户号 |
| responseTime | String | Yes | 接口响应时间，格式为 yyyy-MM-dd HH:mm:ss |
| txnTime | String | Yes | 交易完成时间，格式为 yyyy-MM-dd HH:mm:ss |
| orderAmount | String | Yes | 订单金额。 |
| orderCurrency | String | Yes | 交易订单币种。 请参阅 ISO 4217 货币代码 |
| txnAmount | String | Yes | 订单金额转换成结算币种后的金额 |
| txnCurrency | String | Yes | 结算币种。 请参阅 ISO 4217 货币代码 |
| txnTimeZone | String | Yes | 交易时区。 请参阅 ISO 4217 货币代码 |
| status | String | Yes | 交易处理结果。 请参阅 |
| reason | String | Yes | 交易失败原因 |
| redirectUrl | String | Yes | 收银台地址，商家拿到这个地址后，需要重定向打开。 |
| sign | String | Yes | 签名字符串，请参阅签名接口 |
| contractId | String | Yes | 订阅合同号：区分是哪笔订阅，完成订阅复购的重要参数。通常与tokenId成对保存。订阅首购成功后返回，订阅复购中使用 |
| tokenId | String | Yes | 订阅token：根据买家支付信息生成的支付token，完成复购的重要参数。订阅首购成功后返回，订阅复购中使用 |
| eci | String | Yes | 责任转移，3D Secure 所需参数 |
| periodValue | String | Yes | 分期付款期数 |
| lpmsType | String | Yes | 本地支付方式，请参阅对象 |
| qrCode | String | Yes | 二维码值 |
| subscriptionManageUrl | String | Yes | 订阅托管地址，买家可以通过此地址查看订阅订单信息 |
| subscriptionsManageUrl | String | Yes | 订阅列表托管地址 |
订阅首购请求示例
POST
json
{
"billingInformation": "{\"country\":\"US\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"şş\",\"lastName\":\"café\",\"phone\":\"17700492982\",\"address\":\"Apt. 870\",\"city\":\"Akşehir\",\"postalCode\":\"66977\",\"province\":\"Akşehir\"}",
"merchantCustId": "1730858419000",
"merchantNo": "800209",
"merchantTxnId": "1730858419000",
"merchantTxnTime": "2024-11-06 10:00:19",
"merchantTxnTimeZone": "+08:00",
"orderAmount": "20",
"orderCurrency": "USD",
"productType": "CARD",
"shippingInformation": "{\"country\":\"US\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"şş\",\"lastName\":\"café\",\"phone\":\"17700492982\",\"address\":\"Apt. 870\",\"city\":\"Akşehir\",\"postalCode\":\"66977\",\"identityNumber\":\"12345678\",\"province\":\"Akşehir\"}",
"sign": "6d5612314c8f50ee1d14845f85bf9bae3a29010c561a89a484d9e4f09d77a482",
"subProductType": "SUBSCRIBE",
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"1730858419000\",\"productName\":\"自动扣30天-试用3天（含）-1天1次\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"cycleCount\":30,\"selfExecute\":\"1\",\"trialFromPlan\":\"1\",\"trialDays\":3,\"notificationEmail\":\"abel.wang@onerway.com\", \"tokenId\":\"1e51d629bd0c919d016ac53ca1b34366e4870cd3f497c3ee13cd24bbdf5fcb68\",\"contractId\":\"1853384007086374912\"}", 试用首购 - 每天扣款一次，共30天，前3天为试用期且包含在订阅计划内，试用结束后自动扣款
"txnOrderMsg": "{\"returnUrl\":\"https://docs.onerway.com/\",\"notifyUrl\":\"https://www.merchant-store-notify.com\",\"products\":\"[{\\\"price\\\":\\\"20.00\\\",\\\"num\\\":\\\"1\\\",\\\"name\\\":\\\"自动扣30天-试用3天（含）-1天1次\\\",\\\"currency\\\":\\\"USD\\\"}]\",\"transactionIp\":\"127.0.0.1\",\"appId\":\"1831944691027152896\",\"javaEnabled\":false,\"colorDepth\":\"24\",\"screenHeight\":\"1080\",\"screenWidth\":\"1920\",\"timeZoneOffset\":\"-480\",\"accept\":\"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\",\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36\",\"contentLength\":\"340\",\"language\":\"zh-CN\"}",
"txnType": "SALE"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
json
{
"billingInformation": "{\"country\":\"US\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"şş\",\"lastName\":\"café\",\"phone\":\"17700492982\",\"address\":\"Apt. 870\",\"city\":\"Akşehir\",\"postalCode\":\"66977\",\"identityNumber\":\"12345678\",\"province\":\"Akşehir\"}",
"merchantCustId": "1731380698000",
"merchantNo": "800209",
"merchantTxnId": "1731380698000",
"merchantTxnTime": "2024-11-12 11:04:58",
"merchantTxnTimeZone": "+08:00",
"orderAmount": "20",
"orderCurrency": "USD",
"productType": "CARD",
"shippingInformation": "{\"country\":\"US\",\"email\":\"abel.wang@onerway.com\",\"firstName\":\"şş\",\"lastName\":\"café\",\"phone\":\"17700492982\",\"address\":\"Apt. 870\",\"city\":\"Akşehir\",\"postalCode\":\"66977\",\"identityNumber\":\"12345678\",\"province\":\"Akşehir\"}",
"sign": "d2f4ecc82ccb9aded60d500b603a89342ef260f2c5d04bcc82fde6949502e8ad",
"subProductType": "SUBSCRIBE",
"subscription": "{\"requestType\":\"0\",\"merchantCustId\":\"1731380698000\",\"productName\":\"自动扣到11月15日-无试用-1天1次-到期时间\",\"frequencyType\":\"D\",\"frequencyPoint\":\"1\",\"expireDate\":\"2024-11-15\",\"selfExecute\":\"1\",\"notificationEmail\":\"abel.wang@onerway.com\",\"tokenId\":\"\",\"contractId\":\"\"}", 非试用首购 - 每天扣款一次直到指定过期日期（2024-11-15），无试用期，立即开始自动扣款
"txnOrderMsg": "{\"returnUrl\":\"https://docs.onerway.com/\",\"notifyUrl\":\"https://www.merchant-store-notify.com\",\"products\":\"[{\\\"price\\\":\\\"20.00\\\",\\\"num\\\":\\\"1\\\",\\\"name\\\":\\\"自动扣30天-无试用-1天1次-到期时间6\\\",\\\"currency\\\":\\\"USD\\\"}]\",\"transactionIp\":\"127.0.0.1\",\"appId\":\"1727880846378401792\",\"javaEnabled\":false,\"colorDepth\":\"24\",\"screenHeight\":\"1080\",\"screenWidth\":\"1920\",\"timeZoneOffset\":\"-480\",\"accept\":\"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9\",\"userAgent\":\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36\",\"contentLength\":\"340\",\"language\":\"zh-CN\"}",
"txnType": "SALE"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
订阅首购响应示例
若请求成功，商家需要获取响应参数中的redirectUrl，然后进行重定向打开。
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"transactionId": "1853980684692361216",
"merchantTxnId": "1730858419000",
"merchantNo": "800209",
"responseTime": "",
"txnTime": "",
"orderAmount": "20.00",
"orderCurrency": "USD",
"txnAmount": "",
"txnCurrency": null,
"txnTimeZone": null,
"status": "U",
"reason": null,
"redirectUrl": "https://sandbox-checkout.onerway.com/checkout?key=864c30107b6445459303bfae4f1514da", 跳转收银台地址
"sign": "bd1290c1c8eb0a4cd482b82506c525999ff430c671cf7b83c8fb335a115b4347",
"contractId": "",
"tokenId": null,
"eci": null,
"transactionOrderNo": null,
"periodValue": null,
"lpmsType": null,
"qrCode": null,
"subscriptionManageUrl": "https://sandbox-myscribe.onerway.com/pages/subscription-list/details?contractId=eyJjb250cmFjdElkIjoxODUzOTgwNjg0NzU1Mjc1Nzc2LCJtZXJjaGFudE5vIjo4MDAyMDksIm1lcmNoYW50Q3VzdElkIjoiMTczMDg1ODQxOTAwMCIsIm5vdGlmaWNhdGlvbkVtYWlsIjpudWxsLCJhcHBJZCI6IjE4MzE5NDQ2OTEwMjcxNTI4OTYifQ==" 订阅托管地址
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
json
{
"respCode": "20000",
"respMsg": "Success",
"data": {
"transactionId": "1856171302189404160",
"merchantTxnId": "1731380698000",
"merchantNo": "800209",
"responseTime": "",
"txnTime": "",
"orderAmount": "20.00",
"orderCurrency": "USD",
"txnAmount": "",
"txnCurrency": null,
"txnTimeZone": null,
"status": "U",
"reason": null,
"redirectUrl": "https://sandbox-checkout.onerway.com/checkout?key=3defb10ddc42412290106d5b87705ae8&checkoutDetail=H4sIAAAAAAAAAL1WTW8cNRj%2BK9VcSTbj%2BfTsic0kESs1bZRNiwD14PF4dt147cH2ZLOKci5wBvWCFBAcWoQEB8QfQP0pDeVfYM%2FXzpYgUA89%2BvH7vvN%2BPO%2FjuXJQWU5zZ%2ByA2IshdGEQ%2BTEMXBAnnrPjLInEC8T1A%2BGMoet6bjLA0JIYx0lG2MDy7JK38XzgQzdKjJu7fX9Ga0fP9YJdAHaBdw%2BAsRuMQ%2FhPu08Ft7YfuHBch9EGXpcWmk3uHzbAZCkqruuIo84oraQkHK8N%2Bmh2YDBVZSdS5BXWnf%2Bj%2FVl6Ot23QTCSuYWnvDCFfnblUFMCCKAfeV7oeUkSRzDyYm9jaQIcT2Znh6fp5NSGL7dityATc3GC9MIgC61LNd7bKxFel2idUzQfZUxkIywkGa0oz8VKjTjRnYVnb%2Fe6z903kfbCIvRBiOMkxi6JIhwkwA%2ByCGQwQVkYotHTcj4opp3PIM3rnWFlvuuHoetDGPl%2BtFXZwXSWPnx8ePqe6oJ%2BUMDcxTDGHiSJS2IQRzmC2IsLU617d119kttVeVGcwCiIwhC%2BNa%2FH09nkPVXk5SBMiihDMMsLlPk4LyLXz8PQywtMgn%2BZVJ3g9ZMdZ0UyRbWFmMCILYTSxjqjjFE%2Bn%2BS5JEqZy9VqNdJEaZPZso3WEJhXjO04pCgI1vSCHFNeGTtn7Lv1bjyUOZHHat4ZtoGtr1wiTQV3xldOQaXqdvzVzasb2yXUIxgVf7y03Vw0Cwri2HWDxEuglQ2yRJQZFBltGK0Qn39orOQKrdtUS1MRYqnIrWsUJXFsQNQXNin16B6M7Spju9qyWeNmeBeU41p3zl%2FdkAWV1ojq9TaitCREdwXyapkR2Z1oTrg2Hg9a1AGeH4RRDOseS704QLb3jfHT8mjThw66j4bIdS0uCktadr3DwiSNsLZKCGAYgRj4rueHtj0uiDYql1ZK3ymXLUvbbr959tPrr17cfvmD777%2B8eXu7fPv3vzyzZ9fv9gF5ghuf%2F5%2B9%2FUXv95%2Be3P7%2FPe%2Fnv8WGX9JPq8MNRqWm7GTy5JK0lS2Ud7Qtoqw4vCS4Kq%2BAgYpamcjnp0cDLETQWutBRtGpmvMyITjheh7jC2UNrLcIFqck%2BZlsCJfT74djtC0oLjm3eF%2F8EZLitiRFMsThngf2YIHaK22gEOed2fTS9nSuiM8z1OzLd1Z2IXoXpEBtHlEOpDOKUdsNhj3TCNdqZ4JkuSmz1g%2FkqzzUq2FM6ufN6XQvC9eiUpikhoqcGILxwuCz0Wlm0esYUbPHwCTwA1A5Nbz1ZXk9Vd6xcoFVqNBw%2FZqUTDbwgbZGF5yZahpUq914EGvF0bKlmYz0u2N6zI6NiNjfYsLSlieCl7QebXdW1PtnKgtLWnnTFZpV93bXxzEObKRVf0I805qZP6RYDZXCzTcNk02V5%2BY0wViFWlolVNVMrSuL%2ByrMAhglv1dPC8u3sGrF9563f6v%2F5Nmn%2B5uhrlcGN3av0OpC8QUaa4%2F7t6NFjPDn3KrtMy2uYczQ4F2eFas6mM3EvsQTpcDhmZIkSiwr1q%2F24JtFv2CklX7y7cB0pp0%2B5pvgQ2vevT6%2Bm%2FzXE6DfQoAAA%3D%3D", 跳转收银台地址
"sign": "10fc4e19ead644c8d36207388cc370e698613a58cef7933ac9def18469b40af5",
"contractId": "",
"tokenId": null,
"eci": null,
"transactionOrderNo": null,
"periodValue": null,
"lpmsType": null,
"qrCode": null,
"subscriptionManageUrl": "https://sandbox-myscribe.onerway.com/pages/subscription-list/details?contractId=eyJjb250cmFjdElkIjoxODU2MTcxMzAyMzUyOTgyMDE2LCJtZXJjaGFudE5vIjo4MDAyMDksIm1lcmNoYW50Q3VzdElkIjoiMTczMTM4MDY5ODAwMCIsIm5vdGlmaWNhdGlvbkVtYWlsIjpudWxsLCJhcHBJZCI6IjE3Mjc4ODA4NDYzNzg0MDE3OTIifQ==" 订阅托管地址
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
支付成功示例
json
// 买家支付完成会返回到 returnUrl，同时支付结果会通过url参数返回，前端可以在returnUrl中通过拼接的参数来判断支付结果
https://www.merchant-store-website.com/?transactionId=1853980684692361216&merchantTxnId=1730858419000&merchantNo=800209&responseTime=2024-11-06%2010%3A22%3A47&txnTime=2024-11-06%2010%3A22%3A06&txnTimeZone=%2008%3A00&orderAmount=0.00&orderCurrency=USD&txnAmount=0.00&txnCurrency=USD&status=S&reason=Payment%20successful&contractId=1853980684755275776&tokenId=2a262447389a33cbab0a1221fd6a0f36fd7cab70d0abf1b0a34bae3aae67ba191
2
2
json
{
"notifyType": "TXN",
"transactionId": "1853980684692361216",
"txnType": "SALE",
"merchantNo": "800209",
"merchantTxnId": "1730858419000",
"responseTime": "2024-11-06 10:22:22",
"txnTime": "2024-11-06 10:22:06",
"txnTimeZone": "+08:00",
"orderAmount": "0.00",
"orderCurrency": "USD",
"status": "S",
"contractId": "1853980684755275776",
"tokenId": "2a262447389a33cbab0a1221fd6a0f36fd7cab70d0abf1b0a34bae3aae67ba19",
"cardBinCountry": "US",
"reason": "{\"respCode\":\"20000\",\"respMsg\":\"Success\"}",
"sign": "89db06941d7e009e4239f320ba85b1d7cdc1710da1bc1e4dc009e5365b941f18",
"paymentMethod": "VISA",
"subscriptionManageUrl": "https://sandbox-myscribe.onerway.com/pages/subscription-list/details?contractId=eyJjb250cmFjdElkIjoxODUzOTgwNjg0NzU1Mjc1Nzc2LCJtZXJjaGFudE5vIjo4MDAyMDksIm1lcmNoYW50Q3VzdElkIjoiMTczMDg1ODQxOTAwMCIsIm5vdGlmaWNhdGlvbkVtYWlsIjpudWxsLCJhcHBJZCI6IjE4MzE5NDQ2OTEwMjcxNTI4OTYifQ==" 订阅托管地址
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
订阅复购
注意
- 目前非托管的订阅复购需要商户来发起
- 买家首购完成后，商户需要保存异步通知中的
contractId，tokenId，和subscriptionManageUrl。订阅升降级、非托管订阅的复购需要用到这些参数。