Saltar al contenido principal

Crear Sesión​

Descripción​

Permite crear una sesión de pago a través del botón de pago de SPIDI.Incluye el agreement_id para determinar las reglas de liquidación y split.

Endpoint​

POST 
/api/v1/ext/payment-sessions/buttons

Autenticación Requerida

Bearer / Token: BearerAuth

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

Esquema: bearer (JWT)

Request​

Ejemplos de Body (JSON)​

Sesión sin Split con duración de 5 minutos​

{
  "agreement_id": "2432434",
  "amount_reference": 50,
  "currency_reference": "USD",
  "identifier_label": "Nombre del cliente",
  "identifier": "Juan Pérez",
  "description": "Pago de membresía",
  "success_url": "https://miapp.com/pago-exitoso",
  "failure_url": "https://miapp.com/pago-fallido",
  "webhook_url": "https://miapi.com/spidi/webhook",
  "duration_minutes": 5
}

Sesión con Split​

{
  "currency_reference": "USD",
  "amount_reference": 30,
  "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",
  "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": 20,
        "observations": "any observation to communicate to Partner 2"
      }
    ]
  }
}

Sesión con Priorización de Interfaz (Cripto)​

{
  "agreement_id": "2432434",
  "amount_reference": 50,
  "currency_reference": "USD",
  "identifier_label": "Nombre del cliente",
  "identifier": "Juan Pérez",
  "description": "Pago con preferencia en activos digitales",
  "success_url": "https://miapp.com/pago-exitoso",
  "failure_url": "https://miapp.com/pago-fallido",
  "webhook_url": "https://miapi.com/spidi/webhook",
  "config": [
    {
      "type": "initial_currency",
      "value": "CRYPTO"
    }
  ]
}

Responses​

Sesión de pago creada exitosamente