了解 PromptPay，一种在泰国很受欢迎的即时转账服务。

PromptPay 是一个基础设施解决方案，由泰国银行（BoT）支付政策制定机构开发和监管。其支付系统路线图使泰国的支付基础设施与银行一起实现了现代化。要在银行间转账，用户需要通过手机号码、身份证号码、公司注册号码或数字钱包号码等代理进行身份验证。

特点 #

处理货币	THB
结算货币	USD
最低交易金额	1 泰铢
最高交易金额	5,000 泰铢
退款	❌
部分退款	❌
多次部分退款	❌
扣款	❌

付款流程 #

整合方法 #

付款方式枚举值： 及时支付

PromptPay 有两种集成方法

直接应用程序接口
跳转收银台

直接 API #

如何整合 #

若要直接集成 API，只需一步即可创建 PaymentIntent 并获取 url。以下是创建付款意图的演示：

创建 PaymentIntent

PaymentIntent 是一个对象，代表您向客户收款的意图，并跟踪付款流程的生命周期。在服务器上创建 PaymentIntent，并指定收款金额和支持的货币。如果已有 Payment Intents 集成，请将 promptpay 添加到付款方式类型列表中。

要求

{
    "amount":1000、
    "货币": "泰铢"、
    "确认":true、
    "payment_method_data" : {
        "type": "promptpay
    },
    "return_url": "https://your.website"
}

回应

{
    "id"："pi_1664208234002513920",
    "对象"："payment_intent"、
    "创建"：1685613137000,
    "currency"："THB"、
    "金额"：1000,
    "status"："requires_action"、
    "livemode": false、
    "client_secret": "pi_1664208234002513920_secret_tzDL9JipXe0RE3qGTkNVty9j",
    "next_action"：{
        "type"："promptpay_handle_redirect"、
        "promptpay_handle_redirect"：{
            "url"："https://apitest.wooshpay.com/v1/receives/c12/pay/pi_1664208234002513920"
        }
    },
    "payment_method_types"：[
        "promptpay" [
    ],
    "确认方式"："自动"、
    "return_url"："https://your.website"、
    付款方式"："pm_1664208233880879104"pm_1664208233880879104",
    "capture_method"：自动
}

跳转收银台 #

创建视图 #

要求

{
    "cancel_url"："www.wooshpay.com"、
    "模式"："付款"、
    "success_url"："https://wooshpay.com/"、
    "付款方式"：[
        "promptpay" [
    ],
    "行项目"：[
        {
            "价格数据{
                "currency"："THB"、
                "unit_amount"：100,
                "昵称"："apple"、
                "产品数据{
                    "名称"："苹果"
                },
                "计费方案"："testscheme"、
                "lookup_key"："test_lookup_key
            },
            "数量"：1
        }
    ]
}

回应

{
    "id"："cs_1676158633408200704",
    "对象"："checkout.session"、
    "创建"：1688462334000,
    "livemode": false、
    "currency"："THB"、
    "客户"："",
    "模式"："付款"、
    "状态"："open"、
    "url"："https://checkouttest.wooshpay.com/pay/cs_test_1676158633408200704?key=pk_test_NTE2NzQzMzIzODEyNTI4MTY4OTYxOjEyVWdaRjhhSGpqOFZhRDZvaFRyc1RZbzE2ODgwMjY5MjU5NTk"、
    "cancel_url"："www.wooshpay.com"、
    "行项目"：{
        "对象"："list"、
        "数据"：[
            {
                "id"："li_1676158633437560832",
                "对象"："项目"、
                "货币"："THB"、
                "description"："苹果"、
                价格{
                    "id"："price_1676158633450143744",
                    "对象"："价格"、
                    "创建"：1688462334000,
                    "livemode": false、
                    "active": true、
                    "货币"："THB"、
                    "昵称"："apple"、
                    "产品"：{
                        "id"："prod_1676158633462726656",
                        "对象"："产品"、
                        "创建"：1688462334000,
                        "livemode": false、
                        "active": true、
                        "名称"："apple"、
                        "更新"：1688462334000
                    },
                    "类型"："one_time"、
                    "unit_amount"：100,
                    "计费方式"："per_unit"、
                    "lookup_key"："test_lookup_key
                },
                "数量"：1,
                "amount_subtotal": 100、
                "amount_total": 100
            }
        ]
    },
    "payment_intent"："pi_1676158633626304512",
    "付款方式类型"：[
        "promptpay
    ],
    "付款状态"未支付"、
    "success_url"：""："https://wooshpay.com/"、
    "amount_subtotal": 100、
    "amount_total": 100、
    "billing_address_collection"："auto"、
    "expires_at"：1688548734385,
    "付款链接"",
    "client_secret": "pi_1676158633626304512_secret_JbvbX6yCPEBB886Z46Rs5vw8"
}