📚 Inicio

👥 API REST Zonapagos

⚙️ Especificación de Parámetros

💻 Servicio InicioPago

🔍Verificación del Estado del Pago

Información Técnica del Servicio

Estructura JSON que se debe enviar para consumir el servicio POST.

{
	"InformacionPago": {
		"flt_total_con_iva": 83000,
		"flt_valor_iva": 833,
		"str_id_pago": "87rt47sdd78e",
		"str_descripcion_pago": "Compra en línea - Orden #001",
		"str_email": "[email protected]",
		"str_id_cliente": "000001",
		"str_tipo_id": "1",
		"str_nombre_cliente": "Juan",
		"str_apellido_cliente": "Perez",
		"str_telefono_cliente": "3005551234",
		"str_opcional1": "Canal: Web",
		"str_opcional2": "Campaña: Enero",
		"str_opcional3": "Sucursal: Principal",
		"str_opcional4": "Moneda: COP",
		"str_opcional5": "Ambiente: Pruebas"
	},
	"InformacionSeguridad": {
		"int_id_comercio": 12345,
		"str_usuario": "COMERCIO_PRUEBAS",
		"str_clave": "CLAVE_PRUEBAS",
		"int_modalidad": -1
	},
	"AdicionalesPago": [
		{ "int_codigo": 111, "str_valor": "0" },
		{ "int_codigo": 112, "str_valor": "0" }
	],
	"AdicionalesConfiguracion": [
		{ 
			"int_codigo": 50,
			"str_valor": "2701"
		},
		{ 
			"int_codigo": 104,
			"str_valor": "<https://comercio-pruebas.com/respuesta>"
		}
	]
}

Ejemplos de consumo del servicio

A continuación se presentan ejemplos de cómo consumir el servicio InicioPago desde diferentes lenguajes de programación.

Estos ejemplos ilustran la estructura de la solicitud HTTP, el envío del cuerpo en formato JSON y los encabezados requeridos para realizar la consulta del estado de una transacción.

Los ejemplos son únicamente de referencia y deben adaptarse a la arquitectura, librerías y estándares de seguridad del comercio.

Ejemplos de respuesta del servicio

El servicio InicioPago permite al comercio iniciar una transacción de pago en la pasarela Zonapagos.

Mediante este servicio, el comercio envía la información de la transacción, las credenciales de seguridad y los parámetros de configuración necesarios para generar el ciclo de pago.

Como respuesta, Zonapagos retorna una URL (str_url) a la cual el comercio debe redireccionar al usuario pagador para que continúe y finalice el proceso de pago directamente en la pasarela.

Una respuesta exitosa del servicio InicioPago únicamente indica que la transacción fue creada correctamente; no implica que el pago haya sido aprobado. El resultado final del pago debe ser validado posteriormente utilizando el servicio VerificacionPago.

Ejecución Exitosa

{
  "int_codigo": 1,
  "str_cod_error": "",
  "str_descripcion_error": "",
  "str_url": "<https://Zonapagos.com/ciclopago/Pago.aspx?rut=4559372536FA08665D0CA84DBA27D525FE37F968204C7C2367CABD9F082C494A>"
}

Error en la Ejecución

{
  "int_codigo": 2,
  "str_cod_error": "-1",
  "str_descripcion_error": "Error en las validaciones realizadas. Campos obligatorios incompletos.",
  "str_url": ""
}

Respuesta del Servicio InicioPago

Estructura de la Respuesta

PARÁMETRO TIPO DESCRIPCIÓN
int_codigo Numérico Indica el resultado de la ejecución del servicio. 1: Ejecutó correctamente. 2: Ejecutó con error.
str_cod_error Alfanumérico Código de respuesta de la API. -1: Error en las validaciones realizadas. El detalle se entrega en str_detalle. 0: Se encontraron pagos.
str_descripcion_error Alfanumérico Descripción en texto del error presentado durante la ejecución del servicio.
str_url Alfanumérico (URL) URL a la cual se debe redireccionar el usuario pagador para continuar el ciclo de pago en la pasarela de Zonapagos.

Consideraciones Importantes