Saltar al contenido principal

Payins cash (anuncio y entrega presencial)

method: "cash" crea un payin anunciado push. CBPay no entrega una cuenta de depósito ni deposit_instructions: el pagador entrega el monto exacto en moneda local al operador y cita la reference de 12 caracteres. El payin queda pending hasta completar maker-checker.

Anunciar el efectivo

Repetir la misma key devuelve 200 con idempotency_hit: true; no abras otro anuncio después de un timeout.

Confirmación y webhooks

El maker org-admin envía POST /v1/payins/{payinID}/confirm-received con bank_reference (folio/recibo) y received_amount. Solo registra evidencia. Un checker god nombrado y distinto envía POST .../confirm-approve sin body. GET /v1/payins/{payinID} y GET /v1/admin/approvals muestran confirm_request y kind: "payin_manual_confirm". El maker o un god puede cancelar con POST .../confirm-cancel; cancelar nunca abona. Al aprobar se aplica tasa viva menos fee y se emite payin_credited.

Errores

Consulta la referencia completa de errores.

Vencimiento y vida de la solicitud

El anuncio cash es un payin push normal: si queda pending 72 horas, el sweep lo cambia a expired y emite payin_expired. Un recibo físico tardío no se abona a ese anuncio; operaciones debe abrir un anuncio nuevo para él (el cash nunca produce filas unassigned automáticas — no hay evento de proveedor que parquear). La solicitud maker no tiene TTL de sistema: su timeout es operativo. Si el payin vence mientras la solicitud está pendiente, el maker puede reclamarla otra vez y el claim atómico reabre expired a pending; luego el checker puede aprobarla. La bandeja conserva visible la solicitud pendiente.

Consulta e historial

Usa el detalle para confirm_request (solo roles org-admin y plataforma — a nivel cuenta el bloque jamás se ve) y el listado con from, to, status, country y method para historial.

Estados

Webhook payin_credited

No. Es entrega física y no hay deposit_instructions.
No. Solo la aprobación separada del checker abona.
Después de 72 horas en pending. La solicitud maker no tiene TTL de sistema y no puede aprobarse cuando vence su payin.

Anuncios push vencidos

Un payin push puede vencer antes de confirmar la evidencia del cliente. Si ya existe una solicitud maker-checker pendiente, el maker puede llamar igualmente a confirm-received: el claim reabre atómicamente expired a pending. Luego el checker aprueba con el flujo normal. La bandeja de aprobaciones mantiene visible la solicitud y el webhook payin_expired puede llegar antes que el posterior payin_credited.
Última modificación el 9 de noviembre de 2026