Cash-in PIX - HG.Cash

Resumen

El cash-in en Brasil crea un cobro PIX en una cuenta BRL. La API devuelve QR y/o copia y cola PIX. La transacción permanece en pending hasta confirmar el pago. La cuenta debe ser BRL y país BR.

Requisitos

Token Bearer con acceso a la cuenta BRL
email del pagador (obligatorio en la API)
document del pagador — CPF o CNPJ (obligatorio en la API)

Flujo

POST /api/v1/br/transactions/inbound — accountId, amount, email y document
Mostrar qrCode o pixCopiaECola al pagador
Opcional: GET /api/v1/br/transactions/{id}/status o webhookUrl — ver Recepción de webhooks

Ejemplo

curl -X POST https://hg.cash/api/v1/br/transactions/inbound \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "YOUR_ACCOUNT_UUID",
    "amount": 250.00,
    "email": "payer@example.com",
    "document": "12345678901"
  }'

La transacción inicia en pending y pasa a done al confirmarse el PIX.

Estado de la cuenta

La cuenta origen debe estar Operativa. Las solicitudes contra cuentas Bloqueada o Cerrada devuelven 403 con code: ACCOUNT_NOT_OPERATIVE.