Ir al contenido
Maple

    Primeros pasos

    Developer API

    Conecte su POS o plataforma con Maple: reciba y decida pedidos, publique menús y suscríbase a webhooks firmados.

    La Developer API de Maple conecta su POS o plataforma con los locales de Maple aprobados. Reciba y decida pedidos, publique menús o administre reservas usando los alcances (scopes) y las capacidades de local aprobados para su integración.

    No hay ningún SDK que instalar. En las integraciones de pedidos, Maple se encarga del procesamiento de los pagos de los clientes y entrega los pedidos con los totales ya calculados. Use la consola de desarrolladores para administrar sus claves, webhooks y diagnósticos.

    Inicio rápido

    Inicie sesión, cree su propia clave y encuentre su primera solicitud a la API y una entrega de prueba firmada.

    Cómo funciona Maple

    El modelo conceptual: apps, locales, conexiones y quién es responsable de qué.

    Comience con la tarea que está realizando

    Reciba y decida pedidos

    Reciba webhooks order.notification y gestione cada pedido con las llamadas accept, deny, ready y complete.

    Publique un menú

    Envíe el menú completo de un local como un solo documento JSON identificado con sus propios IDs estables, y léalo de vuelta.

    Maneje webhooks

    Verifique firmas HMAC, deduplique entregas y repita eventos desde el registro de eventos.

    Explore todos los endpoints

    Esquemas de solicitud y respuesta para locales, conexiones, menú, zonas de entrega, pedidos, webhooks, reservas, lista de espera y comentarios (feedback).

    Lo que nunca tendrá que construir

    Las integraciones con restaurantes suelen ser dolorosas porque heredan problemas que no son suyos. Con Maple, usted no tiene que lidiar con esto:

    • Sin integración de pagos. Maple crea y administra el enlace de pago. Usted nunca toca una tarjeta ni asume el alcance de PCI.
    • Sin motor de precios. Maple calcula cada total que ve el cliente. Usted lee centavos enteros.
    • Sin sondeo. Los pedidos se envían a su webhook; un registro y endpoints de repetición cubren la recuperación.
    • Sin SDK obligatorio. Es una API REST que puede llamar desde cualquier lenguaje.
    • Sin adivinar en producción. Primero desarrolla con datos de prueba aislados; el acceso en vivo se habilita una vez que su integración es aprobada.

    La forma de la API

    Cada solicitud autenticada lleva una credencial Bearer. Desarrolle en el sandbox preparado y luego obtenga una aprobación de producción por separado y configure la app, los accesos, la clave y los endpoints de producción. Vea Entornos:

    Terminal window
    # Sandbox — build and test here
    curl https://api.staging.maple.inc/v1/me \
      -H "Authorization: Bearer mpk_test_..."
    • Dos entornos: el sandbox en https://api.staging.maple.inc/v1 para desarrollo, y producción en https://api.maple.inc/v1. Están totalmente aislados. Vea Entornos.
    • Autenticación con clave de API: envíe su clave (mpk_test_… / mpk_live_…) como token Bearer. Vea Autenticación.
    • Acceso por alcances: su app solo tiene los permisos que necesita (orders:read, menus:write, webhooks:write, etc.).
    • Recursos predecibles: IDs opacos, dinero en centavos de USD enteros, sobres de eventos al estilo de Stripe y cuerpos de error consistentes.