Docs / Proceso-de-certificacion-de-partners

Proceso de Certificación de Partners

Índice

  1. Descripción General
  2. Flujo Productivo vs Flujo de Certificación
  3. Pre-requisitos
  4. Proceso de Certificación
  5. Casos de Prueba
  6. Checklist de Certificación
  7. Formato de Reporte de Pruebas

Descripción General

Este documento describe el proceso de certificación para partners que implementan el SDK de Hotelpay en sus sistemas. El proceso está diseñado para validar la correcta implementación y funcionamiento del SDK antes de su despliegue en producción.

Flujo Productivo vs Flujo de Certificación

Flujo Productivo

  1. El partner solicita la creación de una cuenta merchant
  2. Hotelpay crea la cuenta y entrega el API key
  3. El partner almacena el API key en su sistema
  4. El merchant/partner configura las credenciales de PSP mediante:
    • Acceso directo al backoffice
    • Solicitud al equipo de operaciones
  5. El sistema comienza a procesar pagos en producción

Flujo de Certificación

  1. El partner, habiendo completado la integración inicial, solicita iniciar la certificación
  2. El equipo de onboarding técnico proporciona:
    • API key de prueba para ambiente testing
    • Tarjetas de prueba (autorizada y declinada)
    • Token de webhook para validación
  3. El partner realiza las pruebas requeridas
  4. El equipo de Hotelpay valida los resultados

Pre-requisitos

  • Integración del SDK completada en ambiente de desarrollo
  • API key de integración inicial recibida y configurada
  • Documentación técnica revisada
  • Endpoint de webhook público implementado

Proceso de Certificación

  1. Inicio del Proceso

    • El partner contacta al equipo de onboarding técnico vía email solicitando iniciar la certificación
    • Se agenda una reunión inicial (Google Meet) para revisión de pre-requisitos
  2. Configuración del Ambiente de Pruebas

    • Hotelpay proporciona credenciales de prueba:
      • API key para ambiente testing
      • Webhook token key
      • Tarjetas de prueba
    • El partner configura estas credenciales en su ambiente de pruebas
  3. Ejecución de Pruebas

    • El partner ejecuta los casos de prueba definidos
    • Documenta los resultados según el formato establecido
    • Registra los IDs de las órdenes procesadas
  4. Validación de Resultados

    • El partner envía el reporte de pruebas
    • El equipo de Hotelpay verifica las transacciones en el sistema
    • Se valida la correcta recepción y procesamiento de webhooks
  5. Certificación

    • Revisión del checklist de certificación
    • Confirmación de cumplimiento de todos los criterios
    • Aprobación formal de la certificación

Casos de Prueba

Caso 1: Pago Exitoso con 3DS

  • Objetivo: Validar el flujo completo de pago exitoso incluyendo autenticación 3DS
  • Tarjeta: Se proporcionará una tarjeta de prueba enrolada en 3DS
  • Resultado Esperado:
    • Transacción aprobada
    • Webhook de confirmación recibido y validado
    • Orden actualizada correctamente en el sistema

Caso 2: Pago Declinado

  • Objetivo: Validar el manejo correcto de pagos rechazados
  • Tarjeta: Se proporcionará una tarjeta de prueba configurada para declinar
  • Resultado Esperado:
    • Transacción declinada
    • Webhook de rechazo recibido y validado
    • Orden actualizada con estado de error

Checklist de Certificación

  • Configuración Inicial

    • API key de prueba configurado correctamente
    • Endpoint de webhook configurado y accesible públicamente
    • Token de webhook implementado en la validación
  • Prueba de Pago Exitoso

    • Flujo de pago completado correctamente
    • Autenticación 3DS procesada exitosamente
    • Webhook de confirmación recibido y validado
    • ID de orden registrado: _____________
  • Prueba de Pago Declinado

    • Flujo de pago procesado correctamente
    • Mensaje de error mostrado apropiadamente
    • Webhook de rechazo recibido y validado
    • ID de orden registrado: _____________
  • Validación de Webhooks

    • Headers de autenticación implementados correctamente
    • Procesamiento de payload según documentación
    • Respuesta correcta al webhook (200 OK)

Formato de Reporte de Pruebas

# Reporte de Pruebas de Certificación

## Información General
- Partner: [Nombre del Partner]
- Fecha de Pruebas: [YYYY-MM-DD]
- Ambiente: Testing
- Versión del SDK: [X.Y.Z]

## Caso 1: Pago Exitoso con 3DS
- ID de Orden: [ORDER_ID]
- Respuesta del Sistema: [Detalle de la respuesta]
- ID de Webhook Recibido: [WEBHOOK_ID]
- Resultado: [EXITOSO/FALLIDO]
- Observaciones: [Si aplica]

## Caso 2: Pago Declinado
- ID de Orden: [ORDER_ID]
- Respuesta del Sistema: [Detalle de la respuesta]
- ID de Webhook Recibido: [WEBHOOK_ID]
- Resultado: [EXITOSO/FALLIDO]
- Observaciones: [Si aplica]

## Evidencias
[Screenshots o logs relevantes]

## Notas Adicionales
[Cualquier información relevante adicional]

Nota: Este proceso está diseñado para asegurar una implementación correcta y robusta del SDK de Hotelpay. El equipo de onboarding técnico estará disponible para soporte durante todo el proceso de certificación a través de los canales establecidos (email, Google Meet, Slack).