Skip to main content

Documentation Index

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

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

Mayo 2026

Documentos: filtros y campos adicionales

GET /documents y GET /documents/{reference} incorporan mejoras para integraciones:
CambioTipoDescripción
is_admitedFiltro + campo en respuestatrue si el documento tiene el tag admitido (p. ej. tras POST /documents/{reference}/acknowledge). Filtrá con ?is_admited=true o ?is_admited=false.
is_canceledFiltro?is_canceled=true devuelve solo facturas canceladas ante el SAT/DIAN; false las excluye.
fiscal_metadataCampoObjeto complementario (null si no aplica). Hoy incluye final_notes (notas UBL cbc:Note del XML fiscal).
purchase_orderCampoReferencia de orden de compra del XML (null si no viene en el documento).
tagsFiltroAcepta IDs o nombres separados por coma (ej. admitido o 1,2).
Abril 2026

Nuevo endpoint: listado de pagos con filtros avanzados

GET /payments ahora acepta los siguientes parámetros opcionales de filtro:
ParámetroTipoDescripción
statusstringFiltra por estado: pending, processed, failed
date_fromstring (ISO 8601)Fecha de inicio del rango
date_tostring (ISO 8601)Fecha de fin del rango
beneficiary_idstringID del beneficiario
Marzo 2026

Webhooks: nuevo evento payment.rescheduled

Se agregó el evento payment.rescheduled al catálogo de webhooks. Se dispara cuando un pago cambia su fecha de vencimiento desde la plataforma.Payload:
{
  "event": "payment.rescheduled",
  "payment_id": "pay_abc123",
  "previous_due_date": "2026-03-10",
  "new_due_date": "2026-03-25"
}

Autenticación: soporte para tokens con scopes

La API ahora acepta tokens con scopes específicos (payments:read, payments:write, beneficiaries:read). Los tokens sin scope siguen funcionando con acceso completo para mantener compatibilidad.