Giropay 是一个银行间系统,由 的 2005 年,德国银行将其作为网上银行的官方支付方式。在德国,有 4000 多万购物者可以使用这种支付方式,占所有在线交易的 16%。
特点 #
可用的国家代码 | 可选择丢弃 |
---|---|
处理货币 | EUR |
结算货币 | EUR |
最低交易金额 | 1.00 欧元 |
最高交易金额 | 无限制。 最高 10.000 欧元 - 保证支付* 超过 10.000 欧元 - 不保证付款 |
退款 | ✅ |
部分退款 | ✅ |
多次部分退款 | ✅ |
扣款 | ❌ |
*giropay按合同保证在首次交易后 6 周内付款。
整合方法 #
付款方式枚举值: 支付宝
有集成 Giropay 的方法
- 直接应用程序接口
- 跳转收银台
直接 API #
如何整合 #
若要直接集成 API,只需一步即可创建 PaymentIntent 并获取 url。以下是创建付款意图的演示:
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":自动
}
跳转收银台 #
付款流程 #
- 客户从可用支付方式列表中选择 Giropay 并点击 "支付 "按钮
- 客户将被重定向到 Giropay 页面
- 客户通过网上银行选择银行并批准付款
创建视图 #
要求 创建会话
{
"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。
创建退款 #
创建退款,将资金返还给客户。您也可以执行部分退款,但并非每种支付方式都支持。部分退款是指只退还原始交易金额的一部分。