Giropayはインターバンク・システムである。 その 2005年にドイツの銀行がオンライン・バンキングの公式支払い方法として採用した。4,000万人以上の買い物客が利用し、ドイツのオンライン取引全体の16%を占めている。
特徴 #
利用可能な国コード | DE |
---|---|
通貨の処理 | ユーロ |
決済通貨 | ユーロ |
最低取引額 | 1.00 EUR |
最大取引額 | 制限はない。 10,000ユーロまで - 支払い保証*付き 10,000ユーロ以上 - 支払いは保証されません。 |
払い戻し | ✅ |
一部払い戻し | ✅ |
複数回の一部払い戻し | ✅ |
チャージバック | ❌ |
*giropayは契約上、最初の取引から6週間まで支払いを保証します。
統合方式 #
支払い方法の列挙値: ジロペイ
Giropayとの統合方法があります。
- ダイレクトAPI
- チェックアウト
ダイレクト API #
統合の方法 #
直接APIを統合するには、PaymentIntentを作成し、1つのステップでURLを取得することができます。以下はペイメントインテントを作成するデモです:
PaymentIntentは、顧客から支払いを収集する意図を表すオブジェクトで、支払いプロセスのライフサイクルを追跡します。サーバー上にPaymentIntentを作成し、収集する金額とサポートする通貨を指定します。既存の PaymentIntent を統合している場合は、PaymentIntent を追加します。 ジロペイ を支払方法タイプのリストに追加する。
この支払い方法では、国名を 請求先住所
をドイツとすると、国番号は DE
.
リクエスト PaymentIntentの作成
{
"金額":2000,
"通貨":"EUR"、
"confirm": true、
"payment_method_data":{
"type":"giropay"、
"billing_details":{
"address":{
"country":"DE"
},
"firstName":"",
"lastName":""
}
},
"return_url":"https://wooshpay.com"
}
応答
{
"id":"pi_1670644604036186112",
"オブジェクト":"payment_intent"、
"created":1687147687000,
"livemode": false、
「通貨":"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"
],
"confirmation_method":"automatic"、
"return_url":"https://wooshpay.com"、
"payment_method":"pm_1670644603939717120",
"capture_method":"automatic"
}
チェックアウト #
支払いの流れ #
- 利用可能な支払い方法のリストからGiropayを選択し、Payボタンをクリックします。
- お客様はGiropayのページにリダイレクトされます。
- 顧客は銀行を選択し、オンライン・バンキングで支払いを承認する。
シーシオンを作る #
リクエスト セッションの作成
{
"cancel_url":"www.wooshpay.com"、
"mode":「支払い」、
"success_url":"https://wooshpay.com/"、
"payment_method_types":[
"giropay"
],
"line_items":[
{
"price_data":{
"currency":"EUR"、
"product": null、
"unit_amount":2000,
"product_data":{
"name":"アップル"
},
"billing_scheme":"testscheme"、
"lookup_key":"test_lookup_key"
},
「数量":1
}
]
}
応答
{
"id":"cs_1680883889586831360",
"オブジェクト":"checkout.session"、
"created":1689588923000,
"livemode": false、
「通貨":"EUR"、
"customer":"",
「mode":「支払い
"status":「オープン
"url":"https://checkouttest.wooshpay.com/pay/cs_test_1680883889586831360?key=pk_test_NTE2Njk1Mjk1ODMxNjAwMDQ2MDkxOmVqUkVxaWdMOVNQSGpRdmV0ZXUxZFBmcTE2ODY4ODE4NDY0MTg"、
"cancel_url":"www.wooshpay.com"、
「line_items":{
"object":"リスト"、
"data":[
{
"id":"li_1680883889620385792",
"object":"item": "アイテム"、
"currency":通貨": "EUR
"説明":"リンゴ"、
「価格":{
"id":"price_1680883889632968704",
"object":"価格"、
"created":1689588923000,
"livemode": false、
「active": false、
「currency":"EUR"、
"product":{
"id":"prod_1680883889641357312",
"object":"product"、
"created":1689588923000,
"livemode": false、
「active": false、
"name":"apple"、
"更新":1689588923000
},
"type":"one_time"、
"unit_amount":2000,
「課金方式":"per_unit"、
「lookup_key":"test_lookup_key"
},
"quantity":1,
「amount_subtotal": 2000、
「金額_合計": 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":"自動"、
"expires_at":1689675323250,
"payment_link":"",
"client_secret": "pi_1680883889804935168_secret_oOaiHu8k190zNlX9zeIV5xkl"
}
次のステップ #
必要に応じて、統合にさらに機能を追加することができます。
ウェブフックの作成 #
統合が自動的にリアクションをトリガーできるように、WooshPayアカウントのイベントをリッスンします。enabled_eventsとurlにフォーカスしたWebhookを作成します。
払い戻しの作成 #
顧客に資金を返済するために返金を作成します。部分払い戻しを行うこともできますが、すべての支払い方法が対応しているわけではありません。部分払い戻しとは、元の取引金額の一部のみを払い戻すことです。