Listar pagos de un viaje

GET

/teams/{teamId}/trips/{tripId}/payments

curl --request GET \
  --url https://api.dev.lade.com.mx/teams/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/trips/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/payments \
  --header 'Authorization: Bearer <token>'

• Development environment (dominio custom)
• QA environment
• Production environment
• Development environment (legacy — execute-api URL directo)

Lista los abonos registrados contra un viaje junto con su paymentStatus derivado (monto adeudado, pagado, saldo, estado SIN_COBRAR/PARCIAL/PAGADO/ATRASADO y fecha límite de pago según los términos de pago del cliente).

Authorizations

• cognitoAuth

Parameters

Path Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

tripId

required

string format: uuid

ID del viaje (UUID)

Responses

200

Pagos del viaje + estado de cobro derivado

Media typeapplication/json

object

payments

Array<object>

Abono/pago registrado contra el saldo de un viaje (no confundir con el CFDI de Invoice)

object

id

string format: uuid

paymentId

string format: uuid

teamId

string format: uuid

tripId

string format: uuid

clientId

string

nullable

clientName

string

amount

number

> 0

paidAt

string format: date-time

method

Forma en que se cobró el pago

string

Allowed values: EFECTIVO TRANSFERENCIA CHEQUE TARJETA OTRO

reference

string

notes

string

registeredBy

string format: uuid

nullable

createdAt

string format: date-time

updatedAt

string format: date-time

paymentStatus

Estado de cobro derivado del viaje — nunca se guarda, se calcula a partir de revenue, pagos y términos de pago del cliente

object

amountDue

number

amountPaid

number

balance

number

status

string

Allowed values: SIN_COBRAR PARCIAL PAGADO ATRASADO

dueDate

string format: date-time

nullable

Example

{
  "payments": [
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440005",
      "amount": 5000,
      "paidAt": "2026-07-26T10:00:00Z",
      "method": "TRANSFERENCIA"
    }
  ],
  "paymentStatus": {
    "amountDue": 10000,
    "amountPaid": 5000,
    "balance": 5000,
    "status": "PARCIAL",
    "dueDate": "2026-08-10T00:00:00Z"
  }
}

403

Sin permisos

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

Media typeapplication/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}