Carteira USDT

Pagar um Pix com o saldo USDT

Reserva o USDT, paga o Pix e debita o que custou (a sobra da reserva volta). Assíncrono: responde em reservado; acompanhe por GET /carteira-usdt/payments/{payment_id} ou pelos webhooks wallet.payment_completed / wallet.payment_failed. Envie external_id para repetir com segurança: o mesmo external_id com os mesmos dados devolve o mesmo pagamento (200).

post/carteira-usdt/payments

Request

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

Request body

brl_amountstring

Valor que o recebedor recebe, em reais. Use OU brl_amount (com pix_key) OU br_code.

br_codestring

Pix Copia e Cola (começa com 000201). O valor e o recebedor vêm do código; não envie brl_amount.

funding_source'crypto_usdt'

Opcional; só aceita crypto_usdt.

pix_keystring

Chave Pix de quem recebe (obrigatória com brl_amount).

pix_key_type'cpf' | 'cnpj' | 'email' | 'phone' | 'random'

Recomendado quando a chave tem 11 dígitos (CPF ou telefone).

quote_idstring

Com br_code: o quote_id da cotação (opcional).

external_idstring

Seu identificador idempotente.

Example request

{
  "brl_amount": "50.00"
}

Response

Repetição do mesmo external_id: o pagamento já existente.

payment_idstring
external_idstring nullable
status'reservado' | 'ordem_criada' | 'aceita' | 'sacando' | 'enviado' | 'revisao' | 'concluido' | 'falhou' | 'falhou_apos_envio'

Finais: concluido (Pix pago), falhou (não executado; a reserva voltou ao saldo), falhou_apos_envio (em apuração; a reserva NÃO volta sozinha). revisao: em conferência — não é falha, acompanhe. Os demais são etapas em andamento.

finalboolean

true quando o estado não muda mais.

payment_method'pix_key' | 'br_code'
brl_amountstring
pix_keystring nullable

Mascarada.

usdt_reservedstring
usdt_debitedstring nullable
usdt_orderstring nullable
withdrawal_feestring nullable
cashout_idstring nullable

A ordem que pagou o Pix (GET /cash-outs/{cashout_id} tem o detalhe).

errorstring nullable
pix_e2estring

Só em concluido: o identificador E2E do Pix.

recipient_namestring

Só em concluido: nome de quem recebeu.

recipient_documentstring nullable

Só em concluido: CPF parcial (padrão do Banco Central) ou CNPJ.

receipt_urlstring nullable

Só em concluido: link público do comprovante oficial (null no teste).

created_atstring date-time
updated_atstring date-time
sandboxboolean

Example response

{
  "payment_id": "cu_8a7b6c5d4e3f2a1b0c9d"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.