POST{{baseURl}}/autopay/webhook

Notificaciones

baseURL: Es la URL base del aplicativo del cliente/comercio la cual debe ser entregada por el mismo y configurada en el momento del onboarding del comercio con AutoPay.

Debe exponer un endpoint conforme al siguiente contrato. AutoPay enviará notificaciones a dicho endpoint cada vez que un autopago sea eliminado, actualizado, se haya actualizado el medio de pago o desactivado. Ver Descripción de notificaciones para más información.

Solicitud

  • Name
    auth
    Type
    Autenticación
    is Required
    REQUIRED
    Description

    Estructura que contiene la información de autenticación del sitio generada de acuerdo al WSSE UsernameToken Profile 1.1

  • Name
    reference
    Type
    string
    is Required
    REQUIRED
    Description

    Referencia del AutoPago proporcionada por el cliente/comercio.

    Ejemplo:ACC00012345
    Longitud máxima:32
  • Name
    id
    Type
    string
    is Required
    REQUIRED
    Description

    Identificador único del AutoPago

    Ejemplo:2972c13d-6315-4da3-80d7-64c24eb232ad
    Formato:uuid
    Longitud máxima:36
    Longitud mínima:36
  • Name
    type
    Type
    string
    is Required
    REQUIRED
    Description

    Tipo de evento notificado. Ver más en Eventos Webhook.

    Valores permitidos:AUTOPAY_UPDATEDAUTOPAY_FAILEDAUTOPAY_DELETED
  • Name
    date
    Type
    string
    is Required
    REQUIRED
    Description

    Fecha y hora en la que se lanzó por primera vez el evento. En formato ISO 8601.

    Ejemplo:2025-09-29T17:09:29-05:00
    Formato:date-time
  • Name
    data
    Type
    object
    is optional
    CONDITIONAL
    Description

    Objeto que contiene información relevante para identificar el autopago e información del evento.

Solicitud

POST
{{baseURl}}/autopay/webhook
{
    "auth": {
        "login": "aabbccdd1234567890aabbccdd123456",
        "tranKey": "ABC123example456trankey+789abc012def3456ABC=",
        "nonce": "bmVybzNzYms4cmE=",
        "seed": "2024-11-21T11:30:33-05:00"
    },
    "reference": "ACC00012345",
    "id": "2972c13d-6315-4da3-80d7-64c24eb232ad",
    "type": "AUTOPAY_UPDATED",
    "date": "2023-01-19 15:57:23",
}

Respuesta

El webhook fue recibido correctamente.

  • Name
    status
    Type
    Status
    is optional
    Description

    Estructura para definir estados de respuestas


Respuesta

    {
      "status": {
         "status": "OK",
         "reason": "00",
         "message": "Respuesta exitosa",
         "date": "2025-09-29T17:09:29-05:00"
      },
    }