Skip to main content

Resumen

HG.Cash opera en varios países. Cada mercado tiene su moneda, rails de pago y rutas de API. Use las guías según el país donde tenga cuentas habilitadas. Los conceptos compartidos—autenticación, cuentas, saldos y webhooks—son los mismos en todos los mercados. Las guías por país cubren cash-in (recibir fondos) y payouts (enviar fondos).

Estado de la cuenta (Brasil, Chile, Bolivia, Colombia, Venezuela)

Las cuentas tienen estado Operativa, Bloqueada o Cerrada. Para los checkouts hospedados (POST /api/v1/checkouts) y las APIs directas de cash-in o payouts en Brasil, Chile, Bolivia y Colombia, y para las APIs directas de cash-in y payouts en Venezuela, solo las cuentas Operativa pueden recibir o enviar fondos. Las cuentas bloqueadas o cerradas devuelven HTTP 403 con code: ACCOUNT_NOT_OPERATIVE. Use GET /api/v1/accounts o GET /api/v1/account/{id}/balance para consultar el estado antes de crear una transacción o checkout. Para una página de pago hospedada unificada en Argentina, Brasil, Chile, Bolivia y Colombia, use Checkout hospedado (POST /api/v1/checkouts).

Dónde operamos

Argentina

ARS — Cuentas bancarias asignadas; cash-in y cash-out por webhook; cash-outs instantáneos por API.

Bolivia

BOB — Cash-in con QR y payouts bancarios ACH.

Brasil

BRL — PIX con QR / copia y cola para cash-in y payouts por clave PIX.

Chile

CLP — Checkout alojado para cash-in y payouts bancarios.

Colombia

COP — Checkout hospedado para cash-in, y payouts bancarios, llave Bre-B o QR Bre-B.

Venezuela

USDT — Cash-in y payouts bancarios. Los montos son cadenas decimales USDT.

Referencia API

Los endpoints por país están en la pestaña Referencia API (Transactions para Argentina; Brazil, Chile y Bolivia para cash-in y payouts directos; Colombia para payouts bancarios, llave Bre-B y QR Bre-B; Venezuela para cash-in y payouts en USDT). El cash-in de Colombia usa checkout hospedado.