Skip to main content
GET
/
payment-requests
Listar cobros
curl --request GET \
  --url https://api.tupana.ai/v1/payment-requests/ \
  --header 'Authorization: <api-key>'
{
  "results": [
    {
      "payment_request_id": 1042,
      "status": "issued",
      "payment_url": "https://www.tupana.ai/pagos/tok_xyz",
      "expires_at": "2026-04-06T12:30:00Z",
      "created_at": "2026-04-06T12:00:00Z",
      "amount": 50000,
      "target_dte_type": "39",
      "auto_issue": true,
      "external_id": "booking_abc123",
      "metadata": {},
      "issued_document_id": 9871,
      "document_ids": []
    }
  ]
}

​
¿Para qué se usa?

Obtiene todas las sesiones de cobro creadas por tu integración, ordenadas por fecha de creación descendente.

​
Qué hace

  • Retorna todas las sesiones de cobro del cliente API autenticado.
  • Soporta filtro por status.
  • Incluye los mismos campos que el endpoint de detalle.

​
Ejemplos de uso

  • Cobros pendientes: Filtrar por ?status=pending para hacer seguimiento de sesiones sin pagar.
  • Cobros pagados: Filtrar por ?status=paid para procesar liquidaciones.
  • Historial completo: Sin filtros para obtener todas las sesiones.

Authorizations

​
Authorization
string
header
required

API Key para autenticación. Formato: Api-Key YOUR-API-KEY

Query Parameters

​
status
enum<string>

Filtrar por estado de la sesión.

Available options:
pending,
paid,
issued,
failed,
expired,
refunded

Response

Lista de cobros obtenida exitosamente

​
results
object[]