Transfers

Learn how to move funds between your financial accounts

Funds can be instantly moved between certain financial accounts via API. We currently support the following transfers:

  • Disbursing funds from the program issuing financial account to an end-user's issuing financial account
  • Withdrawing funds from an end-user's issuing financial account back to the program issuing financial account
  • Transfers must be between financial accounts of the same currency

Create Transfers

Transfer funds between two financial accounts under the same program

POST https://api.lithic.com/v1/transfer

Sample Request

curl http://api.lithic.com/v1/transfer \
    -X POST \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
    -d '
{
    "from": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "to": "87654321-aa69-4cbc-a946-30d90181ccaa",
    "amount": 1000,
    "transaction_token": "cd0bc5a8-074b-437f-8601-117462750f40"
}
'

Sample Response

{
  "category": "TRANSFER",
  "status": "SETTLED",
  "result": "APPROVED",
  "token": "cd0bc5a8-074b-437f-8601-117462750f40",
  "settled_amount": 1000,
  "pending_amount": 0,
  "currency": "USD",
  "events": [
    {
      "amount": 1000,
      "type": "TRANSFER",
      "result": "APPROVED",
      "created": "2022-07-18T21:40:07.011Z",
      "token": "ba9a1a51-d035-4c21-a2a2-ed00a8f1f209"
    }
  ],
  "descriptor": "Transfer - from: 3fa85f64-5717-4562-b3fc-2c963f66afa6 to: 87654321-aa69-4cbc-a946-30d90181ccaa",
  "created": "2022-07-18T21:40:07.011Z",
  "updated": "2022-07-18T21:40:07.011Z",  
  "from_balance": {
    "financial_account_type": "ISSUING",
    "financial_account_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "currency": "USD",
    "available_amount": 9000,
    "pending_amount": 0,
    "total_amount": 9000,
    "created": "2022-07-18T21:47:54.787Z",
    "updated": "2022-07-18T21:47:54.787Z",
    "last_transaction_token": "cd0bc5a8-074b-437f-8601-117462750f40",
    "last_transaction_event_token": "a43ba171-0da8-405f-9a4e-b583f36ec967"
  },
  "to_balance": {
    "financial_account_type": "ISSUING",
    "financial_account_token": "87654321-aa69-4cbc-a946-30d90181ccaa",
    "currency": "USD",
    "available_amount": 1000,
    "pending_amount": 0,
    "total_amount": 1000,
    "created": "2022-07-18T21:47:54.787Z",
    "updated": "2022-07-18T21:47:54.787Z",
    "last_transaction_token": "cd0bc5a8-074b-437f-8601-117462750f40",
    "last_transaction_event_token": "b7f93ded-87fd-4672-bcd4-c18102c23e31"
  }
}
from (required)Globally unique identifier for the financial account that will send the funds.
String. Permitted values: 36-digit version 4 UUID (including hyphens).
to (required)Globally unique identifier for the financial account that will receive the funds. 
String. Permitted values: 36-digit version 4 UUID (including hyphens).
amount (required)Amount to be transferred in the currency’s smallest unit (e.g., cents for USD). This should always be a positive value.
Integer. Permitted values: 0 or greater.
memo (optional)Optional descriptor for the transfer. Defaults to "Transfer - from: UUID to: UUID"
String. Permitted values: 1-512 characters.
transactiontoken (optional)_Customer-provided transaction token that will serve as an idempotency token.
String. Permitted values: 36-digit version 4 UUID (including hyphens).