# Tu primera integración con Ryde

De una cuenta de desarrollador a una llamada sandbox funcional, en diez pasos.

> **Note:** PRÓXIMAMENTE — el registro de desarrolladores aún no está abierto. El flujo siguiente es el que se está construyendo, publicado ahora para que veas lo que implicará integrar y plantees lo que no te funcionaría.

1. **Crea una cuenta de desarrollador** — Inicia sesión con la misma identidad Ryde basada en teléfono que usan los clientes. Una cuenta de desarrollador es una cuenta Ryde con acceso de desarrollador, no un inicio de sesión aparte.
2. **Crea o únete a una organización** — Las aplicaciones pertenecen a una organización, nunca a una persona. Es deliberado: la gente cambia de trabajo y las credenciales no deben irse con ella.
3. **Acepta el Acuerdo de Desarrollador** — Se firma una vez por organización, con firma electrónica y versionado. Es distinto de la membresía Ryde One de un cliente y del Acuerdo Comercial de un comercio: tres relaciones diferentes.
4. **Registra una aplicación** — Nombre, logo, sitio web, política de privacidad, URIs de redirección y los alcances que solicitas. Pide los mínimos alcances con los que tu producto funcione.
5. **Recibe credenciales de sandbox** — Se emiten de inmediato. El sandbox nunca despacha un conductor real, nunca cobra una tarjeta real y nunca llega a un comercio real.
6. **Implementa OAuth** — Código de autorización con PKCE. El cliente inicia sesión en Ryde y aprueba tus alcances en una pantalla alojada por Ryde; nunca ves sus credenciales.
7. **Haz tu primera lectura** — Busca comercios o cotiza una tarifa. Las lecturas y cotizaciones no requieren membresía, así que funcionan para todo cliente conectado desde el principio.
8. **Prueba el límite de Ryde One** — Intenta transaccionar como cliente sin membresía y maneja bien el 403 RYDE_ONE_REQUIRED. Es el error de integración más común, y el sandbox permite reproducirlo cuando quieras.
9. **Prueba fallos y cancelaciones** — Sin conductor disponible, un comercio que rechaza un pedido, un cliente que cancela. Un agente que solo maneja el camino feliz no está terminado.
10. **Solicita acceso a producción** — El sandbox es automático; producción se revisa, porque estas APIs mueven vehículos reales, comida real y el dinero de personas reales.