Saltar al contenido principal
POST

Autorizaciones

Authorization
string
header
requerido

Llave de API de AC-PAY del ambiente de esta URL.

Encabezados

Idempotency-Key
string
requerido

Identificador único que generas por operación (p. ej. un UUID), de 1 a 255 caracteres ASCII imprimibles. Si repites la solicitud con la misma llave en las siguientes 24 h recibes la respuesta original (con Idempotent-Replayed: true) sin ejecutarla de nuevo.

Ejemplo:

"5b0f7c1e-2f7a-4d8e-9d3c-7f1e2a9b4c60"

Cuerpo

application/json
url
string<uri>
requerido

URL HTTPS de tu servidor que recibirá los eventos (hasta 2048 caracteres).

Maximum string length: 2048
Ejemplo:

"https://erp.distribuidoracaribe.com.do/webhooks/ecf"

events
enum<string>[]
requerido

Eventos que quieres recibir (al menos uno, sin repetir).

Minimum array length: 1
Opciones disponibles:
ecf.accepted,
ecf.rejected,
ecf.cancelled
Ejemplo:

Respuesta

Webhook creado. Guarda secret: no se vuelve a mostrar.

id
string<uuid>
requerido
Ejemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

url
string<uri>
requerido
Ejemplo:

"https://erp.distribuidoracaribe.com.do/webhooks/ecf"

events
enum<string>[]
requerido

Eventos suscritos.

Opciones disponibles:
ecf.accepted,
ecf.rejected,
ecf.cancelled
Ejemplo:
active
boolean
requerido

Si recibe eventos. Uno inactivo no recibe nada.

Ejemplo:

true

createdAt
string<date-time>
requerido
Ejemplo:

"2026-09-27T14:00:00.000Z"

updatedAt
string<date-time>
requerido
Ejemplo:

"2026-09-27T14:00:00.000Z"

secret
string
requerido

Secreto para verificar la firma X-Acpay-Signature de cada evento. Solo se devuelve en esta respuesta: guárdalo de inmediato en un lugar seguro. Si lo pierdes, borra el webhook y crea otro.

Ejemplo:

"4f9d2c7a1b8e6f3a0d5c9b2e7a1f4d8c3b6a9e2d5f8c1b4a7e0d3c6f9b2a5e8d"