Skip to main content
COB crea payloads de pago Pix y sigue el estado de los cobros. Úsalo con el proveedor mock incluido para las pruebas de integración v1.0.0.

​
Crea un BR Code estático

Usa Crear BR Code estático cuando necesites un BR Code reutilizable. El recurso devuelto contiene el payload de pago codificado. Conserva su identificador y usa Obtener BR Code estático o Listar BR Codes estáticos para recuperarlo más adelante. Un BR Code estático no es un registro de liquidación de un cobro. Usa un cobro cuando necesites seguir el ciclo de vida de un cargo.

​
Crea un cobro inmediato

  1. Llama a Crear cobro inmediato con un valor de idempotencia nuevo.
  2. Guarda el identificador del cobro, el payload del BR Code, la ubicación y el vencimiento que devuelve la API.
  3. Léelo mediante Obtener cobro inmediato o Listar cobros inmediatos.
  4. El callback del proveedor mock registra el pago solo cuando su importe coincide con el importe del cobro inmediato. Un callback idéntico es una repetición segura; los datos de pago en conflicto no lo son.
  5. Si el cargo debe terminar sin pago, usa Cancelar cobro inmediato. Cancelar un cobro ya cancelado devuelve el resultado terminal existente.

​
Crea un cobro con fecha de vencimiento

Un cobro con fecha de vencimiento requiere el calendario de vencimientos y los datos del deudor. También puede incluir modificadores de valor, como multa, intereses, bonificación o descuento.
  1. Llama a Crear cobro con fecha de vencimiento. El plugin valida la clave Pix antes de crear el cobro.
  2. Guarda el identificador y el payload de pago. Léelo con Obtener cobro con fecha de vencimiento o encuéntralo mediante Listar cobros con fecha de vencimiento.
  3. Aplica solo el contrato documentado de revisión de vencimiento cuando deba cambiar un modificador de valor permitido. Usa JSON Merge Patch; no envíes un cuerpo de reemplazo completo de forma predeterminada.
  4. Cancela mediante Cancelar cobro con fecha de vencimiento cuando el cobro ya no deba poder pagarse.
El callback del cobro es interno al plugin. Tu cliente de pruebas confirma el pago al leer el recurso público del cobro después del resultado del mock, no al publicar un callback de pago por su cuenta.

​
Evita suposiciones no compatibles

Esta página cubre BR Codes estáticos y cobros. Para los pagos programados, consulta las operaciones de pagos programados en la referencia de la API SPI. No establece una ruta con un proveedor de producción ni integración de mensajería nativa de SPI.