> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purin.cash/llms.txt
> Use this file to discover all available pages before exploring further.

# Receber em Litecoin

> Mesmo endpoint do PIX, um campo a mais. E três diferenças que mudam o seu fluxo.

Não existe endpoint separado para cripto. Você usa o mesmo `POST /v1/payments` com
`paymentMethod: "ltc"`.

O valor continua indo em `valueCents`, em reais. A conversão para LTC é feita na hora,
pela cotação do momento.

```bash theme={null}
curl -X POST https://api.purin.cash/v1/payments \
  -H "Authorization: Bearer $PURINCASH_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": "ltc",
    "valueCents": 4990,
    "description": "Plano Premium",
    "callbackUrl": "https://minhaloja.com/webhooks/purincash"
  }'
```

```json Resposta theme={null}
{
  "paymentId": "psa_a1b2c3d4e5f6",
  "status": "pending",
  "type": "one_time",
  "paymentMethod": "ltc",
  "amountCents": 4990,
  "currency": "BRL",
  "ltc": {
    "address": "ltc1q...",
    "amount": 0.15068859,
    "amountBrl": 49.9,
    "ltcPriceBrl": 331.2
  },
  "expiresAt": "2026-03-18T12:25:00.000Z"
}
```

## O valor exato importa

> [!WARNING]
>
> Cobre exatamente o `ltc.amount`, com todas as casas decimais. Os últimos satoshis são
> aleatórios de propósito: é assim que a gente sabe qual pagamento chegou quando duas
> cobranças têm o mesmo preço. Valor diferente não é reconhecido automaticamente.

Na prática isso significa que você mostra `ltc.amount` como está, sem arredondar para
exibição. Um `toFixed(4)` na interface é o suficiente para o cliente pagar o valor
errado.

## Três diferenças em relação ao PIX

> [card] Expira em 25 min
>
> PIX expira em 30 minutos, LTC em 25. O `expiresAt` sempre manda.

> [card] 3 confirmações
>
> Não é instantâneo. O webhook sai quando a rede fecha as confirmações.

> [card] Sem sandbox
>
> Com chave `ps_test_` a resposta é `400`. Cotação e endereço vêm da rede real.

## Erros específicos

| Código | Motivo |
| - | - |
| `400` | Chave de sandbox, ou `paymentMethod` fora de `pix` e `ltc` |
| `502` | Cotação de LTC indisponível no momento. Tente de novo em instantes |
| `503` | A loja não tem carteira LTC configurada no painel |

## Consulta e webhook

Iguais aos do PIX. A consulta é `GET /v1/payments/{paymentId}` e o webhook chega em
`callbackUrl` quando as confirmações fecham.

> [!TIP]
>
> Como a confirmação demora, cripto combina bem com entrega assíncrona: confirme o pedido
> na hora com status "aguardando rede" e libere o produto quando o webhook chegar. Prender
> o cliente numa tela de espera por vários minutos derruba conversão.

## E o USDT?

USDT aparece na PurinCash só na saída, como forma de saque, não como forma de receber.
Está em [Saques](https://docs.purin.cash/guias/saques.md#saque-em-usdt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.