Skip to main content
POST
Genera un link PSE (pagosseguros.com.co) que un tercero usa para pagarte. Cuando el pagador completa el flujo, Mouv:
  1. Confirma con el proveedor PSE
  2. Acredita el monto neto (gross - fee - IVA) a tu wallet ACH
  3. El status del deposit pasa a PAID
Scope requerido: WRITE

Body

number
required
Monto que el pagador debe pagar (centavos). Mínimo 100.
number
required
1 = CC, 4 = CE, 5 = Pasaporte, 8 = NIT.
string
required
5-15 dígitos.
string
required
Nombres del pagador.
string
required
Apellidos del pagador.
string
required
Email válido — se usa para enviar el link si llamás /share-email.
string
Opcional. Celular Colombia 10 dígitos.
string
Opcional. Tu identificador interno (ej. factura-001). Aparece en el listado y receipt.

Response 201

string
UUID del deposit (dep_...)
string
PENDING_CONFIRM al inicio
number
Lo que cotizaste
string
"COP"
string
Compartilo con el pagador. El link expira en 24h.
string
ISO 8601 — cuándo expira el link si no se paga
string
Tu reference (si lo proveíste)
string
ISO 8601

Ejemplos

Lifecycle del deposit

Webhooks (próximamente)

Cuando habilitemos webhooks salientes, recibirás un POST a tu URL configurada con evento deposit.paid cuando el pago confirme — sin tener que pollear.

Tip — flujo recomendado

  1. Cliente cobra a un cliente final (factura emitida en tu sistema)
  2. Tu sistema llama POST /deposits/pse con los datos del pagador + tu internalRef
  3. Mostrás el paygatewayUrl al pagador (o llamás /share-email para enviarlo)
  4. Pagador completa PSE en su banco
  5. Tu sistema pollea GET /deposits?status=PAID cada N min (o espera webhook) y matchea por internalRef
  6. Marca factura como pagada en tu sistema