Giropay

Giropay 是一个银行间系统,由 2005 年,德国银行将其作为网上银行的官方支付方式。在德国,有 4000 多万购物者可以使用这种支付方式,占所有在线交易的 16%。

特点 #

可用的国家代码可选择丢弃
处理货币EUR
结算货币EUR
最低交易金额1.00 欧元
最高交易金额无限制。
最高 10.000 欧元 - 保证支付*
超过 10.000 欧元 - 不保证付款
退款
部分退款
多次部分退款
扣款

*giropay按合同保证在首次交易后 6 周内付款。

整合方法 #

付款方式枚举值: 支付宝

有集成 Giropay 的方法

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

直接 API #

如何整合 #

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

创建 PaymentIntent

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

请注意,对于这种付款方式,您需要在 账单详情地址 作为德国,哪个国家的代码是 可选择丢弃.

要求 创建 PaymentIntent

{
    "金额":2000,
    "currency":"EUR"、
    "confirm": true、
    "payment_method_data":{
        "type":"giropay"、
        "billing_details":{
            "地址":{
                "country":"DE"
            },
            "名":"",
            "姓":""
        }
    },
    "return_url":"https://wooshpay.com"
}

回应

{
    "id":"pi_1670644604036186112",
    "对象":"payment_intent"、
    "创建":1687147687000,
    "livemode": false、
    "currency":"EUR"、
    "金额":2000,
    "status":"requires_action"、
    "client_secret": "pi_1670644604036186112_secret_9UHXdOLAE1WV7A1UCIjH8nMP",
    "next_action":{
        "type":"redirect_to_url"、
        "giropay_handle_redirect":{
            "url":"https://r3.girogate.de/ti/simgiropay?tx=2090827518&rs=33tiT9GdES3vl4zIQ4ShK4Sw3NsvymQj&cs=0981d204f358af0d05ea4aa49a2b678fbe36aa4f13af2624441385921431f7a6"
        }
    },
    "payment_method_types":[
        "giropay" [
    ],
    "确认方式":"自动"、
    "return_url":"https://wooshpay.com"、
    付款方式":"pm_1670644603939717120"pm_1670644603939717120",
    "capture_method":自动
}

跳转收银台 #

付款流程 #

  1. 客户从可用支付方式列表中选择 Giropay 并点击 "支付 "按钮
下载.png
  1. 客户将被重定向到 Giropay 页面
下载 (1).png
  1. 客户通过网上银行选择银行并批准付款
下载 (2).png
下载 (3).png

创建视图 #

要求 创建会话

{
    "cancel_url":"www.wooshpay.com"、
    "模式":"付款"、
    "success_url":"https://wooshpay.com/"、
    "付款方式":[
        "giropay" [
    ],
    "行项目":[
        {
            "价格数据{
                "currency":"EUR"、
                "product": null、
                "unit_amount":2000,
                "product_data":{
                    "名称":"苹果"
                },
                "计费方案":"testscheme"、
                "lookup_key":"test_lookup_key
            },
            "数量":1
        }
    ]
}

回应

{
    "id":"cs_1680883889586831360",
    "对象":"checkout.session"、
    "创建":1689588923000,
    "livemode": false、
    "currency":"EUR"、
    "客户":"",
    "模式":"付款"、
    "状态":"open"、
    "url":"https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg"、
    "cancel_url":"www.wooshpay.com"、
    "行项目":{
        "对象":"list"、
        "数据":[
            {
                "id":"li_1680883889620385792",
                "对象":"项目"、
                "货币":"EUR"、
                "description":"苹果"、
                价格{
                    "id":"price_1680883889632968704",
                    "对象":"价格"、
                    "创建":1689588923000,
                    "livemode": false、
                    "active": false、
                    "currency":"EUR"、
                    "产品":{
                        "id":"prod_1680883889641357312",
                        "对象":"产品"、
                        "创建":1689588923000,
                        "livemode": false、
                        "active": false、
                        "名称":"apple"、
                        "更新": false1689588923000
                    },
                    "类型":"one_time"、
                    "unit_amount":2000,
                    "计费方式":"per_unit"、
                    "lookup_key":"test_lookup_key
                },
                "数量":1,
                "amount_subtotal": 2000、
                "amount_total": 2000
            }
        ]
    },
    "payment_intent":"pi_1680883889804935168",
    "payment_method_types":[
        "giropay
    ],
    "payment_status":"未支付"、
    "success_url":"https://wooshpay.com/"、
    "amount_subtotal": 2000、
    "amount_total": 2000、
    "billing_address_collection":"auto"、
    "expires_at":1689675323250,
    "payment_link":"",
    "client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}

下一步 #

您可以根据需要为集成添加更多功能

创建 Webhook #

监听 WooshPay 账户上的事件,以便您的集成可以自动触发反应。创建一个 webhook,主要关注 enabled_events 和 url。

创建退款 #

创建退款,将资金返还给客户。您也可以执行部分退款,但并非每种支付方式都支持。部分退款是指只退还原始交易金额的一部分。

What are your feelings
Updated on 8月 8, 2023