Saltar al contenido
e-Payouts API
ES EN

Documentación para desarrolladores · API v2

API de e-Payouts

Cobrá con varios métodos de pago usando el paymentbox, la página de pago hospedada por e-Payouts. Tu servidor crea el pago por API, el cliente paga en el paymentbox y vos recibís el resultado por webhook firmado.

Empezar Referencia de la API

URL base https://api.e-payouts.com/v2 JSON · UTF-8 · HTTPS

Crear un pago
POST /v2/payments
Content-Type: application/json
X-Api-Key-Id: 1b0c…
X-Api-Signature: 5d41…

{
  "module": "7c1e4a52-5d0b-4f7e-9a1d-3b8f2c6d9e10",
  "amount": "49.90",
  "currency": "EUR",
  "ucode": "PEDIDO-1042"
}
201 CreatedOK
{"data": {
  "checkout_url": "https://…/pagar?t=Xk3v…",
  "amount": "49.90", "ucode": "PEDIDO-1042"
}}

Empezá por acá

Todo lo que necesitás para integrar

Autenticación Firmá cada llamada con HMAC-SHA256. Ejemplos en PHP, Node.js y Python. Ver guía Paymentbox Llevá al cliente a la página de pago con un enlace o un iframe. Ver guía Webhooks Recibí el resultado de cada pago y verificá la firma. Ver guía Modo prueba Probá tu integración de punta a punta sin mover dinero. Ver guía Errores Qué significa cada código de error y cómo resolverlo. Ver guía Referencia de la API Todos los endpoints con sus parámetros, respuestas y ejemplos. Ver guía
¿Venís de la versión 1? Tu integración v1 sigue funcionando. Mirá cómo pasar a la API v2 paso a paso. Integración v1 →

Cómo funciona

  1. Obtené tus claves — en tu panel de comercio → API: Key ID (público) y secreto (se muestra una sola vez). Nunca pongas el secreto en el navegador ni en una app.
  2. Creá el pago — POST /v2/payments con el módulo, el monto y tu código de pedido (ucode). Firmás la llamada con tu secreto (ver Autenticación).
  3. Redirigí al cliente — a checkout_url. Elige el método y paga en el paymentbox.
  4. Recibí el webhook — en la URL de notificación del módulo, con el estado y tu ucode. Verificá la firma antes de entregar el pedido.
¿Preferís no programar? Usá el enlace o el iframe de "Código de integración" de tu panel de comercio: no requiere API. Parámetros del checkout →

Primer llamado

Probá tus credenciales con GET /v2/ping (ejemplos completos en Autenticación):

HTTP
GET https://api.e-payouts.com/v2/ping
X-Api-Key-Id: 1b0c…
X-Api-Timestamp: 1790380000
X-Api-Nonce: 9f2c4e6a8b0d1f3a5c7e9b1d
X-Api-Signature: 5d41…
Respuesta
{"data":{"object":"ping","merchant":"Mi tienda","uid":1001,"server_time":"2026-09-25T12:00:00Z"}}

Convenciones

Reglas que valen para toda la API

Montos

Como texto con punto decimal y dos decimales: "10.00". Nunca como número flotante.

Fechas

En UTC, ISO 8601: 2026-09-25T12:00:00Z.

Ids

Ids públicos en formato UUID. El módulo también acepta su mid de v1.

Respuestas

{"data": …}. Listas con has_more y next_cursor. Errores: {"error": {"code", "message", "fields", "request_id"}}.

Límites

120 llamadas por minuto por clave y 300 por IP. Cabeceras X-RateLimit-Limit y X-RateLimit-Remaining; al pasarte, 429 con Retry-After.

Seguridad

Todo por HTTPS y firmado en cabeceras. Ningún valor de seguridad viaja en la URL.

¿Listo para empezar a cobrar?

Creá tu cuenta, generá tus claves en el panel y hacé tu primer pago en modo prueba.

Crear cuenta gratis Mis claves de API