Download OpenAPI specification:Download
The Balance Transfer API enables you to transfer money between Tilia wallets in a way that doesn't imply payment processing i.e. without taxes, currency conversion, receipts, refunds or product delivery. Each balance transfer request results in a single invoice, with a line item and subitem for each balance transfer in the request. For a given balance transfer, either the source or destination wallet or both must belong to the primary account.
Execute one or more individual balance transfers between wallets.
Successful completion triggers these notifications |
---|
Balance transfer completed |
Invoice complete |
For more information about event notifications, visit Webhooks.
Balance transfer request
Successfully transfered balance(s).
Invalid request.
Unauthorized access.
Service unavailable or server error.
{- "account_id": "acct_2TiDFXHVFMlAuyy7ovvz3YPKv9b",
- "balance_transfer_type": "payout_token_conversion_reversal",
- "transfer_items": [
- {
- "source_wallet_id": "wal_2V2cKKIT5fKwlYVYNBRLaWZGmQX",
- "destination_wallet_id": "wal_2V2cKMJI4AtLkF8eQaVi1NAl9wL",
- "amount": 100,
- "currency": "USD",
- "transfer_item_type": "usd_user_to_integrator_sink",
- "description": "user's USD wallet -> integrator's USD sink wallet"
}, - {
- "source_wallet_id": "wal_2V2cKPhz9mEMnlVmAAsurzkfa9o",
- "destination_wallet_id": "wal_2V2cKKKnzmnVvJCl02O0Bc9KnfV",
- "amount": 100,
- "currency": "VIR",
- "transfer_item_type": "virtual_integrator_source_to_user_convertible",
- "description": "integrator's virtual source wallet -> user's virtual convertible wallet"
}
], - "reference_type": "invoicing.token_exchange.id",
- "reference_id": "vtok_2Acn1Y46LaM9csSoEWYqUyESwi7",
- "description": "Payout token conversion reversal",
- "metadata": {
- "key1": {
- "key2": 3
}
}
}
{- "status": "Success",
- "message": [ ],
- "codes": [ ],
- "payload": {
- "account_id": "acct_2TiDFXHVFMlAuyy7ovvz3YPKv9b",
- "balance_transfer_type": "reverse_token_conversion",
- "balance_transfer_id": "bt_2V2QRiOuoXSntU4aEkW4RHSttmt",
- "invoice_id": "inv_2V2XDLW6zogChdShdFh8WKOhHii",
- "transfer_items": [
- {
- "source_wallet_id": "wal_2V2cKKIT5fKwlYVYNBRLaWZGmQX",
- "source_account_id": "acct_2UU7yuHWGs2vwShyoUKeebMk5E5",
- "destination_wallet_id": "wal_2V2cKMJI4AtLkF8eQaVi1NAl9wL",
- "destination_account_id": "acct_2UU7ypRsFlZPnrOZDaIUIDaSwPs",
- "amount": 100,
- "currency": "USD",
- "transfer_item_type": "usd_user_to_integrator_sink",
- "description": "user's USD wallet -> integrator's USD sink wallet"
}, - {
- "source_wallet_id": "wal_2V2cKPhz9mEMnlVmAAsurzkfa9o",
- "source_account_id": "acct_2UU7yq4TzsWbEqLz7i1gSTWpNfO",
- "destination_wallet_id": "wal_2V2cKKKnzmnVvJCl02O0Bc9KnfV",
- "destination_account_id": "acct_2UU7yuT2mN7IlBfaaZxu9y3HgR1",
- "amount": 100,
- "currency": "VIR",
- "transfer_item_type": "virtual_integrator_source_to_user_convertible",
- "description": "integrator's virtual source wallet -> user's virtual convertible wallet"
}
], - "reference_type": "invoicing.token_exchange.id",
- "reference_id": "vtok_2Acn1Y46LaM9csSoEWYqUyESwi7",
- "description": "Payout token conversion reversal",
- "metadata": {
- "key1": {
- "key2": 3
}
}, - "failure_reason": ""
}
}