# Recarga.do API

> API REST para vender recargas móviles, paquetes de datos y pago de servicios
> (luz, agua, pospago) en República Dominicana. Modelo prepago: el comercio
> mantiene saldo y cada venta lo descuenta.

Para integrar esta API, lee primero /ia.md: es un documento autocontenido con
contratos, reglas, códigos de error, ambiente de pruebas y código funcional.
No necesitas ningún otro archivo.

Tres reglas que, si se incumplen, causan pérdidas de dinero:
1. La Idempotency-Key se genera UNA vez por operación y se persiste antes de llamar.
2. Un HTTP 202 no es un error: significa resultado desconocido, importe retenido.
3. Paquetes y facturas exigen consultar antes de comprar; su precio no lo fija el comercio.

## Documentación

- [Contexto completo para IA](https://doc.recarga.do/ia.md): todo lo necesario para integrar, en un solo archivo
- [Especificación OpenAPI 3.0](https://doc.recarga.do/openapi.yaml): contrato formal de los endpoints
- [Manual de integración](https://doc.recarga.do/integracion.html): guía para desarrolladores, con consola interactiva
- [Empezar a vender](https://doc.recarga.do/empezar.html): punto de venta listo y librerías de un archivo
- [Colección de Postman](https://doc.recarga.do/recarga-do.postman_collection.json)

## Ambiente de pruebas

Credenciales públicas, sin registro, sin cargos reales:
api_key: rk_sbx_8c4cacb52c6b8f65bf389480ce3f8891
api_secret: sk_sbx_a8e4de1dbd5e135a4be191cfd8901f386e541279a6550b1d30af9fbeaa65bbd0

El último dígito del identificador decide el escenario: 0 no existe, 1 sin opciones,
2 el proveedor no responde, cualquier otro funciona.