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
200 con idempotency_hit: true; no abras otro anuncio después de un timeout.
Confirmación y webhooks
El maker org-admin envíaPOST /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 payinpush 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
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
¿Cash entrega instrucciones de depósito?
¿Cash entrega instrucciones de depósito?
No. Es entrega física y no hay
deposit_instructions.¿confirm-received abona?
¿confirm-received abona?
No. Solo la aprobación separada del checker abona.
¿Cuándo vence un anuncio cash?
¿Cuándo vence un anuncio cash?
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 payinpush 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.