Saltar al contenido principal

Evento de creación de sesión​

Descripción​

Se produce cuando se crea una nueva sesión de pago. Esta sesión queda disponible para que el pagador realice el pago correspondiente. Se enviará una notificación de este evento mediante un webhook cuando se crea una nueva sesión de pago.

Endpoint​

Webhook

Request​

Ejemplos de Body (JSON)​

Ejemplo de request recibo por el webhook​

{
  "event": "payment_session.created",
  "data": {
    "session_id": "ce075ab5-a4e0-4d16-8281-a27fced565f2",
    "session_origin": "button",
    "status": "pending",
    "identifier_label": "Nombre del cliente",
    "identifier": "Juan Pérez",
    "description": "Pago de servicio de internet",
    "payment_method": "immediate_debit",
    "amount_reference": 5,
    "currency_reference": "VES",
    "success_url": "miapp://pago/exitoso",
    "failure_url": "miapp://pago/fallido",
    "webhook_url": "https://miapi.com/spidi/webhook",
    "split": {
      "document": {
        "document_name": "D001-00045678",
        "document_type": "Factura",
        "document_date": "2025-10-20",
        "document_url": "https://owner.com/document/D001-00045678",
        "document_observations": "any observation to owner"
      },
      "distribution": [
        {
          "split_recipient_agreement_id": "rcv_014…723c1a2",
          "label": "Partner 1",
          "amount_reference": 10,
          "observations": "any observation to communicate to Partner 1"
        },
        {
          "split_recipient_agreement_id": "rcv_016…112dde3",
          "label": "Partner 2",
          "amount_reference": 0,
          "observations": "any observation to communicate to Partner 2"
        }
      ]
    }
  }
}

Responses​

Webhook recibido correctamente por el cliente