サイバーソース
このページでは、CybersourceをDEUNAプラットフォームに統合するための包括的なガイドを提供します。
CybersourceはVisaが提供するグローバルな決済ゲートウェイであり、安全なカードを持たない決済処理を可能にします。DEUNAは、標準的なEC取引と、航空会社固有のデータフィールドを含む、特殊な旅行業界の処理をサポートするREST APIを通じてCybersourceと統合します。
Supported Operations
- 認証
- 決済(全額および一部)
- Purchase (auto-capture)
- Cancel (Void)
- 払い戻し(全額および一部)
- 分割払い(MXのみ対応)
- 3DS MPI
- Multiple partial captures and refunds can be enabled through configuration in the Admin.
支援された支払方法
- Visa
- Mastercard
- American Express
- Diners
利用可能な国と通貨
- 米ドル (USD) およびメキシコペソ (MXN)
Cybersourceとの統合#
- 管理画面の「Connections」セクションでCybersourceを探してください。
- Inicie sesión en su sesión de administración de DEUNA.
- クリック 接続.
- 「Astropay」を検索 Cybersource および、「クリック」 Connect.
- 「Connections」セクションで、Cybersourceの設定パネルが開きます。以下の情報を入力してください。
- 名前: この認証設定を参照するための名前を入力してください。
- 通貨: 使用する通貨
- **ファイル。**Cybersource API のプライベートキーを入力してください。
- 公開鍵: 公開鍵を入力してください。
- Merchant ID: Cybersourceの商社IDを入力してください。
- Acquirer configuration(MXのみ): merchantは使用するプロセッサを選択できます。指定がない場合は、以下のいずれかを選択してください。 デフォルト option.
- Operations: 実行する操作の種類を選択してください: 購入 または 認証
- Choose if you want to activate DEUNA's Multiple Partial Capture, Multiple Partial Refund, and/or 3DS DEUNA.
- クリック Connect. 完了後、確認メッセージが表示されます。その後、アクティブな接続タブで確認できます。
インタラクティブな例サンプルデータを使用し、APIリクエストは行いません。
決済
Acme LATAM · 本番環境接続
決済、ウォレット、および不正検知の統合を発見および管理します。
| 接続 | 種類 | ステータス | アクション |
|---|---|---|---|
| Adyen | 決済ゲートウェイ | 接続済み | |
| Worldpay | 決済ゲートウェイ | 接続済み | |
| PayPal | 決済方法 | 接続済み | |
| Mercado Pago | 決済方法 | 接続されていない | |
| Riskified | 不正検知エンジン | 接続されていない |
Travel Industry
- DEUNAは、Cybersourceを通じて航空・旅行業界向けの決済処理をサポートします。航空会社固有のデータを送信することで、取引に有利なインターチェンジレートを適用し、カードネットワークの要件に準拠できます。 _これは、米国市場でのみ利用可能です。
- 航空会社関連のフィールドには、Auth + Captureフローが必要です
- 航空会社のデータフィールドを提出する()
orderType": "AIRLINE_ORDER") は、承認 + 決済のステップでのみサポートされています。 - これは、サイバースourcenの制限であり、DEUNAの制限ではありません。「自動決済」の操作は、航空会社データフィールドをサポートしていません。
- 航空会社データを利用するには、管理画面で「承認」を操作タイプとして設定してください。
- 航空会社のデータフィールドを提出する()
必須フィールド - 航空会社の注文
| DEUNA's Field | 説明 |
|---|---|
order.airline_information.booking_items.legs[].carrier_code | フライトセグメント用の航空会社コード。IATAは2文字のアルファベット表記です。 |
order.airline_information.booking_items.legs[].departure_date | フライトセグメントの出発日。 |
order.airline_information.booking_items.legs[].origin | フライトの出発空港コード。 IATA 3文字のアルファベット。 |
order.airline_information.booking_items.legs[].destination | 目的地空港コード。IATA 3文字アルファベット |
order.airline_information.booking_items.legs[].fare_basis | チケットに関連付けられた料金体系コード。 最大6文字。 |
order.airline_information.booking_items.passenger_name | 乗客の名前。 |
order.airline_information.booking_items.pnr | 予約参照/PNR。 |
例:
JSON
{
"order": {
"airlineInformation": {
"bookingItems": [
{
"legs": [
{
"carrierCode": "AM",
"destination": {
"date": "26-03-26",
"iataCode": "MEX",
"time": "11:50"
},
"fareBasisCode": "Y",
"flightNumber": "411",
"origin": {
"date": "26-03-26",
"iataCode": "EWR",
"time": "08:01"
},
"serviceClass": "V",
"stopoverCode": "O"
},
],
"passenger": {
"firstName": "***dido",
"lastName": "***chez",
"type": "ADT"
},
"pnr": "CSOIUN"
}
]
},
"billingAddress": {
"address1": "***************3626",
"address2": "***** 100",
"addressType": "other",
"city": "Sacramento",
"countryCode": "PE",
"createdAt": "2024-01-24T17:04:18.341610378Z",
"email": "******eira@deuna.com",
"firstName": "Jean",
"identityDocument": "*******5894",
"lastName": "*mith",
"phone": "********7761",
"stateName": "LIM",
"updatedAt": "2024-01-24T17:04:18.34161046Z",
"zipcode": "95864"
},
"currency": "USD",
"itemsTotalAmount": 200,
},
"orderId": "66cc4f9d-293c-41a7-af80-377360a26134",
"subTotal": 200,
"timezone": "America/Mexico_City",
"totalAmount": 200,
"webhookUrls": {
"notifyOrder": "https://webhook.site/cadu"
}
},
"orderType": "AIRLINE_ORDER"
}特別な考慮事項と制限事項#
非同期処理とステータス更新
- 対照的に、Cybersourceはトランザクションの送信後、最終的なステータスを即座に返しません。トランザクションは、最終的な処理が完了するまで、中間ステータスを経由します。
- Cybersourceは、夜間に処理を行います。 昼間は、トランザクションが
Processing,CapturingまたはRefundingstatus. - Cyberosurce側の処理が完了した後、DEUNAは取引を最終ステータスに更新します。 merchantは、DEUNAの取引ステータスエンドポイントを使用して、取引の現在の状態を確認する必要があります。