WooshPay 结账

概述 #

创建完整的结账有四个步骤:

  1. 创建产品
  2. 创建价格
  3. 创建结账
  4. 跳转到收银台完成付款

创建产品 #

产品和价格是许多 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。

What are your feelings
Updated on 8月 9, 2023