Skip to main content
El campo int_id_forma_pago en str_res_pago indica con qué medio el usuario pagó.

Tabla de códigos

CódigoMedioNaturalezaCampos adicionales en str_res_pago
29PSEDébito en líneaticketID, código servicio, código banco, nombre banco, CUS, ciclo
32Tarjeta de CréditoCrédito (Visa/MC/AmEx/Diners)ticketID, 4 últimos dígitos, franquicia, código aprobación, número recibo
41PDF generado en ZonaPagosPresencial con referencia
47SistecréditoCrédito especializadoticketID, código banco
48Bancolombia (botón)Débito directoticketID
51CodensaCrédito CodensaticketID, 4 últimos dígitos, franquicia, código aprobación, número recibo
77MefíaConvenio
Los códigos 42 (GANA) y 45 (Tarjeta Tuya) fueron eliminados en v3.0 (marzo 2024) del API.

Detalle por medio de pago

29 — PSE

Pagos Seguros en Línea: el usuario elige su banco, es redirigido al sitio del banco y autoriza el débito. Campos adicionales (después de los 21 comunes):
CampoTipoDescripción
str_ticketIDstringIdentificador del pago ante el banco.
int_codigo_serviciointCódigo de servicio con el que se inició (tu str_valor del código 50).
int_codigo_bancointCódigo del banco desde donde el usuario pagó.
str_nombre_bancostringNombre del banco (ej. “BANCO UNION COLOMBIANO”).
str_codigo_transaccionstringCUS — Código Único de Seguimiento de PSE. Úsalo para reclamar ante el banco si hay problemas.
int_ciclo_transaccionintCiclo en el cual quedó la transacción. Solo PSE.

32 — Tarjeta de Crédito

Pago con franquicia (Visa, Mastercard, American Express, Diners Club). Campos adicionales:
CampoTipoDescripción
str_ticketIDstringIdentificador del pago ante la franquicia.
int_numero_tarjetaintÚltimos 4 dígitos de la tarjeta (nunca recibes el número completo).
str_franquiciastring"Visa", "Master Card", "American Express", "Diners Club".
int_cod_aprobacionstringCódigo de aprobación emitido por la franquicia. Se usa para conciliación.
int_num_recibidointCódigo de recibo de la transacción.

41 — PDF generado en ZonaPagos

El sistema genera un PDF con referencia de pago que el usuario lleva a puntos físicos (cajas, bancos). Sin campos adicionales.
Este tipo de pago requiere sonda con frecuencia baja (cada 1 hora) porque el usuario puede tardar 1 a 2 días en ir al punto físico a pagar.

47 — Sistecrédito

Crédito de consumo operado por Sistecrédito. Campos adicionales:
CampoTipoDescripción
str_ticketIDstringIdentificador del pago.
int_codigo_bancointCódigo del banco/financiera.

48 — Bancolombia

Botón de pago directo de Bancolombia. Campos adicionales:
CampoTipoDescripción
str_ticketIDstringIdentificador del pago ante Bancolombia.

51 — Codensa

Crédito fácil Codensa. Campos adicionales (idénticos a los de TC 32):
CampoTipoDescripción
str_ticketIDstringIdentificador del pago.
int_numero_tarjetaintÚltimos 4 dígitos.
str_franquiciastringFranquicia.
int_cod_aprobacionstringCódigo de aprobación.
int_num_recibidointCódigo de recibo.

77 — Mefía

Convenio de pago. Sin campos adicionales específicos documentados.

Presencial vs. en línea

TipoCódigosComportamiento de sonda
En línea29, 32, 48, 51Sonda cada 10-15 minutos para estados pendientes.
Presencial41, 47(parcial), 77Sonda cada 1 hora. El usuario necesita desplazarse físicamente. El pago puede tardar 1-2 días.
Cuando identifiques un pago con int_id_forma_pago en [41, 77] y estado pendiente, márcalo en tu BD para que la sonda use la frecuencia horaria en lugar de la cada-10-min.

Habilitación por comercio

No todos los comercios tienen todos los medios habilitados. Al activar tu cuenta, ZonaPagos define cuáles puedes ofrecer. Para habilitar uno nuevo, contacta al equipo comercial. Puedes desactivar temporalmente medios desde AdicionalesConfiguracion:
{ "int_codigo": 103, "str_valor": "1" }  // Desactivar PSE
{ "int_codigo": 107, "str_valor": "1" }  // Desactivar TC

Ver también

Parsear str_res_pago

Cómo extraer estos campos del texto plano.

Campos por medio de pago

Referencia rápida con orden exacto de campos.