API PagosDirectosMX v2
Integración robusta para comercios en México: cobros, conciliación, webhooks y SDKs listos para producción.
Visión general
La API v2 está diseñada para alta disponibilidad, seguridad y facilidad de integración. Permite crear cargos, administrar pagos recurrentes, recibir notificaciones vía webhook y reconciliar transacciones automáticamente.
- Autenticación con API keys y JWT
- Endpoints REST JSON y soporte para GraphQL (beta)
- Webhooks seguros con firma HMAC
Autenticación y seguridad
API Keys
Genera claves desde el panel. Usa la clave pública para clientes y la privada en servidores.
| Header | Valor |
|---|---|
| Authorization | Bearer sk_live_xxx |
| Content-Type | application/json |
Webhooks
Validación HMAC: firma en header X-PD-Signature
Endpoints principales
Tabla resumida de recursos y ejemplos HTTP.
| Endpoint | Método | Descripción |
|---|---|---|
| /v2/charges | POST | Crear un cargo |
| /v2/charges/{id} | GET | Consultar estado del cargo |
| /v2/refunds | POST | Solicitar reembolso |
| /v2/webhooks | POST | Recepción de eventos |
Ejemplo: crear cargo (cURL)
curl -X POST "https://api.PagosDirectosMX.com/v2/charges" \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"amount":15000,"currency":"MXN","customer":{"email":"[email protected]"},"metadata":{"order_id":"ORD-123"}}'
SDKs y recursos
Ofrecemos SDKs oficiales y ejemplos para Node, PHP y Python.
const PD = require('pagosdirectos-sdk');
const client = new PD({key: process.env.PD_SECRET});
const charge = await client.charges.create({amount:12000,currency:'MXN'});
composer require pagosdirectos/sdk
from pagosdirectos import Client c = Client(api_key='sk_live_xxx')
Guía de integración rápida
Pasos recomendados para llevar a producción:
- Generar y rotar API keys en entorno de desarrollo y producción.
- Probar endpoints en sandbox y validar webhooks con firma.
- Hacer conciliación diaria automática usando /v2/charges y /v2/refunds.
Equipo de Integración
Casos de uso y cliente
E-commerce
Pagos express, conciliación de órdenes y reembolsos.
Suscripciones
Cobros recurrentes y administración de tarjetas.
TPV físico
Integración con puntos de venta y conciliación en tiempo real.
SLAs y soporte
Soporte 24/7 para incidentes críticos y SLA de disponibilidad 99.9% para endpoints principales.
| Plan | Soporte | SLA |
|---|---|---|
| Básico | 99.0% | |
| Pro | Email + Chat | 99.9% |
| Enterprise | Soporte dedicado | 99.99% |
Para integraciones personalizadas Contactar ventas