通貨換算 | DEUNA Docs

このページで

主な利点
為替換算のタイミング
主要な概念
アーキテクチャオプション
統合オプション
通貨換算

DEUNAの通貨換算機能により、商社は複数の通貨で価格を表示し、支払い処理を行うことができ、同時に、決済通貨、コスト構造、およびユーザーエクスペリエンスを制御できます。
DEUNAは、FXプロバイダーとの統合を集中させることで、クロスボーダー業務を簡素化し、取引ライフサイクル全体で換算の詳細が一貫して流れることを保証します。

商社は、自社のFXデータを提供するか、またはDEUNAの統合されたレートサービスを利用できます。

主な利点#

多通貨の受け入れ
市場ごとの顧客に、ローカライズされた価格と支払いオプションを提供します。
改善されたユーザーエクスペリエンス
購入者が理解できる通貨で支払うことを可能にし、摩擦を軽減します。
運用効率
複数のFXプロバイダーとの連携管理を避けてください。DEUNAがプロバイダー固有のフォーマットを処理します。
柔軟な決済オプション
Procese en una moneda mientras muestra o cobra en otra.

為替換算のタイミング#

クロスボーダー電子商取引 – 決済時にベース通貨で表示
送金と支払い – クロスボーダー送金時、送金または受取時に為替換算を実施。
旅行と航空 – グローバルな旅行者からの支払いと、異なる販売時点の通貨に対応。
金融サービス – 複数の通貨で表示された資産のFX換算を管理。

主要な概念#

為替レート
ある通貨を別の通貨に換算するために使用される値を決定します。固定、プロバイダー定義、またはリアルタイム市場の条件に基づいて設定できます。

ベース通貨
換算の出発点となる通貨。

購入者通貨
顧客への課金に使用する通貨。

為替スプレッド
基礎となる為替レートに対するプロバイダーが適用するマージン。

リアルタイムレート
為替レートは、商社またはDEUNAが換算を要求した時点でのレートが適用されます。

アーキテクチャオプション#

商社による為替処理フロー

フロー図

DEUNA商社または顧客

リアルタイム為替換算

フロー図

商社または顧客DEUNA結果またはアウトカム

統合オプション#

DEUNAは、決済処理中に為替換算を適用するための2つのモデルをサポートしています:

商取引者による為替レート
DEUNAによる為替レート取得（DEUNAが管理する為替レート）

両方のオプションでは、お客様への請求を1つの通貨で行い、収益を別の通貨で処理することが可能です。これは、貴社のビジネスおよび運用設定によって異なります。

1. merchant が提供する為替レート

もし貴社のビジネスがすでに外部のFXプロバイダーから為替レートを取得している場合、その情報をDEUNAの支払いリクエストの一部として送信できます。
DEUNA は、取引を決済機関またはプロセッサにルーティングする際に、これらの為替レートの詳細を含めます。

merchant が提供する為替レートを含む支払いリクエストの例

JSON

{
  "amount": {
    "currency": "COP",
    "value": 5000,
    "currency_conversion": {
      "external_rate_reference": "AAA01SADOIAJSDLAKSJM",
      "shopper_currency": "ARS",
      "shopper_amount": 1146.55
    }
  }
}

2. DEUNA レートサービス

DEUNA レートサービスは、商社がDEUNAに、統合された為替プロバイダーから為替レートを直接取得させることを可能にします。このオプションは、複数のプロバイダーとの連携や、異なるレート形式の管理を不要にし、DEUNAが為替業務全体を標準化したい場合に最適です。

このフローは、[DEUNA]のAPIを使用します。 二段階のプロセス:

為替レートの照会 DEUNA から取得した為替レート ID を使用する
Use the returned FX rate ID 支払いを作成する際に

これにより、提示された為替レートが最終取引に正しく関連付けられることを保証します。

通貨換算#

1. 為替レートの要求

以下の内容を示す要求を送信してください:

元のトランザクション通貨
ユーザーが希望する通貨
DEUNAがレートを取得するFXプロバイダー

要求

JSON

{
  "amount": 30000,
  "original_currency": "MXN",
  "destination_currency": "USD",
  "provider_info": {
     "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a"
  }
}

応答

JSON

{
  "currency_conversion": {
    "id": "ccv_7b29c4ab-f61d-4e58-9dc5-1a9fceb823b3",
    "original_currency": "MXN",
    "destination_currency": "USD",
    "original_amount": 30000,
    "destination_amount": 1764.71,
    "rate": 0.0588237,
    "provider_info": {
      "id": "f8e3a9bb-1f28-4b6c-ac12-7d9e3e84d04a",
      "name": "NUVEI",
      "timestamp": "2025-01-04T18:15:23Z"
    },
    "expires_at": "2025-01-04T18:20:23Z",
    "metadata": {
      "rate_type": "real_time",
      "precision": 6
    }
  }
}

2. 支払い作成時の為替レートIDの使用

以下の内容を示す要求を送信してください:

元のトランザクション通貨
購入者の希望する通貨
DEUNAがレートを取得するFXプロバイダー

購入APIでの例

JSON

{
  ...
  "total_amount": {
      "currency_conversion": {
          "external_rate_reference": "...",
          "original_currency": "MXN",
          "destination_currency": "USD",
          "original_amount": 30000,
          "destination_amount": 1764.71
      }
  }
  ...
}

設定要件

為替レートの変換フローを有効にするには、DEUNAの担当者に連絡してください。設定は、FXプロバイダー、地域、および商家の設定によって異なります。