Pago

Un Pago registra una transacción monetaria para una cuenta. Puede sincronizarse desde Stripe o registrarse manualmente.

Schema

interface Payment {
  id: string; // "pay..." - Identificador único
  account_id: string;
  amount_cents: number;
  currency: string;
  status: "pending" | "succeeded" | "failed" | "canceled" | "refunded";
  paid_at: string | null;
  payment_method: string | null;
  external_id: string | null;
  external_customer_id: string | null;
  external_data: unknown | null;
}

Propiedades

Propiedad	Tipo	Descripción
`id`	`string`	KSUID con prefijo `pay`
`account_id`	`string`	Cuenta propietaria
`amount_cents`	`number`	Monto en centavos
`currency`	`string`	Código ISO 4217
`status`	`enum`	Estado del pago
`paid_at`	`string?`	Momento del pago
`payment_method`	`string?`	Método de pago
`external_id`	`string?`	ID del proveedor
`external_customer_id`	`string?`	ID de cliente externo
`external_data`	`object?`	Snapshot del proveedor

Estados

Estado	Descripción
`pending`	En procesamiento
`succeeded`	Pago completado
`failed`	Pago fallido
`canceled`	Pago cancelado
`refunded`	Devuelto al cliente

Ejemplo

{
  "id": "pay123",
  "account_id": "acc456",
  "amount_cents": 9900,
  "currency": "usd",
  "status": "succeeded",
  "paid_at": "2026-01-15T10:30:00Z",
  "payment_method": "card",
  "external_id": "pi_abc123",
  "external_customer_id": "cus_xyz789"
}

Relacionado

Pagos - Registros de pago
Suscripciones - Gestión de suscripciones