Saltar al contenido
LevaPay

API de NatCash para enviar dinero a billeteras en Haití

Envíe gourdes a billeteras NatCash desde su plataforma, valide el nombre del titular antes de confirmar y reciba la confirmación del depósito, normalmente en el mismo momento.

  • Consulta del titular
  • Acreditación normalmente inmediata
  • La misma API sirve para MonCash

¿Qué es la API de NatCash de LevaPay?

NatCash es la billetera móvil de Natcom, una de las dos grandes operadoras de telefonía de Haití. La API de NatCash de LevaPay permite que su plataforma envíe gourdes (HTG) a cualquier billetera NatCash con solo el número de teléfono del beneficiario.

Su sistema usa una API REST con respuestas JSON: consulta el titular de la billetera, cotiza el envío con el total exacto, confirma la transferencia y recibe el estado final. La mayoría de los envíos a NatCash queda acreditada al instante, así que puede mostrar la confirmación a su cliente sin esperas.

Es ideal para apps de remesas, billeteras digitales, plataformas de pagos P2P y empresas que pagan a agentes, proveedores o colaboradores en Haití y quieren ofrecer NatCash junto a MonCash con una sola integración.

MonCash es una marca de Digicel Haiti y NatCash es una marca de Natcom. LevaPay es un servicio independiente. La API de LevaPay sirve para enviar dinero a billeteras NatCash. No es un producto oficial de Natcom.

API REST para Haití

Cómo enviar dinero a NatCash con la API

  1. 1

    Cree su cuenta y sus claves TEST

    Regístrese gratis y genere un usuario API y una PRIVATE_KEY de prueba. En el sandbox use la billetera de prueba 50940885084.

    Gratis
  2. 2

    Valide el titular

    Con GET /wallets/{wallet}?network=natcash obtiene el nombre del titular para que el remitente confirme que el número es correcto.

    GET /wallets/{wallet}
  3. 3

    Cotice y confirme

    Cotice con POST /transfers/quote (network "natcash") y confirme el quote_id con POST /transfers y una idempotency_key única.

    POST /transfers
  4. 4

    Muestre el resultado

    Normalmente la respuesta ya llega con status completed. Si queda en otro estado, consulte GET /transfers/{id}.

    completed
API de NatCash

Ejemplo: validar el titular y enviar 5.000 HTG a NatCash

Consulta del titular, cotización y envío con la API de NatCash en modo TEST. Para producción cambie /test/v1 por /prod/v1 y use sus claves PROD.

  • Autenticación con las cabeceras X-Api-User y X-Api-Key
  • El campo beneficiary trae el nombre del titular NatCash
  • Billetera de prueba 50940885084 en el sandbox
  • Hasta 60 peticiones por minuto por clave
Ver documentación
# 1) Consultar titular
curl "https://api.levapay.dev/test/v1/wallets/50940885084?network=natcash" \
  -H "X-Api-User: su_usuario_api" \
  -H "X-Api-Key: su_PRIVATE_KEY"

# 2) Cotizar
curl -X POST https://api.levapay.dev/test/v1/transfers/quote \
  -H "Content-Type: application/json" \
  -H "X-Api-User: su_usuario_api" \
  -H "X-Api-Key: su_PRIVATE_KEY" \
  -d '{"network":"natcash","wallet":"50940885084","amount_htg":5000}'

# 3) Enviar
curl -X POST https://api.levapay.dev/test/v1/transfers \
  -H "Content-Type: application/json" \
  -H "X-Api-User: su_usuario_api" \
  -H "X-Api-Key: su_PRIVATE_KEY" \
  -d '{"quote_id":"qt_...","idempotency_key":"orden-10025"}'

Lo que debe saber de los envíos a NatCash

Número de la billetera

Use el número haitiano asociado a NatCash: 8 dígitos, con o sin el prefijo 509 (por ejemplo 40885084 o 50940885084). Los montos son en gourdes, enteros y desde 1 HTG.

Consulta del titular

GET /wallets/{wallet}?network=natcash devuelve el nombre del titular y genera una cotización de verificación de 100 HTG. Confírmela con POST /transfers solo si desea enviar ese monto; si no, deje que venza. La cotización normal de POST /transfers/quote también incluye el campo beneficiary.

Acreditación

Los envíos a NatCash suelen quedar completed en la misma respuesta. Aun así, su integración debe contemplar pending y failed. Si el envío falla, el monto vuelve a su saldo.

Modo TEST

En el sandbox use la billetera de prueba 50940885084: el envío queda completed al instante y se descuenta de su saldo TEST, sin mover dinero real.

Nota para el beneficiario

Con el campo note (máximo 64 caracteres) define el texto que el beneficiario verá en su depósito. Si no lo envía, se usa LEVAPAY.

Por qué usar LevaPay para sus envíos a NatCash

Menos envíos al número equivocado

Muestre el nombre del titular al remitente antes de confirmar el envío.

Confirmación inmediata

La mayoría de los envíos llega con status completed en la misma respuesta.

Total exacto antes de enviar

Monto, comisión y total en la cotización, sin sorpresas para su cliente.

Sin cobros duplicados

La idempotency_key obligatoria evita cobrar dos veces si su sistema reintenta.

NatCash y MonCash juntas

El mismo código sirve para las dos redes: solo cambia el valor de network.

Sandbox con billetera de prueba

Pruebe el flujo completo con claves TEST y sin dinero real.

Precio de la API de NatCash

Paga el 3,5% del monto de cada envío, sin costo de alta, sin mensualidad y sin comisión al fondear. La consulta del titular no tiene costo propio. Por ejemplo, para que el beneficiario reciba 5.000 HTG en NatCash:

Recibe el beneficiario
5,000.00 HTG
Comisión (3,5%)
175.00 HTG
Total debitado de su saldo
5,175.00 HTG

Ver precios y métodos de fondeo

Preguntas frecuentes

¿Es la API oficial de NatCash?

No. LevaPay es un servicio independiente que permite a empresas enviar dinero a billeteras NatCash mediante su propia API. NatCash es una marca de Natcom.

¿Puedo saber a nombre de quién está la billetera?

Sí. Consulte GET /wallets/{wallet}?network=natcash o revise el campo beneficiary de la cotización antes de confirmar el envío.

¿La consulta del titular tiene costo?

No. La consulta genera una cotización de verificación de 100 HTG que solo se cobra si usted la confirma con POST /transfers. Si no la confirma, vence sin costo.

¿Cuánto tarda un envío a NatCash?

Normalmente se acredita al instante y la respuesta de POST /transfers ya llega con status completed.

¿Qué pasa si el envío falla?

Si el envío no se acepta, su saldo no se debita. Si falla después de aceptado, el estado pasa a failed y el monto se devuelve a su saldo.

¿Cómo pruebo sin dinero real?

Cree su cuenta gratis, genere claves TEST y use la billetera 50940885084. Si su saldo TEST es 0, pida saldo TEST a su contacto de LevaPay.

¿Puedo enviar también a MonCash?

Sí. Con la misma integración envía a MonCash cambiando network a "moncash". En MonCash el envío puede quedar en pending unos instantes.

Empiece a enviar a NatCash hoy

Cree su cuenta gratis, pruebe la API de NatCash con la billetera de prueba y pase a producción cuando esté listo.