Passa al contenuto principale

Obtener métodos de pago registrados

GET 
/payment/payment_method

Devuelve la lista de métodos de pago asociados al transportista en Stripe.

Flujo técnico:

  1. Verifica autenticación del usuario
  2. Obtiene la compañía asociada al usuario
  3. Recupera métodos de pago de Stripe usando toolsStripeCia.getPaymentMethodsList
  4. Verifica qué métodos están en uso (transacciones activas)
  5. Formatea respuesta con información relevante

Información incluida:

  • Detalles de tarjeta (últimos 4 dígitos, marca, fecha expiración)
  • Indicador de método predeterminado
  • Indicador si se puede eliminar (no está en uso en transacciones activas)

Validaciones:

  • Usuario debe estar autenticado (JWT válido)
  • Usuario debe pertenecer a una compañía válida
  • La compañía debe tener cuenta Stripe asociada
  • Solo muestra métodos del cliente Stripe asociado

Ejemplo de respuesta:

[
  {
    "id": "pm_1ABC123XYZ456",
    "billing_details": { "name": "Juan Perez" },
    "card": {
      "country": "ES",
      "display_brand": "visa",
      "exp_month": 12,
      "exp_year": 2025,
      "last4": "4242"
    },
    "is_default": true,
    "can_delete": false
  },
  {
    "id": "pm_1DEF456UVW789",
    "billing_details": { "name": "Juan Perez" },
    "card": {
      "country": "ES",
      "display_brand": "mastercard",
      "exp_month": 6,
      "exp_year": 2024,
      "last4": "5555"
    },
    "is_default": false,
    "can_delete": true
  }
]

Casos de error:

  • 401 Unauthorized:
    • Token JWT inválido
    • Usuario no tiene compañía asociada
    • No hay cuenta Stripe configurada
  • 500 Internal Server Error: Error al conectar con Stripe

Responses​

Lista de métodos de pago