> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purincash.com/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.purincash.com/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.
</Warning>

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

<CardGroup cols={3}>
  <Card title="Expira em 25 min" icon="clock">
    PIX expira em 30 minutos, LTC em 25. O `expiresAt` sempre manda.
  </Card>

  <Card title="3 confirmações" icon="link">
    Não é instantâneo. O webhook sai quando a rede fecha as confirmações.
  </Card>

  <Card title="Sem sandbox" icon="ban">
    Com chave `ps_test_` a resposta é `400`. Cotação e endereço vêm da rede real.
  </Card>
</CardGroup>

## 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.
</Tip>

## E o USDT?

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