Skip to main content
PUT
Actualizar cobro
Actualiza un cobro en sitio: cambias monto, título, fecha u otros campos sin cancelar el cobro ni crear uno nuevo. El mensaje al cliente se reenvía solo si envías resend: true.
Pensado para cobros que cambian a diario (por ejemplo, intereses de mora). En lugar de cancelar y recrear el cobro en cada ajuste —lo que reenvía un mensaje cada vez y satura al cliente— actualizas el mismo cobro y decides cuándo notificar.
Solo se modifican los campos que envías; el resto queda intacto. La idempotencia (x-idempotency) no aplica a este endpoint.

Path Parameters

string
required
ID del cobro que quieres actualizar. Crear cobro.

Body

Todos los campos son opcionales.
boolean
default:"false"
Si es true, reenvía la solicitud de pago al cliente (WhatsApp) con los datos actualizados. Si es false o se omite, el cobro se actualiza en silencio y no se consume ningún mensaje.
number
Nuevo monto a cobrar.
number
Nuevo monto de impuestos, en la misma moneda.
string
Breve mensaje que se muestra al cliente al pagar. Mínimo 4 caracteres.
string
Descripción del cobro. Mínimo 4 caracteres.
string
Referencia de pago para el portal de recaudo.
string
Número de teléfono del cliente al que se reenvía la solicitud vía WhatsApp.
string
Correo del cliente para la solicitud de pago.
string
URL de un documento (por ejemplo, la factura actualizada) que se mostrará al cliente. Si lo envías, se usa tal cual; si no, y cambió el monto, título o descripción, OnePay regenera automáticamente su propio documento.
date
Fecha límite de pago, formato YYYY-MM-DD HH:MM:SS.
date
Fecha de expiración del cobro, formato YYYY-MM-DD HH:MM:SS.
Solo se pueden actualizar cobros abiertos (pendientes, en progreso, rechazados, programados o parcialmente pagados). Un cobro ya pagado, cancelado o expirado responde 422 cant_update_payment.Además, si el cobro tiene una transacción en curso en la pasarela, no se puede cambiar el amount ni el tax (responde 422 payment_charge_in_progress); los campos de texto sí se pueden editar.

Ejemplos de uso

Response

Devuelve el cobro actualizado, con la misma estructura que Crear cobro.
string
Identificador único del cobro.
number
Monto del cobro en pesos.
string
Estado del cobro.
string
Título del cobro.
string
Descripción del cobro.
string
Fecha límite de pago (ISO 8601), si aplica.
Enlace de pago del cobro.

Ejemplo de respuesta