Skip to main content

Escenario

Tu comercio quiere aceptar débitos PSE por un monto fijo. Sin pagos mixtos, sin fraccionamiento, sin fees adicionales.

Pre-requisitos

Credenciales activas con PSE habilitado.
Código de servicio PSE asignado.
URL de retorno configurada (estática o dinámica).

Request

Nota que flt_valor_iva, str_id_cliente y str_tipo_id son obligatorios para certificación PSE.

Flujo esperado

  1. Usuario llega a tu checkout, click “Pagar con PSE”.
  2. Backend llama POST /InicioPago con el JSON de arriba.
  3. Backend redirige al usuario a str_url.
  4. Usuario elige su banco (Bancolombia, Davivienda, etc.).
  5. Es redirigido al sitio del banco.
  6. Autoriza el débito con sus credenciales bancarias.
  7. Banco confirma a ACH → ACH notifica a ZonaPagos.
  8. ZonaPagos redirige al usuario a la URL de retorno del comercio.
  9. Callback llega → backend llama VerificacionPago → estado final.

Posibles estados finales

Código

Ver también

TC simple

Misma receta para tarjeta de crédito.

Certificación PSE

Antes de ir a producción con PSE.