Bizum を Direct API を通じて、直接統合
DEUNA の直接 API を使用して、Bizum をお使いのアプリケーションの支払い方法として統合してください。
概要#
Bizum は、スペインの即時決済方法で、ユーザーが携帯電話番号を使用して支払うことを可能にします。DEUNA は、Redsys TPV Virtual を使用して Bizum を統合し、リダイレクトモデルを使用します。DEUNA API を通じて購入を開始した後、ユーザーは Redsys がホストするページにリダイレクトされ、そこで Bizum の認証を完了し、その後、お使いのサイトにリダイレクトされます。
要件:
- スペインでのみ利用可能
- 通貨: EUR のみ
- ユーザーは、スペインの銀行にリンクされた有効な Bizum アカウントを持っている必要があります。
購入 (バージョン 2)#
V2の購入は、注文の作成と支払い開始を単一のエンドポイントで行います。
Bizumでの購入プロセスは以下の通りです。
- ユーザーからの呼び出し
POST v2/merchants/order/purchase注文に関する情報とともに。 - DEUNA は注文を作成し、Redsys との Bizum 決済を開始します。
- DEUNA はレスポンスにリダイレクト URL を返します。
- ユーザーをその URL にリダイレクトし、Redsys のページで Bizum 認証を完了させます。
- 認証後、Redsys はユーザーをあなたのサイトにリダイレクトします。
- DEUNA は、最終決済ステータスの確認のために、Redsys のサーバー間通信を監視します。
Bizum を API を使用して統合#
1. Bizum を使用した購入
V2の「Purchase」エンドポイントへのリクエストを送信してください。 V2 Purchase endpoint.
DEUNA での Bizum 決済を行うには、V2 パイロードには以下の内容が含まれている必要があります。
- 注文データ
- 支払い完了後にユーザーをリダイレクトするためのコールバックURL
- オプションで、ユーザーのモバイル電話番号をBizum画面の事前入力に使用
リクエスト例
JSON
{
"order_type": "DEUNA_CHECKOUT",
"payment_source": {
"method_type": "bank_transfer",
"processor": "redsys_bizum",
"method_type_specific_fields": {
"bizum_mobile_number": "+34700000000"
}
},
"callback_urls": {
"on_success": "https://example.com/success",
"on_error": "https://example.com/error"
},
"order": {
"order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
"store_code": "all",
"currency": "EUR",
"total_amount": 1050,
"items_total_amount": 1050,
"sub_total": 1050,
"items": [
{
"id": "1",
"name": "Cinema ticket",
"description": "Standard ticket",
"total_amount": {
"amount": 1050,
"currency": "EUR",
"currency_symbol": "€"
},
"unit_price": {
"amount": 1050,
"currency": "EUR",
"currency_symbol": "€"
},
"quantity": 1
}
]
}
}2. ユーザーをリダイレクトする
購入が開始された後、APIはレスポンスとしてリダイレクトURLを返します。 next_action node.
- 指定されたURLを取得する。
- ユーザーをそのURLにリダイレクトする。
- ユーザーはRedsysページでBizum認証を完了する：
- 顧客のモバイル電話番号を入力
- BizumのPINを入力
- OTP（SMSまたはアプリ内）で確認
- 認証後、Redsysはユーザーをあなたのプラットフォームにリダイレクトします。
callback_urls.on_successまたはcallback_urls.on_error. - 最終決済ステータスの確認には、DEUNAのウェブフックを監視してください。
応答例
JSON
{
"order_type": "DEUNA_CHECKOUT",
"order_token": "db3fc147-2a4e-460f-a874-f6f79b1e651c",
"order": {
"order_id": "d81fe7bf-748b-4a7a-bc8f-7be98c8ae748",
"currency": "EUR",
"total_amount": 1050,
"status": "pending",
"payment": {
"data": {
"status": "pending",
"method_type": "bank_transfer",
"processor": "redsys_bizum",
"next_action": {
"action": "authorization_bank_transfer",
"authorization_bank_transfer": {
"redirect_url": "https://sis-t.redsys.es:25443/sis/realizarPago"
}
}
}
}
}
}テスト#
テスト目的で、以下のデータを使用できます。
- PINまたはSMSコードを要求された場合、以下の情報を入力してください 1234 PINコードと 123456 SMSコードを使用する場合：
Bizum ユーザー:
- 成功: 700 000 000
- 拒否: ko@ko.ko
金額とテスト対象のオペレーションの種類によっては、結果が異なる場合があります。
- 5€以下: 成功
- 5€から10€: 拒否
- トランザクション金額は10€を超えないようにしてください。そうでない場合、オペレーションは拒否されます。