9Pay

了解深受越南客户欢迎的数字钱包 9Pay。 #

9Pay 拥有数百万用户，是越南领先的数字钱包，可满足个人的各种支付需求。它是一个一体化应用程序，为日常使用提供了一系列便利功能。

特点 #

处理货币	越南盾
结算货币	USD
最低交易金额	本地借记卡最低10,000 越南盾国际卡最低10,000 越南盾 9Pay 电子钱包最低5,000 越南盾银行转账最低10,000 越南盾
最高交易金额	本地借记卡最大值200,000,000 第纳尔国际卡最高：200,000,000 越南盾 9Pay 电子钱包最大值100,000,000 第纳尔银行转账最大值：无限制
退款	✅
部分退款	✅
多次部分退款	✅
扣款	✅

次级产品 #

产品	说明
9Pay 电子钱包	在商户结账时选择 9Pay 作为付款方式后，客户将被转到 9pay 付款页面。选择 9Pay 电子钱包后，会出现一个二维码。然后，顾客打开手机上的 9Pay 应用程序，扫描浏览器页面上显示的条形码，完成付款。
本地借记卡	在商家结账时选择 9Pay 作为付款方式后，客户将被转到 9Pay 付款页面。然后选择本地借记卡和本地银行名称，客户填写银行卡信息，完成付款。
国际卡	在商户结账时选择 9Pay 作为付款方式后，客户将被重定向到 9pay 付款页面。选择国际卡作为付款方式。填写银行卡信息，完成付款。
银行转账	在商户结账时选择 9Pay 作为付款方式后，客户将被转到 9pay 付款页面。选择银行转账，顾客就可以通过银行转账完成付款。

整合方法 #

付款方式枚举值： 9 付款

9Pay 有两种集成方法

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

直接 API #

付款流程 #

对于直接 API 集成，通过 OpenAPI 创建付款意向后，客户将被重定向到 9Pay 登录页面。客户选择付款方式

例如，客户选择 9Pay 电子钱包。然后顾客扫描二维码完成支付。

之后，客户将被重定向到您指定的页面。

如何整合 #

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

创建 PaymentIntent

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

要求

{
    "金额":10000、
    "货币": "越南盾"、
    "确认":true、
    "payment_method_data" : {
        "类型": "9pay
    },
    "return_url": "https://swooshtransfer.com/"
}

回应

{
    "id"："pi_1668947502776188928",
    "对象"："payment_intent"、
    "创建"：1686743067000,
    "livemode": false、
    "currency"："越南盾"、
    "金额"：10000,
    "status"："requires_action"、
    "client_secret": "pi_1668947502776188928_secret_5eKUVX8MFLiS0nSMEG35YWDJ",
    "next_action"：{
        "type"："9pay_handle_redirect"、
        "9pay_handle_redirect"：{
            "url"："https://sand-payment.9pay.vn/portal?baseEncode=eyJhbW91bnQiOiIxMDAwMCIsImN1cnJlbmN5IjoiVk5EIiwiZGVzY3JpcHRpb24iOiJkZXNjcmlwdGlvbiIsImludm9pY2Vfbm8iOiJjaF8xNjY4OTQ3NTAyOTAyMDE4MDQ4IiwibWVyY2hhbnRLZXkiOiJQVEpwOXUiLCJyZXR1cm5fdXJsIjoiaHR0cHM6Ly9hcGl0ZXN0Lndvb3NocGF5LmNvbS92MS9yZWNlaXZlcy9jMTEvcnVybCIsInRpbWUiOiIxNjg2NzQzMDY2In0=&signature=jhZPpXG1XQDVwnexSSnr0WQap2HpLx0NqeeY2NDj3kQ="
        }
    },
    "payment_method_types"：[
        "9pay" [
    ],
    "确认方式"："自动"、
    "return_url"："https://swooshtransfer.com/"、
    付款方式"："pm_1668947502629388288"pm_1668947502629388288",
    "capture_method"：自动
}

跳转收银台 #

付款流程 #

客户从可用付款方式列表中选择 9Pay 并点击付款按钮

客户将被重定向到 9Pay 登录页面

例如，客户选择 9Pay 电子钱包。然后顾客扫描二维码完成支付。

之后，客户将被重定向到您指定的页面。

创建会话 #

要求

{
    "cancel_url"："https://swooshtransfer.com/"、
    "模式"："付款"、
    "success_url"："https://swooshtransfer.com/"、
    "付款方式"：[
        "9pay
    ],
    "行项目"：[
        {
            "price_data"：{
                "currency"："越南盾"、
                "product": null、
                "unit_amount"：10000,
                "active": true、
                "元数据"：{
                    "key1"："value1"、
                    "key2"："value2"
                },
                "昵称"："apple"、
                "product_data"：{
                    "id": null、
                    "名称"："apple"、
                    "active": true、
                    "描述"："非常美味"、
                    "元数据"：{
                        "key1"："value1"、
                        "key2"："value2"
                    },
                    "url"："www.baidu.com"
                },
                "billing_scheme"："testscheme"、
                "lookup_key"："test_lookup_key
            },
            "数量"：1
        }
    ]
}

回应

{
    "id"："cs_1668947425479360512",
    "对象"："checkout.session"、
    "创建"：1686743048000,
    "livemode": false、
    "currency"："越南盾"、
    "客户"："",
    "模式"："付款"、
    "状态"："open"、
    "url"："https://checkouttest.wooshpay.com/pay/cs_test_1668947425479360512?key=pk_test_NTE2Njg1MDgwNDUzOTY4MDc2ODAxOm9Oa3pjN043U2dYWE84VVhGZmF4cThvTTE2ODY2MzgyOTYzMjU"、
    "cancel_url"："https://swooshtransfer.com/"、
    "行项目"：{
        "对象"："list"、
        "数据"：[
            {
                "id"："li_1668947425508720640",
                "对象"："项目"、
                "货币"："越南盾"、
                "description"："苹果"、
                价格{
                    "id"："price_1668947425533886464",
                    "对象"："价格"、
                    "创建"：1686743048000,
                    "livemode": false、
                    "active": true、
                    "货币"："越南盾"、
                    "元数据"：{
                        "key1"："value1"、
                        "key2"："value2"
                    },
                    "昵称"："apple"、
                    "产品"：{
                        "id"："prod_1668947425546469376",
                        "对象"："产品"、
                        "创建"：1686743048000,
                        "livemode": false、
                        "active": true、
                        "description"："非常美味"、
                        "元数据{
                            "key1"："value1"、
                            "key2"："value2"
                        },
                        "名称"："apple"、
                        "url"："www.baidu.com"、
                        "更新"：1686743048000
                    },
                    "类型"："one_time"、
                    "unit_amount"：10000,
                    "计费方式"："per_unit"、
                    "lookup_key"："test_lookup_key
                },
                "数量"：1,
                "amount_subtotal": 10000、
                "amount_total": 10000
            }
        ]
    },
    "payment_intent"："pi_1668947425710047232",
    "payment_method_types"：[
        "9pay
    ],
    "付款状态"未支付"、
    "success_url"："https://swooshtransfer.com/"、
    "amount_subtotal": 10000、
    "amount_total": 10000、
    "billing_address_collection"："auto"、
    "expires_at"：1686829448437,
    "payment_link"："",
    "client_secret": "pi_1668947425710047232_secret_beZrT7mccYT27tC9ju0RbvlJ"
}