Deposits

Deposits fund a wallet with external money — via bank transfer, stablecoin, or other supported methods.

Create a deposit

POST /api/v1/deposit

{
  "wallet_id": "wal_abc123",
  "from_amount": 100000,
  "from_currency_id": "USD",
  "reference": "DEP-001",
  "description": "Monthly funding"
}

Get deposit details

GET /api/v1/deposit/{deposit_id}

Response

{
  "id": "dep_xyz789",
  "wallet_id": "wal_abc123",
  "from_amount": 100000,
  "from_currency_id": "USD",
  "to_amount": 100000,
  "to_currency_id": "USD",
  "status": "completed",
  "reference": "DEP-001",
  "payment_instructions": [
    {
      "bank_name": "Example Bank",
      "account_name": "TurnStay Ltd",
      "account_number": "1234567890",
      "routing_number": "021000021"
    }
  ],
  "created_at": "2026-06-01T10:30:00Z"
}

Deposit statuses

Status	Meaning
pending	Deposit initiated, awaiting funds.
completed	Funds received and credited to wallet.
failed	Deposit failed — check the error field.

Payment instructions

When a deposit is created, the response includes payment_instructions — the bank details to send funds to. These vary by currency and provider.