DeonPay · Developers · API v1
Changelog
La API v1 solo agrega: ningún cambio de esta lista rompe una integración existente.
Mejora
Spec OpenAPI 3.1 válido y colección de Postman
/api/v1/openapi.jsonvalida como OpenAPI 3.1: los campos que pueden venir vacíos usantype: [..., "null"], el server incluye/api, los endpoints públicos de payment intents declaran que no llevan token y hay una secciónwebhookscon cada evento. Nueva colección de Postman en/api/v1/postman.json, generada del mismo spec.Nuevo
Portal en docs.deonpay.mx
Guías, referencia con "Probar en sandbox" y changelog sin login en
docs.deonpay.mx. Las direcciones/docsanteriores redirigen ahí.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) odp_live_(producción); losdp_anteriores siguen funcionando.Nuevo
Sucursales
Nuevo
GET /v1/branchesy parámetrobranch_id(uuid onone) en los GET de ventas y dinero: transacciones, movimientos de saldo, retenciones, métricas, reportes y POS. Cada transacción trae subranch_id. Tool MCPlist_branches.Corrección
POS por ambiente
GET /v1/pos/intentsyGET /v1/pos/shiftsdevuelven solo lo del ambiente del token; antes mezclaban sandbox y producción.Nuevo
Payment Intents: OXXO, SPEI y webhooks
Los payment intents aceptan OXXO y SPEI además de tarjeta, emiten webhooks
payment_intent.*(usapayment_intent.succeededpara entregar el pedido) y permiten hasta 3 intentos de tarjeta con el mismoclient_secret(max_card_attempts).Mejora
Facturas por ambiente
/v1/invoiceslista solo las facturas del ambiente del token y cada factura traeenvironment.Nuevo
Impresión remota (Print Jobs)
/v1/pos/print-jobsy/v1/pos/print-assetsmandan tickets a imprimir en una terminal desde tu sistema.Nuevo
Reportes, webhooks por API y sincronización para CRM
Nuevos
/v1/reports/summary,/v1/reports/daily-closey/v1/reports/sellers; alta, edición y rotación de secreto de webhooks con/v1/webhook_endpoints; sincronización incremental de transacciones conupdated_since,order=updated_aty cursorstarting_after.Nuevo
Payment Intents, deonpay.js y libro de movimientos
Cobro sin link ni sesión previa con
/v1/payment_intentsy confirmación desde el navegador con deonpay.js. Nuevo/v1/balance_transactions. Idempotencia en las altas con el headerIdempotency-Key. La especificación OpenAPI 3.1 se sirve en/api/v1/openapi.json.Nuevo
Pre-autorizaciones
Retenciones con
capture_method=manualy/v1/authorizationscon capture, increment y void.Mejora
Desglose de montos en transacciones
Las transacciones traen el desglose con reembolsos, la propina y si la tarjeta estuvo presente.
Nuevo
Catálogo para agentes de IA
/v1/catalog/feedpublica el catálogo en formato Agentic Commerce Protocol.Nuevo
Facturas CFDI
/v1/invoicespara timbrar, cancelar y descargar PDF y XML de facturas CFDI 4.0.Nuevo
Métricas y reglas de pago
Nuevos
/v1/merchant/metrics/series(serie diaria para gráficas) y/v1/merchant/payment-rules.
