Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumx.io/llms.txt

Use this file to discover all available pages before exploring further.

A destination is where fiat funds are sent when converting stablecoin to fiat or executing payouts.

What is a destination?

Destinations are linked to customers and define where funds should be sent. Each destination includes:
  • Account holder details and banking information
  • The relationship between the customer and account holder
  • Support for multiple payment rails depending on country and currency
Destinations work across all supported payment rails. For complete coverage details, see Coverage.

Holder relationships

When adding a destination to a customer, you must specify the relationship between the customer and the account holder.

Self payments

If the customer is sending funds to their own destination, use:
RelationshipUse case
SELFWithdrawals and transfers to the customer’s own destination for personal or business use

Third-party payments

If the customer is paying a third party (e.g., suppliers, partners, creditors), use one of the following relationships:
RelationshipUse case
HOLDING_COMPANYParent or controlling company that owns the customer entity
SUBSIDIARY_COMPANYSubsidiary or controlled entity owned by the customer
BRANCH_OFFICEBranch, regional office, or division of the customer’s organization
BUSINESS_PARTNERStrategic partners, joint venture collaborators, or business associates
SUPPLIERVendors, suppliers, or service providers for goods and services purchased
CUSTOMERCustomer’s clients for refunds, rebates, or other customer obligations
CREDITORLenders, financial institutions, or parties to whom the customer owes money
DEBTORParties who owe money to the customer (collections or debt settlements)
FRANCHISEEFranchisees operating under the customer’s brand or business model
Example: A Brazilian company paying a supplier in the United States would create a destination with SUPPLIER as the holder relationship and provide the supplier’s US bank details.
Destinations support both business entities and individual account holders. See changelog v2.4.0 for details.