🛠️
Integration Guide
  • 🔎Overview
    • 👋Welcome to XGateway
      • Integrate with XGateway
      • Supported currencies
      • KYC
  • ⚙️Integration Guides
    • Crypto Payments using Checkout
    • SEPA Secure payments using Checkout
    • Alternative Payment Methods using Checkout
    • Crypto Payments using API
    • Advanced features of Invoice creation
  • ❔Miscellaneous
    • Keys and authentication
    • Check transaction status
    • Environments
    • Invoice currencies
    • Deposit data confirmation
    • Callbacks
      • Transaction callback
      • Bank Account callback
      • KYC callback
    • Withdrawal initiation with API
    • Disputes resolution
  • 💱Payment flows
    • Transaction flowchart
    • KYC checks diagram
    • Confirmation subprocess
    • User flow for Crypto Payments
    • User flow for SEPA Secure
    • Fees structure
      • Adjustable BTC Minimum Deposit Fee Framework
  • 🏤Back office
Powered by GitBook
On this page
  • Base Currency
  • Transaction Currency (Payment Currency)
  • Reference Currency
  • Display Currencies
  1. Miscellaneous

Invoice currencies

This page contains definitions of the concepts important for integration with XGateway.

PreviousEnvironmentsNextDeposit data confirmation

Last updated 8 days ago

Base Currency

Base Currency is the currency of a customer deposit or withdrawal. It is used to initiate the deposit invoice or withdrawal request. This is the currency a customer will typically see on the merchant cashier page.

Example: A customer wants to deposit 10 EUR of ETH. In this case the base currency is EUR.

Transaction Currency (Payment Currency)

A transaction currency (aka payment currency) is the currency that is received by XGateway and available for settlement by the corresponding merchant. In case of Crypto Payments, this is the currency used to make the transaction on the blockchain to move the value, ie ETH, BTC, any ERC-20 token etc.

Example: A customer wants to deposit 10 EUR of ETH. In this case the transaction currency is ETH.

NOTE: In the sent to a merchant the transaction currency is named 'currency'.

Reference Currency

The reference currency is the currency used for cross-account accounting for a corresponding merchant. The default value is USD.

This currency is used to display turnover and other statistics in the merchant backoffice. An amount of a transaction converted to the reference currency is also sent within a callback.

Example: A customer wants to deposit 10 EUR of ETH. The XGateway will convert 10 EUR to USD and sent the resulting amount as a reference amount.

Display Currencies

This is an array of currencies used to manage the display of currencies on the Checkout page. When an array is provided, the function preserves and respects the specified list and order of the currencies shown to the customer.

❔
callback