Integrar con IA — Recarga.do API

Cómo se usa

Copie el contexto Pulse el botón de abajo. Son 28 KB de texto: contratos, reglas, errores, ambiente de pruebas, catálogo de los 59 servicios y código funcional en tres lenguajes.

Péguelo en su asistente Al principio de la conversación, antes de pedirle nada.

Pida lo que necesita «Hazme un punto de venta en PHP que venda recargas y paquetes de Claro», «añade el pago de facturas de EDENORTE a mi sistema Laravel».

Ver el archivo llms.txt

Por qué esto existe

Un asistente que solo ve la especificación OpenAPI escribe código que compila y pierde dinero: genera una clave de idempotencia nueva en cada reintento, trata un 202 como error, o intenta comprar un paquete indicando un monto. Este documento le da además las reglas y los errores típicos, con la consecuencia económica de cada uno.

Qué contiene

Sección	Contenido
Instrucciones	Las siete reglas que, si se incumplen, cuestan dinero
Lo esencial	URL, autenticación, credenciales de prueba
Formato	Envoltorio de respuesta, éxito y error
Los tres flujos	Monto libre, paquetes y facturas — la parte que más se equivoca
Endpoints	Los 13, con petición y respuesta reales
Estados y errores	18 códigos con qué hacer ante cada uno
Ambiente de pruebas	Escenarios deterministas por último dígito
Catálogo	Los 59 servicios con su `id`, flujo y rangos
Implementación	Código completo en PHP, Node.js y Python
Errores típicos	10 fallos reales con su consecuencia y su corrección
Comprobación	14 puntos a verificar antes de salir a producción

Revise siempre el código antes de ponerlo a cobrar

Un asistente puede equivocarse aunque tenga buena documentación. Antes de pasar a producción, compruebe los puntos de la sección 12 del documento — sobre todo que la clave de idempotencia se genere una sola vez y se guarde antes de llamar. Pruébelo en el ambiente de pruebas: no cuesta nada y no genera cargos.

Si su herramienta lee URLs

Muchos asistentes pueden leer una dirección directamente. En ese caso basta con:

Lee https://doc.recarga.do/ia.md y ayúdame a integrar
la API de Recarga.do en mi punto de venta.

También publicamos llms.txt en la raíz, el índice que algunas herramientas buscan por convención.

Un ejemplo de petición que funciona bien

[pegar aquí el contenido de ia.md]

Necesito añadir a mi sistema en PHP la venta de paquetes de datos
de Claro y el pago de facturas de EDENORTE.

Ya tengo una tabla `ordenes`. Muéstrame:
1. Cómo guardar la Idempotency-Key antes de llamar
2. La pantalla donde el cajero elige el paquete o la factura
3. El manejo de los cuatro desenlaces, incluido el 202
4. Qué imprimo en el recibo