RECARGA.DO — PAQUETE DE INTEGRACIÓN
===================================

Generado el 13 de agosto de 2026, desde la documentación publicada en
https://doc.recarga.do — si esta copia y la web difieren, mande la web.

QUÉ HAY AQUÍ
------------
  EMPIECE-AQUI.md     Los caminos según su caso. Empiece por aquí.
  GUIA-INTEGRACION.md Manual completo para su programador.
  API.md              Referencia de endpoints y códigos de error.
  ia.md               Contexto para pegar en ChatGPT, Claude o Copilot.
  openapi.yaml        Especificación OpenAPI 3.0.
  recarga-do.postman_collection.json   Colección lista para importar.

  sdk/                Una librería por lenguaje. Un solo archivo cada una,
                      sin gestor de paquetes: php, node, python, csharp.
  examples/           Ejemplos ejecutables, incluido un punto de venta
                      completo en PHP listo para subir a un hosting.

PARA EMPEZAR AHORA MISMO
------------------------
Las credenciales del ambiente de pruebas vienen ya puestas en los ejemplos.
No cobran nada ni recargan ningún teléfono real.

  cd examples/php && php hola.php

LO ÚNICO QUE HAY QUE ENTENDER ANTES DE VENDER DE VERDAD
------------------------------------------------------
1. La clave de idempotencia se genera UNA vez por venta y se guarda ANTES
   de llamar. Nunca dentro del bucle de reintentos: una clave nueva es una
   venta nueva, y su cliente recibiría dos recargas pagando una.

2. Un HTTP 202 NO es un error. Significa que el resultado aún no se conoce
   y el importe quedó retenido, ni cobrado ni devuelto. Muéstrelo como
   "en verificación" y consulte el estado. Nunca como "fallida".

3. Los paquetes de datos y las facturas no se venden indicando un monto:
   primero se consulta qué tiene disponible ese número o ese contrato, y
   se envía la opción elegida. El precio lo fija el operador.

SOPORTE
-------
Al reportar una incidencia incluya siempre el `request_id` de la respuesta
y, si aplica, el `transaction_id`.
