Skip to main content
GET
Consultar estado de transacción (Colombia)

Autorizaciones

Authorization
string
header
requerido

Token de autenticación de API de usuario con formato cash_<64-char-hex>. Valor de ejemplo cash_16cdc3b6f83c72d9d2680adca4f430962981f6bf32613a129dded0aa060387d2.

Parámetros de ruta

id
string<uuid>
requerido

Respuesta

Estado de la transacción

Estado de una transacción directa (entrante o saliente)

id
string<uuid>
externalID
string
status
enum<string>

Estado normalizado de la transacción.

  • processing: Primer estado de una transacción saliente al crearla. El payout está en curso con el proveedor.
  • pending: Primer estado de una transacción entrante al crearla, hasta que el pagador completa el pago.
  • done: Pago o payout completado.
  • expired: El cobro entrante expiró antes del pago.
  • cancelled: La transacción fue cancelada o el proveedor la rechazó.
Opciones disponibles:
processing,
pending,
done,
expired,
cancelled
direction
enum<string>
Opciones disponibles:
Inbound,
Outbound
amount
string

Monto decimal como string

currency
string
feeBreakdown
object

Desglose de comisión opcional en la respuesta de estado de una transacción directa. Los montos y las tasas son cadenas decimales. Se omite cuando la transacción no tiene desglose. collectedAmount es la comisión porcentual más la comisión fija. platformFee es el costo de billetera registrado y no se suma a collectedAmount. Incluye flatFee.source, que los webhooks de transacción omiten.

providerStatus
string

Presente cuando esta solicitud actualizó un payout en curso. Se omite en caso contrario.