Skip to main content
Usa este checklist como una guía rápida antes de pedir validación final de una integración API de Pagos.
Esta guía aplica para integraciones server-to-server con PayIn, Pagos Recurrentes, Devoluciones y Onboarding de Comercios.

​
Panorama general

Preparación

Credenciales, ambientes, módulo de integración y alcance funcional definidos antes de desarrollar.

Construcción técnica

Autenticación, headers, payloads, identificadores únicos y validaciones implementadas.

Validación funcional

Operaciones aprobadas, rechazadas, pendientes y asíncronas probadas en Pre-Producción.

Salida a producción

Evidencias listas, credenciales productivas revisadas y monitoreo mínimo definido.

​
Ruta sugerida

1

Prepara el entorno

Confirma credenciales, Base URL, módulo a implementar y métodos de pago o operaciones habilitadas.
2

Implementa autenticación

Genera y reutiliza el Access Token con el API de Autenticación.
3

Construye tus requests

Envía headers, montos, moneda, identificadores y campos obligatorios con formato válido.
4

Valida operaciones

Ejecuta escenarios aprobados, rechazados, pendientes y errores controlados usando Datos de prueba.
5

Cierra consistencia

Implementa consulta, cancelación o notificaciones Server-to-Server según el flujo que uses.
6

Solicita validación final

Cuando el flujo esté estable, prepara evidencias y coordina la revisión con el equipo de integraciones.

​
Checklist base

1. Preparación

  • Credenciales activas para Pre-Producción.
  • Base URL correcta por ambiente configurada.
  • Módulo a implementar definido: PayIn, recurrentes, devoluciones u onboarding.
  • Métodos de pago u operaciones habilitadas confirmadas para el comercio.
  • Access Token generado y renovado correctamente.
  • Credenciales protegidas fuera del frontend y repositorios públicos.
  • Cumplimiento PCI validado si enviarás datos sensibles de tarjeta en requests POST.
  • Headers obligatorios enviados en todos los requests.
  • Manejo de expiración, reintentos y errores 401 / 403 implementado.
  • Requests enviados en JSON con Content-Type: application/json.
  • Identificadores únicos definidos por operación.
  • Montos enviados en centavos y moneda en formato esperado.
  • Validación de campos obligatorios, longitudes y catálogos completada.
  • Operación aprobada validada de extremo a extremo.
  • Operación rechazada validada con manejo funcional.
  • Operaciones pendientes o asíncronas probadas si están habilitadas.
  • Consulta, cancelación o devolución revisadas si forman parte del flujo.
  • Endpoint S2S accesible y seguro si el flujo usa notificaciones.
  • Estados conciliados entre tu sistema y la API.
  • Idempotencia, duplicados y reintentos contemplados.
  • Logs mínimos disponibles para seguimiento y soporte.
  • Pruebas de Pre-Producción completadas con evidencia.
  • Credenciales productivas revisadas y protegidas.
  • Monitoreo mínimo definido para el go-live.
  • Integración lista para operación real.

​
Puntos por módulo

Autorización

Valida creación de cargos por método de pago y manejo de estados.

Confirmación

Confirma el resultado final con consulta o notificación Server-to-Server.

​
Criterio mínimo de aprobación

Autenticación estable

Token generado, reutilizado y renovado sin exponer credenciales sensibles.

Flujo validado

Al menos un escenario exitoso y uno rechazado o fallido revisados correctamente.

Consistencia final

Estados conciliados entre la API, tu backend y la operación del comercio.

​
Guías relacionadas

Autenticación

Genera el token base de la integración.

PayIn

Revisa el módulo de cobros y autorizaciones.

Datos de prueba

Usa escenarios sandbox para validar tus operaciones.

Referencia PayIn

Consulta estados, códigos y detalles operativos del módulo PayIn.