Skip to main content
POST
/
webhooks
curl https://api.onepay.la/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Webhook de producción",
    "description": "Notificaciones de pagos y dispersiones",
    "url": "https://mi-servidor.com/webhooks/onepay",
    "events": [
      "payment.approved",
      "payment.rejected",
      "charge.paid",
      "charge.failed",
      "cashout.completed"
    ]
  }'

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Webhook de producción",
    "description": "Notificaciones de pagos y dispersiones",
    "url": "https://mi-servidor.com/webhooks/onepay",
    "events": [
      "payment.approved",
      "payment.rejected",
      "charge.paid",
      "charge.failed",
      "cashout.completed"
    ],
    "secret": "whsec_abcdef1234567890abcdef1234567890",
    "header": null,
    "is_test": false,
    "created_at": "2025-01-20T14:30:00+00:00",
    "updated_at": "2025-01-20T14:30:00+00:00"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.onepay.la/llms.txt

Use this file to discover all available pages before exploring further.

Al crear un webhook recibirás un secret único. Úsalo para verificar la firma de cada notificación entrante.
El secret solo se muestra al momento de creación. Guárdalo de forma segura porque no podrás recuperarlo después.

​
Body

​
name
string
required
Nombre descriptivo del webhook (máx. 255 caracteres).
​
description
string
Descripción opcional del webhook (máx. 500 caracteres).
​
url
string
required
URL HTTPS donde OnePay enviará las notificaciones. Debe ser una URL válida y accesible.
​
events
array
required
Lista de eventos a escuchar. Debe contener al menos un evento. Ver todos los eventos disponibles.Ejemplos de valores válidos: payment.approved, charge.paid, cashout.completed.
curl https://api.onepay.la/v1/webhooks \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Webhook de producción",
    "description": "Notificaciones de pagos y dispersiones",
    "url": "https://mi-servidor.com/webhooks/onepay",
    "events": [
      "payment.approved",
      "payment.rejected",
      "charge.paid",
      "charge.failed",
      "cashout.completed"
    ]
  }'

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Webhook de producción",
    "description": "Notificaciones de pagos y dispersiones",
    "url": "https://mi-servidor.com/webhooks/onepay",
    "events": [
      "payment.approved",
      "payment.rejected",
      "charge.paid",
      "charge.failed",
      "cashout.completed"
    ],
    "secret": "whsec_abcdef1234567890abcdef1234567890",
    "header": null,
    "is_test": false,
    "created_at": "2025-01-20T14:30:00+00:00",
    "updated_at": "2025-01-20T14:30:00+00:00"
  }
}