POST /payments/deposits/crypto#
Cria uma invoice de depósito em criptomoeda. Retorna a URL da invoice, endereço de carteira e QR code para que o usuário envie o pagamento.
Autenticação#
| Tipo | Header | Valor |
|---|
| API Key | x-api-key | <sua_api_key> |
Request#
Method: POST
URL: /payments/deposits/crypto| Header | Tipo | Obrigatório | Descrição |
|---|
x-api-key | string | Sim | Chave de API do usuário |
Content-Type | string | Sim | application/json |
Body (JSON)#
| Campo | Tipo | Obrigatório | Descrição |
|---|
amount | number | Sim | Valor em BRL a ser depositado (ex: 100.00) |
currency | string | Não | Código da moeda. Se omitido, usa o configurado na conta do usuário |
Exemplo de Request#
cURL#
Responses#
{
"success": true,
"message": "Invoice de depósito crypto criada com sucesso",
"data": {
"transaction_id": "clx5678efgh",
"invoice_url": "https://pay.lumopayment.com/invoice/abc123",
"wallet_hash": "TRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"qr_code": "TRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"memo": null,
"currency": "USDT_TRX",
"amount_brl": 200.00,
"amount_fees": 6.00,
"net_amount": 194.00,
"status": "pending"
}
}
| Campo | Tipo | Descrição |
|---|
transaction_id | string | ID interno da transação no sistema |
invoice_url | string | URL da página de pagamento (redirecionar o usuário aqui) |
wallet_hash | string / null | Endereço da carteira para envio direto (exibir QR ou copiar) |
qr_code | string / null | Dado para gerar o QR code (geralmente igual ao wallet_hash) |
memo | string / null | Memo/Tag de destino (necessário em algumas redes como XRP, XLM, TON) |
currency | string | Código da moeda da invoice |
amount_brl | number | Valor solicitado em BRL |
amount_fees | number | Total de taxas em BRL |
net_amount | number | Valor líquido que será creditado ao usuário após confirmação |
status | string | Status inicial da transação (pending) |
400 Bad Request#
{
"success": false,
"message": "Valor abaixo do mínimo permitido"
}
| Mensagem | Causa |
|---|
"Valor inválido" | amount ausente ou não numérico |
"Valor abaixo do mínimo permitido" | amount < minimal_value_in_crypto |
"Valor acima do máximo permitido" | amount > maximal_value_in_crypto |
"Valor abaixo do mínimo aceito pela rede " | Equivalente crypto < mínimo exigido pela |
"Nenhuma moeda configurada para este usuário" | Sem moeda ativa configurada para o usuário |
"Não foi possível obter cotação" | Erro ao buscar cotação |
"Não foi possível criar invoice" | Erro na criação da invoice de pagamento |
401 Unauthorized#
{
"success": false,
"message": "API key inválida ou não encontrada"
}
500 Internal Server Error#
{
"success": false,
"message": "Erro ao processar depósito crypto",
"error": "detalhes do erro"
}
Moeda#
A moeda aceita para depósito é definida pela configuração da sua conta. Se o campo currency não for enviado no body, a moeda configurada será usada automaticamente.Para saber qual moeda está configurada na sua conta, entre em contato com o suporte.
Confirmação Automática#
Quando o pagamento é confirmado na blockchain, o sistema atualiza o status da transação automaticamente para completed e credita o saldo do usuário. Nenhuma ação adicional é necessária na sua integração.Modificado em 2026-06-14 07:39:12
