DeonPay · Developers · API v1

Changelog

La API v1 solo agrega: ningún cambio de esta lista rompe una integración existente.

  1. Mejora

    Spec OpenAPI 3.1 válido y colección de Postman

    /api/v1/openapi.json valida como OpenAPI 3.1: los campos que pueden venir vacíos usan type: [..., "null"], el server incluye /api, los endpoints públicos de payment intents declaran que no llevan token y hay una sección webhooks con cada evento. Nueva colección de Postman en /api/v1/postman.json, generada del mismo spec.

  2. Nuevo

    Portal en docs.deonpay.mx

    Guías, referencia con "Probar en sandbox" y changelog sin login en docs.deonpay.mx. Las direcciones /docs anteriores redirigen ahí.

  3. Nuevo

    Sandbox gratis y tokens con ambiente en el nombre

    La API y los webhooks son gratis en sandbox en cualquier plan, aunque el comercio ya cobre en producción. Los tokens nuevos empiezan con dp_test_ (sandbox) o dp_live_ (producción); los dp_ anteriores siguen funcionando.

  4. Nuevo

    Sucursales

    Nuevo GET /v1/branches y parámetro branch_id (uuid o none) en los GET de ventas y dinero: transacciones, movimientos de saldo, retenciones, métricas, reportes y POS. Cada transacción trae su branch_id. Tool MCP list_branches.

  5. Corrección

    POS por ambiente

    GET /v1/pos/intents y GET /v1/pos/shifts devuelven solo lo del ambiente del token; antes mezclaban sandbox y producción.

  6. Nuevo

    Payment Intents: OXXO, SPEI y webhooks

    Los payment intents aceptan OXXO y SPEI además de tarjeta, emiten webhooks payment_intent.* (usa payment_intent.succeeded para entregar el pedido) y permiten hasta 3 intentos de tarjeta con el mismo client_secret (max_card_attempts).

  7. Mejora

    Facturas por ambiente

    /v1/invoices lista solo las facturas del ambiente del token y cada factura trae environment.

  8. Nuevo

    Impresión remota (Print Jobs)

    /v1/pos/print-jobs y /v1/pos/print-assets mandan tickets a imprimir en una terminal desde tu sistema.

  9. Nuevo

    Reportes, webhooks por API y sincronización para CRM

    Nuevos /v1/reports/summary, /v1/reports/daily-close y /v1/reports/sellers; alta, edición y rotación de secreto de webhooks con /v1/webhook_endpoints; sincronización incremental de transacciones con updated_since, order=updated_at y cursor starting_after.

  10. Nuevo

    Payment Intents, deonpay.js y libro de movimientos

    Cobro sin link ni sesión previa con /v1/payment_intents y confirmación desde el navegador con deonpay.js. Nuevo /v1/balance_transactions. Idempotencia en las altas con el header Idempotency-Key. La especificación OpenAPI 3.1 se sirve en /api/v1/openapi.json.

  11. Nuevo

    Pre-autorizaciones

    Retenciones con capture_method=manual y /v1/authorizations con capture, increment y void.

  12. Mejora

    Desglose de montos en transacciones

    Las transacciones traen el desglose con reembolsos, la propina y si la tarjeta estuvo presente.

  13. Nuevo

    Catálogo para agentes de IA

    /v1/catalog/feed publica el catálogo en formato Agentic Commerce Protocol.

  14. Nuevo

    Facturas CFDI

    /v1/invoices para timbrar, cancelar y descargar PDF y XML de facturas CFDI 4.0.

  15. Nuevo

    Métricas y reglas de pago

    Nuevos /v1/merchant/metrics/series (serie diaria para gráficas) y /v1/merchant/payment-rules.