Saltar al contenido principal

Crear Sesión(es)​

Descripción​

Permite crear una o múltiples sesiones de pago en forma de batch para solicitudes de pago. Cada item del batch contiene los campos de una sesión de pago más campos específicos para el manejo de vencimientos y notificaciones tardías.

Endpoint​

POST 
/api/v1/ext/payment-sessions/request/batch

Autenticación Requerida

Bearer / Token: BearerAuth

Requiere el uso de el token obtenido en /auth/login

Esquema: bearer (JWT)

Request​

Ejemplos de Body (JSON)​

Batch sin Split​

{
  "continue_on_error": true,
  "items": [
    {
      "title": "israeldavidvm",
      "currency_reference": "USD",
      "amount_reference": 100,
      "agreement_id": "agr_5dc73cf74215ae4d",
      "identifier_label": "Nombre Cliente",
      "identifier": "Rafael",
      "payer_identification": "V30523769",
      "description": "Pago Batch 1",
      "due_date_session": "2026-12-31T23:59:59Z",
      "due_date_reached_behavior": "keep_active",
      "late_notice_message": "Pago vencido",
      "internal_reference": "REF-001",
      "success_url": "miapp://pago/exitoso",
      "failure_url": "miapp://pago/fallido",
      "webhook_url": "https://miapi.com/spidi/webhook"
    }
  ]
}

Batch con Split​

{
  "continue_on_error": true,
  "items": [
    {
      "currency_reference": "USD",
      "amount_reference": 40,
      "agreement_id": "stl_session_01",
      "identifier_label": "Nombre del cliente",
      "identifier": "Juan Pérez",
      "description": "Pago de servicio de internet",
      "success_url": "miapp://pago/exitoso",
      "failure_url": "miapp://pago/fallido",
      "webhook_url": "https://miapi.com/spidi/webhook",
      "due_date_session": "2025-10-31T23:59:59Z",
      "due_date_reached_behavior": "keep_active",
      "late_notice_message": "Tu servicio está inactivo. Paga para reactivar.",
      "internal_reference": "INV-2025-10-USER_0001",
      "split": {
        "document": {
          "name": "D001-00045678",
          "type": "Factura",
          "date": "2025-10-20",
          "url": "https://owner.com/document/D001-00045678",
          "observations": "any observation to owner"
        },
        "rules": [
          {
            "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": 20,
            "observations": "any observation to communicate to Partner 2"
          }
        ]
      }
    }
  ]
}

Responses​

Batch procesado exitosamente