---
title: "Pedir um depósito (USDT/USDC)"
method: POST
path: "/carteira-usdt/deposits"
tags: ["Carteira USDT"]
---

# Pedir um depósito (USDT/USDC)

`POST /carteira-usdt/deposits`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/carteira-usdt/deposits`
- Auth: API key in header `X-API-Key`

Abre um pedido com VALOR EXATO e prazo de 1 hora (`expires_at`). Mostre ao usuário `amount_to_send`, `network_name` e `address`. O crédito chega sozinho; acompanhe por GET /carteira-usdt/deposits ou pelo webhook `wallet.deposit_credited`. USDC entra 1 para 1 no saldo.

## Request body

- object
  - `amount` string, required: USDT com até 6 casas; mínimo em min_deposit.
  - `network` string: Uma das redes de GET /carteira-usdt (networks[].network).

## Response `201`

Pedido criado.

- DepositoCarteira: Pedido de depósito. O VALOR EXATO que chega identifica o depósito: envie `amount_to_send` na rede indicada antes de `expires_at`.
  - `deposit_id` string
  - `status` 'waiting' | 'confirming' | 'available' | 'expired' | 'under_review' | 'reversed': `waiting` aguardando o envio · `confirming` visto, confirmando · `available` creditado no saldo · `expired` prazo acabou sem depósito · `under_review` em conferência · `reversed` desfeito.
  - `amount_to_send` string: Valor exato a enviar (as casas finais identificam o seu depósito).
  - `amount_received` string, nullable: O que chegou (crédito).
  - `address` string: Endereço de destino na rede escolhida. No teste é fictício (`SANDBOX-NAO-ENVIE-FUNDOS`).
  - `network` string
  - `network_name` string
  - `asset` string
  - `accepted_assets` string[]
  - `expires_at` string, date-time: Prazo do pedido: 1 hora a partir da criação (`created_at` + `deposit_validity_hours`). Envie dentro do prazo.
  - `created_at` string, date-time
  - `credited_at` string, date-time, nullable
  - `origin` 'request' | 'assigned_by_support'
  - `instructions` string: Só na criação: o texto para mostrar ao usuário.
  - `sandbox` boolean

## Other responses

- `400`: `valor_invalido`, `valor_abaixo_do_minimo` (min_usdt), `rede_indisponivel`.
- `401`: Chave ausente ou inválida.
- `403`: `carteira_nao_liberada`: a carteira não está liberada para este projeto.
- `409`: `muitos_pedidos_abertos`.
- `503`: `carteira_indisponivel` / `pagamentos_indisponiveis`: tente de novo em instantes (`acao: esperar`).

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)