---
title: "Deposit via Lightning"
method: POST
path: "/wallets/account/lightning/topup"
---

# Deposit via Lightning

`POST /wallets/account/lightning/topup`

Add funds to a Bitcoin account using the Lightning Network

## Headers

- `api-key` string, required
- `Authorization` string, required

## Request body

- object
  - `userId` string, required — The Id of the user who is sending this transaction
  - `accountId` string, required — The Id of the account to credit
  - `memo` string — An optional memo
  - `amount` string, required — Amount in satoshis
  - `ttl` integer — LN Invoice expiry in minutes (Between 10 and 1440)
  - `proposedRate` string — Used ONLY for Standing Orders -> A rate to honor when converting BTC into EUR. Example: "97175.19"
  - `fillOrKillAtProposedRate` boolean — Used ONLY for Standing Orders -> If this value is true and the provided proposedRate cannot be honored (i.e. outside tolerance threshold), the swap will not be executed.
  - `travelRuleInfo` object — Currently optional fields
    - `vaspInfo` object — Information about the sending/beneficiary VASP
      - `originatorVaspName` string — 1-200 chars, alphanumeric with spaces, hyphens, periods, ampersands, or parentheses
      - `originatorVaspEmail` string — Valid email address
      - `beneficiaryVaspEmail` string — Valid email address
      - `beneficiaryVaspExtraInfo` string — Max 500 chars
      - `beneficiaryVaspName` string — 1-200 chars, alphanumeric with spaces, hyphens, periods, ampersands, or parentheses
    - `originator` object — Information about the true sender of funds
      - `type` 'NATURAL' | 'LEGAL' — NATURAL or LEGAL
      - `name` string — 1-200 chars, letters with spaces, hyphens, apostrophes, periods, or commas
      - `accountNumber` string — 1-100 chars, alphanumeric with hyphens
      - `address` string — 1-500 chars
      - `country` string — 2-letter ISO country code
      - `nationalIdentificatorType` string — 1-50 chars, alphanumeric with spaces or hyphens
      - `nationalIdentificator` string — 1-100 chars, alphanumeric with hyphens
      - `customerNumber` string — 1-100 chars, alphanumeric with hyphens
      - `placeOfBirth` string — 1-200 chars, letters with spaces, hyphens, or commas
      - `amount` string — Numeric string (e.g., 100 or 100.50)
      - `amountCurrency` string — 3-letter ISO 4217 currency code
      - `timestamp` string — ISO 8601 format (e.g., 2026-01-26T12:00:00Z)
      - `dateOfBirth` string — YYYY-MM-DD format
    - `beneficiary` object
      - `type` 'NATURAL' | 'LEGAL' — NATURAL or LEGAL
      - `name` string — 1-200 chars, letters with spaces, hyphens, apostrophes, periods, or commas
      - `accountNumber` string — 1-100 chars, alphanumeric with hyphens
      - `country` string — 2-letter ISO country code
      - `nationalIdentificatorType` string — 1-50 chars, alphanumeric with spaces or hyphens
      - `nationalIdentificator` string — 1-100 chars, alphanumeric with hyphens

## Response `200`

200

- object
  - `id` string
  - `description` string
  - `amount` integer
  - `invoice` string
  - `expiry` integer

---

[API](https://skmtc.net/striga/apis/striga-v1.md) · [All operations](https://skmtc.net/striga/apis/striga-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/striga/striga-v1/versions/63e57aa7df45/schema)