Saltar al contenido
LevaPay

API de MonCash para enviar dinero a billeteras en Haití

Conecte su app de remesas, pagos o fintech con MonCash mediante una API REST simple: cotice, envíe y siga el estado de cada transferencia hasta que el dinero llegue a la billetera del beneficiario.

  • Sandbox TEST gratis
  • 3,5% por envío, sin mensualidad
  • La misma API sirve para NatCash

¿Qué es la API de MonCash de LevaPay?

MonCash es la billetera móvil más usada en Haití: millones de personas reciben y guardan dinero en su teléfono con ella. La API de MonCash de LevaPay permite que su plataforma envíe gourdes (HTG) a cualquier billetera MonCash usando solo el número de teléfono haitiano del beneficiario.

En lugar de construir y mantener una conexión propia con cada red, su sistema habla con una sola API REST. Usted cotiza el envío, conoce el total exacto que se descontará de su saldo prepago, confirma la transferencia y consulta su estado. LevaPay se encarga de entregar el dinero en la billetera.

Está pensada para empresas que envían dinero a Haití: apps de remesas desde República Dominicana, Estados Unidos u otros países, billeteras digitales, plataformas de pagos P2P y empresas que pagan a colaboradores o proveedores haitianos.

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 (pagos salientes) a billeteras MonCash. No es la API de comercio de Digicel para cobrar pagos en una tienda en línea.

API REST para Haití

Cómo enviar dinero a MonCash con la API

  1. 1

    Cree su cuenta y sus claves TEST

    Regístrese gratis y genere en el panel un usuario API y una PRIVATE_KEY de prueba. El sandbox no mueve dinero real.

    Gratis
  2. 2

    Cotice el envío

    Llame a POST /transfers/quote con network "moncash", el número y el monto en HTG. Recibe la comisión, el total y un quote_id válido unos 120 segundos.

    POST /transfers/quote
  3. 3

    Confirme la transferencia

    Envíe el quote_id a POST /transfers junto con una idempotency_key única. Si su sistema reintenta, nunca se cobra dos veces.

    POST /transfers
  4. 4

    Siga el estado

    MonCash puede responder pending mientras confirma el depósito. Consulte GET /transfers/{id} hasta que el estado sea completed o failed.

    GET /transfers/{id}
API de MonCash

Ejemplo: enviar 5.000 HTG a una billetera MonCash

Cotizar, enviar y consultar el estado con la API de MonCash en modo TEST. Para operar con dinero real cambie /test/v1 por /prod/v1 y use sus claves PROD.

  • Autenticación con las cabeceras X-Api-User y X-Api-Key
  • Respuestas JSON con ok, data y message
  • Consulta del estado hasta completed o failed
  • Hasta 60 peticiones por minuto por clave
Ver documentación
# 1) 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":"moncash","wallet":"50937123456","amount_htg":5000}'

# 2) 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"}'

# 3) Consultar estado (pending → completed)
curl https://api.levapay.dev/test/v1/transfers/tr_... \
  -H "X-Api-User: su_usuario_api" \
  -H "X-Api-Key: su_PRIVATE_KEY"

Lo que debe saber de los envíos a MonCash

Número de la billetera

Use el número de teléfono haitiano asociado a MonCash: 8 dígitos, con o sin el prefijo 509 (por ejemplo 37123456 o 50937123456). Los montos son en gourdes, enteros y desde 1 HTG.

Estados pending, completed y failed

Un envío a MonCash puede quedar unos instantes en pending mientras se confirma el depósito. Su integración debe consultar el estado y mostrar al cliente el resultado final. Si el envío falla, el monto vuelve a su saldo.

Titular de la billetera

La consulta del nombre del titular antes de enviar está disponible para NatCash, no para MonCash. Por eso conviene que su app pida al remitente confirmar el número antes de llamar a la API.

Modo TEST

En el sandbox los envíos a MonCash quedan en pending y el monto se reserva de su saldo TEST. Así puede probar cómo su sistema maneja una transferencia que todavía no termina.

Nota para el beneficiario

Con el campo note (máximo 64 caracteres) define el texto que el beneficiario verá en su depósito, por ejemplo el nombre de su app o el número de pedido.

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

Total exacto antes de enviar

La cotización muestra monto, comisión y total. Su cliente sabe cuánto recibirá el beneficiario.

Sin cobros duplicados

La idempotency_key obligatoria hace que un reintento devuelva la misma transferencia en lugar de crear otra.

Débito solo si se acepta

Su saldo prepago se descuenta únicamente cuando el envío es aceptado.

MonCash y NatCash juntas

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

Sandbox gratis

Claves TEST para desarrollar y probar sin mover dinero real.

Panel para su empresa

Saldo, historial de envíos, fondeo y claves API en un solo lugar.

Precio de la API de MonCash

Paga el 3,5% del monto de cada envío, sin costo de alta, sin mensualidad y sin comisión al fondear. Su saldo prepago en HTG se fondea por transferencia Banreservas, USDT o Binance Pay. Por ejemplo, para que el beneficiario reciba 5.000 HTG en MonCash:

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 MonCash?

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

¿Puedo cobrar pagos con MonCash usando esta API?

No. La API de LevaPay sirve para enviar dinero a billeteras MonCash (pagos salientes). Cobrar a clientes en una tienda en línea corresponde a un botón de pago de comercio, que es un producto diferente.

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

Normalmente se acredita en poco tiempo, aunque puede quedar unos instantes en pending. Consulte GET /transfers/{id} hasta que el estado sea 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.

¿Qué necesito para usar la API en producción?

Desde el panel solicite el acceso a producción y complete la verificación: datos del representante, documento de identidad y una selfie. El modo TEST está disponible desde el registro.

¿En qué lenguajes puedo integrar la API de MonCash?

En cualquiera que haga peticiones HTTPS: PHP, Node.js, Python, Java, Go o C#. La documentación incluye ejemplos en cURL, PHP y Node.js.

¿Puedo enviar también a NatCash?

Sí. Con la misma integración envía a NatCash cambiando network a "natcash", y además puede consultar el titular antes de enviar.

Empiece a enviar a MonCash hoy

Cree su cuenta gratis, pruebe la API de MonCash en modo TEST y pase a producción cuando esté listo.