概述 #
创建完整的结账有四个步骤:
- 创建产品
- 创建价格
- 创建结账
- 跳转到收银台完成付款
创建产品 #
产品和价格是许多 WooshPay 集成的核心资源。产品定义了企业提供的商品或服务。
要求
{
"名称": "示例产品"、
"active":true、
"description": "some description"、
"元数据":{
"key1": "value1"、
"key3": "value3"。
},
"url": "www.example.com"
}
回应
{
"id":"prod_1554351292598452224",
"对象":"产品"、
"创建":1665642282000,
"active": true、
"description":"一些描述"、
"元数据":{
"key1":"value1"、
"key2":"value2"
},
"名称":"示例产品"、
"livemode": false、
"url":"www.example.com"、
"更新":1665642282000,
"images": null
}
创建价格 #
价格定义了产品的价格和收费频率。您可以为一个产品创建单个或多个价格。
要求 1:直接绑定现有产品
{
"货币": "英镑"、
"product":"prod_1554351292598452224",
"unit_amount":5、
"active":true、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"昵称": "某个昵称
"product_data":null、
"lookup_key": "test_lookup_key" }.
}
要求 2:在创建价格的同时创建新产品
{
"currency": "GBP"、
"product":null、
"unit_amount":5、
"active":true、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"昵称": "fengli"、
"产品数据":{
"id":null、
"name": "example product"、
"活动":true、
"description": "非常美味"、
"元数据":{
"key1": "value1"、
"key2": "value2
},
"url": "www.example.com"
},
"billing_scheme": "testscheme"、
"lookup_key": "test_lookup_key" }.
}
回应
{
"id":"price_1554384814788837376",
"对象": "价格
"created":1659429194000,
"活动":true、
"currency": "GBP"、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"昵称": "某个昵称
"产品":{
"id":"prod_1554351292598452224",
"对象": "产品"、
"created":1659421201000,
"活动":true、
"描述": "非常美味
"元数据":{
"key1": "value1"、
"key3": "value3
},
"name": "taiwan fengli"、
"livemode":false、
"url": "www.example.com"、
"updated":1659422039000
},
"type": "one_time"、
"livemode":false、
"unit_amount":5、
"billing_scheme": "per_unit"、
"lookup_key": "test_lookup_key"。
}
创建结账 #
结账会话是客户被重定向到付款表单时所看到的程序化表示。您可以通过以下选项对其进行配置:
行项目
收费- 使用的货币
您还需要说明
- A
success_url
在您的网站上创建一个页面,在客户完成付款后对其进行重定向。 - A
cancel_url
如果客户在结账时点击了您的徽标,您可以在网站上创建一个页面,将其重定向到您的网站。
注意:结账会话将在创建 24 小时后失效。
要求
{
"cancel_url": "www.example.com"、
"模式":"付款"、
"success_url": "www.wooshpay.com"、
"line_items":[
{
"price_data":{
"currency": "GBP"、
"产品":null、
"unit_amount":5、
"active":true、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"昵称": "fengli"、
"产品数据":{
"id":null、
"name": "example product"、
"活动":true、
"description": "非常美味"、
"元数据":{
"key1": "value1"、
"key2": "value2
},
"url": "www.example.com"
},
"billing_scheme": "testscheme"、
"lookup_key": "test_lookup_key" }.
},
"数量":1
}
]
}
回应
{
"id":"cs_1580071142008291328",
"对象": "checkout.session"、
"created":1665553291000,
"货币": "英镑
"客户":""、
"模式": "付款
"livemode":false、
"shipping":null、
"status": "open"、
"url": "https://checkouttest.wooshpay.com/pay/cs_test_1580071142008291328?key=pk_test_dGVzdDpXWUg1eUF4OXZpUUF4UHNoYmdRRjVTTTE="、
"cancel_url": "www.baidu.com"、
"client_reference_id":null、
"customer_email":null、
"行项目":{
"对象": "列表
"数据": {
{
"id":"li_1580071142847152128",
"对象": "项目"、
"currency": "GBP"、
"description": "示例产品"、
"价格":{
"id":"price_1580071142859735040",
"对象": "价格
"created":1665553291000,
"活动":true、
"currency": "GBP"、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"昵称": "fengli"、
"产品":{
"id":"prod_1580071142880706560",
"对象": "产品"、
"created":1665553291000,
"活动":true、
"description": "某些描述"、
"元数据":{
"key1": "value1"、
"key2": "value2"。
},
"name": "示例产品
"livemode":false、
"url": "www.example.com"、
"updated":1665553291000,
"图像":null
},
"类型":"one_time"、
"livemode":false、
"unit_amount":5、
"billing_scheme": "per_unit"、
"lookup_key": "test_lookup_key" }.
},
"数量":1、
"amount_subtotal":5、
金额小计":5, "金额总计":5
}
],
"url":null、
"has_more":null
},
"payment_intent":"pi_1580071150141046784",
"payment_method_types":null、
"payment_status": "unpaid"、
"success_url": "www.wooshpay.com"、
"amount_subtotal":5、
"amount_total":5、
"billing_address_collection": "auto"、
"expires_at":1665639691214,
"付款链接":""、
"付款方式选项":null、
"电话收集":null、
"收货地址":null、
"client_secret":"pi_1580071150141046784_secret_bsOGcAMewpe6orzCbZHMlomu"
}
重定向 URL #
创建结账会话后,将客户重定向到响应中返回的 URL。