Requisitos para una certificación exitosa en Integraciones E-commerce.

Bienvenido a la guía de requisitos de certificación para integraciones e-commerce con Netpay.

Validaciones en Formulario

Para garantizar un flujo de procesamiento seguro, reducir la tasa de rechazo en transacciones y evitar fricciones en la experiencia del usuario, todos los comercios que integren mediante integraciones como Checkout Custom, Hosted o PLUS deben cumplir con las reglas de validación en su formulario de cobro antes de ser aprobados para producción.

📋 Requisitos de Aceptación


Para obtener la aprobación técnica en el ambiente de Sandbox/Pruebas, el formulario de checkout de tu sitio web o aplicación móvil debe implementar obligatoriamente las siguientes 3 reglas de negocio:

  1. Obligatoriedad de Campos
    Todos los campos requeridos para la creación de la orden/transacción deben contar con validaciones en el front-end que impidan el envío del formulario si existe algún campo vacío.

El botón de pago o envío al Checkout no debe desencadenar ninguna petición a nuestro servicio si falta información obligatoria.

  1. Restricción y Limpieza de Caracteres (Alfanuméricos)
    Para prevenir errores de sintaxis en el motor de pagos de Netpay, se deben implementar máscaras de entrada o expresiones regulares (regex) que restrinjan la captura a únicamente caracteres alfanuméricos ajustados al tipo de dato:

Campos Numéricos: Teléfono, código postal, o montos deben permitir exclusivamente números [0-9].

Campos Texto/Alfanuméricos: Nombre, dirección y referencias deben filtrar y denegar caracteres especiales no válidos (por ejemplo: ! # $ % & * < > ? / ).

  1. Estandarización de Ubicación: Nomenclatura ISO 3166-1 Alfa-2
    Al capturar y enviar la información geográfica en los objetos de dirección (Billing), los campos country y state deben seguir la estructura dividida del estándar ISO 3166-1 Alfa-2.

⚠️ Importante: Debes enviar únicamente el segmento correspondiente del código para cada campo. Nuestro backend se encarga de concatenar y armar el código completo al procesar la transacción.

Regla de Mapeo:
country: Código de 2 letras según el ISO del país (Ejemplo: MX).

state: Código sub-nacional/estatal correspondiente a la provincia o estado (Ejemplo: NLE).

Ejemplo Práctico:
Si la ubicación del cliente corresponde al estándar completo MX-NLE (México el payload JSON enviado a Netpay debe estructurarse de la siguiente manera:

"billing": {
    "firstName": "John ",
    "lastName": "Doe",
    "email": "[email protected]",
    "phone": "4444444444",
    "address": {
        "street1": "Calle 1",
        "street2": "Calle 2",
        "state": "NLE",
        "city": "Escobedo",
        "postalCode": "59066",
        "country": "MX"
    },
    "merchantReferenceCode": "C00063334P5119"
},

Una vez implementadas estas validaciones así como el resto del desarrollo del flujo de pago elegido para integrar puedes agendar una cista con el equipo para empezar el proceso de certificación.