How Tos

Create a Deposit

Copy page

In order to send payouts, you will need to deposit funds to a liquidity provider to exchange fiat to stablecoins (i.e. on-ramp funds).

Tesser treats deposits via a liquidity provider as a special class of payments, so the structure of the deposits API experience will be similar to sending a payment.

Register the source fiat bank account

Liquidity providers require that funds are on-ramped from an account owned by your organization. Ensure you have registered the source bank account prior to beginning the deposit process. For more information on account creation, see Create an account.

Deposit workflow

Like a payment, a deposit will execute over multiple steps.

• A transfer step indicates funds are moving from one account to another. Accounts can be a bank account, ledger, or wallet. The from_currency and to_currency may be the same in a transfer step or different.
• A swap step indicates currencies have been exchanged within an account. E.g. a trade was performed to sell USD and buy USDC or USDT within your ledger.

Each step has a status. For more information on the statuses of a transfer step, see Transfer steps statuses.

Deposit creation

Submit a request to the Deposit API.

• For all deposits, populate:
  • from_currency: Fiat currency you are on-ramping from
  • to_currency: Stablecoin currency you are on-ramping to
  • from_amount: Fiat amount to deposit
  • from_account_id: Identifier of the bank account fiat funds will be sent from. Previously registered (see above).
  • to_account_id: Identifier of the wallet or ledger account on the Tesser platform to deposit funds to.

• For deposits to a wallet account:
  • to_network: Stablecoin network on-ramping to. Not applicable if to_account_id has a type of "ledger".

Example request for deposit creation to a ledger account using Circle:

Code
 
{
  "from_currency": "USD",
  "to_currency": "USDC",
  "from_amount": "1000",
  "from_account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
  "to_account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca"
}

In the API response, Tesser will create and return an id for the deposit request.

Example response for deposit creation to a ledger account using Circle:

Code
 
{
  "data": {
    "id": "1c8e4a6f-9b2d-4f53-a0e7-5d3c1b9f2a8e",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "organization_reference_id": null,
    "direction": "inbound",
    "funding_account_id": null,
    "from_amount": "1000",
    "from_currency": "USD",
    "from_network": null,
    "from_account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
    "to_amount": null,
    "to_currency": "USDC",
    "to_network": null,
    "to_account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
    "steps": [],
    "created_at": "2024-03-01T10:00:00.000Z",
    "updated_at": "2024-03-01T10:00:00.000Z",
    "expires_at": "2024-03-01T14:00:00.000Z"
  }
}

Deposit updated with estimated amounts

After obtaining the exchange rate from the liquidity provider, Tesser will send a webhook notifying you of the updated deposit information. Based on the populated from_amount and to_amount fields, you can calculate an exchange rate between the fiat from_currency and stablecoin to_currency.

Also with this update, the steps for on-ramping will be articulated; each step will have a status of "created". If you want to proceed with the deposit, obtain the account information for the liquidity provider from Step 1 and send funds to the provider.

Example webhook schema for deposit to a ledger account using Circle:

Code
 
{
  "id": "event_222",
  "type": "deposit.quote_created",
  "created_at": "2025-12-01T10:00:00.100Z",
  "data": {
    "object": {
      "id": "1c8e4a6f-9b2d-4f53-a0e7-5d3c1b9f2a8e",
      "workspace_id": "b53f6690-3242-4942-9907-885779632832",
      "organization_reference_id": null,
      "direction": "inbound",
      "funding_account_id": null,
      "from_account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
      "from_amount": "1000",
      "from_currency": "USD",
      "from_network": null,
      "to_account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
      "to_amount": null,
      "to_currency": "USDC",
      "to_network": null,
      "steps": [
        {
          "id": "8a4f2c1e-9b6d-4e35-b7a0-3c5d1e9f2b8a",
          "transfer_id": "1c8e4a6f-9b2d-4f53-a0e7-5d3c1b9f2a8e",
          "step_sequence": 1,
          "step_type": "transfer",
          "from_account_id": "55042f8f-e527-56f1-b57c-eef23ca862db",
          "to_account_id": "a81bc1f4-7e3d-4926-b04f-3d2e8a9c5f17",
          "from_network": null,
          "from_amount": "1000",
          "from_currency": "USD",
          "to_network": null,
          "to_amount": "1000",
          "to_currency": "USD",
          "transaction_hash": null,
          "fees": [],
          "provider_key": "circle_mint",
          "status": "created",
          "status_reasons": null,
          "created_at": "2024-03-01T10:00:00.000Z",
          "updated_at": "2024-03-01T10:00:00.000Z",
          "submitted_at": null,
          "confirmed_at": null,
          "finalized_at": null,
          "completed_at": null,
          "failed_at": null
        },
        {
          "id": "3b7e9d2f-1c4a-4f68-a5b0-6e8c1d3f9a2b",
          "transfer_id": "1c8e4a6f-9b2d-4f53-a0e7-5d3c1b9f2a8e",
          "step_sequence": 2,
          "step_type": "transfer",
          "from_account_id": "a81bc1f4-7e3d-4926-b04f-3d2e8a9c5f17",
          "to_account_id": "44031e7e-d416-45f0-a46b-ded12b9751ca",
          "from_network": null,
          "from_amount": "1000",
          "from_currency": "USD",
          "to_network": null,
          "to_amount": "1000",
          "to_currency": "USDC",
          "transaction_hash": null,
          "fees": [],
          "provider_key": "circle_mint",
          "status": "created",
          "status_reasons": null,
          "created_at": "2024-03-01T10:00:00.000Z",
          "updated_at": "2024-03-01T10:00:00.000Z",
          "submitted_at": null,
          "confirmed_at": null,
          "finalized_at": null,
          "completed_at": null,
          "failed_at": null
        }
      ],
      "created_at": "2024-03-01T10:00:00.000Z",
      "updated_at": "2024-03-01T10:00:00.100Z",
      "expires_at": "2024-03-01T14:00:00.000Z"
    }
  }
}

Obtain instructions from the liquidity provider

The to_account_id field in the first step will always be populated with the Tesser identifier of the bank account of the liquidity provider. Submit a subsequent request to the Get deposit instructions endpoint with the to_account_id as the path parameter.

The response will contain the bank account information you need to deposit funds to the liquidity provider, including the account number, bank identifier code (BIC/SWIFT/Routing number).

Once you have the account information, you will initiate a push of funds to the liquidity provider from your bank account. This happens outside of Tesser's system.

Tesser will track the receipt of the fiat funds to the liquidity provider and the exchange of fiat into stablecoins. The status of each step will reflect the step's progress, and any reasons for exception or failure will be identified in the status_reasons array.