Alta de tu comercio
Al terminar el alta tendrás credenciales de prueba, un return_id registrado y acceso al ambiente de
pruebas para hacer tu primera integración.
El alta no es un formulario en línea: nos escribes, te respondemos con tus credenciales de prueba, y
producción es una segunda conversación después de que tu integración pase el
checklist. Lo hacemos así a propósito — el webhook_secret firma
el aviso con el que marcas una deuda como pagada, y eso no se entrega por un formulario.
Qué entregas a Neat
Sección titulada «Qué entregas a Neat»| Dato | Para qué se usa |
|---|---|
| Razón social y RFC | Identifica legalmente a tu comercio. |
| Uno o más dominios fijos de retorno | Cada uno queda registrado como un return_id; Neat redirige al pagador ahí al terminar el checkout. |
| URL de webhook (HTTPS) | Dirección a la que Neat envía los eventos de pago. Ver Webhooks: eventos y firma. |
| Contacto técnico | A quién avisa Neat ante un incidente o una rotación de credenciales, y a quién le llegan las credenciales. |
Correo para pedir el alta
Sección titulada «Correo para pedir el alta»Cópialo, complétalo y mándalo a tu contacto en Neat o a info@neatpagos.com. Si algún dato todavía no
lo tienes, déjalo escrito como pendiente en vez de borrarlo: así sabemos qué falta.
Asunto: Alta de comercio en Neat México — <razón social>
Razón social:RFC (12 caracteres si es persona moral, 13 si es persona física):Nombre comercial (el que verá quien paga):
Dominios de retorno (uno por línea, HTTPS, sin parámetros): https://Para cada uno, en qué momento del flujo lo usas:
URL de webhook (HTTPS):¿Tu webhook exige IPs en lista blanca? (sí / no)
Contacto técnico (recibe las credenciales) Nombre: Correo: Teléfono para incidentes (con lada internacional, por ejemplo +52 55 1234 5678):
Correo del equipo que va a probar la integración: (a esa dirección le llegan los códigos de acceso del ambiente de pruebas)
Monto típico de un cobro y monto máximo esperado:Volumen mensual estimado de cobros:Qué significa cada cosa
- Dominios de retorno. A dónde mandamos de vuelta a quien paga cuando termina. Cada uno queda
registrado como un
return_idy cada sesión elige uno. Un dominio no registrado hace fallar la creación de la sesión con422 RETURN_NOT_REGISTERED. - URL de webhook. La dirección de tu servidor que recibe los avisos de pago. Tiene que ser HTTPS y estar accesible desde internet. Si está detrás de una lista blanca de IPs, dilo: hoy no publicamos un rango fijo y hay que resolverlo antes.
- Si tu sitio está detrás de Cloudflare u otro WAF. Exime la ruta exacta del webhook de las
reglas que bloquean o desafían tráfico automatizado. Un bloqueo o un desafío le contesta a Neat en
lugar de tu servidor, y cualquier
3xxo4xxdeja la entrega como fallida, sin reintento (ver Reintentos e idempotencia). En Cloudflare, crea una regla personalizada para esa ruta con la acción Skip sobre las protecciones que tengas activas; Bot Fight Mode, el del plan gratuito, no se puede eximir por ruta, así que tendrás que apagarlo o usar Super Bot Fight Mode, que sí admite la regla. - Correo del equipo que prueba. En el ambiente de pruebas, quien paga entra con un código de seis dígitos que enviamos por correo. Usa una dirección de ustedes: así prueban exactamente lo que va a vivir su residente, código incluido.
- Monto típico y máximo. Con eso fijamos tu límite por cobro. Un cobro por encima del límite falla
con
422 VALIDATION_ERROR, así que conviene decirlo ahora y no descubrirlo en producción.
Qué entrega Neat
Sección titulada «Qué entrega Neat»| Dato | Para qué se usa |
|---|---|
provider_id |
Identifica a tu comercio en las respuestas de la API. |
| API key de pruebas y API key de producción | Autentican cada request; ver Autenticación y ambientes. |
webhook_secret |
Firma HMAC de cada notificación; ver Verificar la firma. |
| Acceso al ambiente de pruebas | Para integrar y probar antes de mover dinero real. |
Cómo se entregan las credenciales
Sección titulada «Cómo se entregan las credenciales»La API key y el webhook_secret llegan al correo de tu contacto técnico en un mensaje aparte del
resto del alta, enviado en modo confidencial: caduca a los siete días y no se puede reenviar, copiar
ni descargar. Si el mensaje caducó antes de que lo guardaras, pídenos otro; no se reenvía el mismo.
Son credenciales independientes y se rotan por separado. Guarda ambas en el secret manager de tu infraestructura apenas las recibas; no las incluyas en HTML, JavaScript de navegador, enlaces, tickets ni control de versiones.
Una API key identifica únicamente a tu servidor: la petición de creación de una sesión no permite
elegir otro provider_id ni una cuenta bancaria de destino distinta a la acordada con Neat. La
excepción son los comercios que cobran en nombre de varios condominios: cada sesión nombra al
beneficiario y su CLABE, y Neat deposita a esa cuenta (ver
Beneficiario por sesión).
Rotar una credencial
Sección titulada «Rotar una credencial»La rotación es bajo demanda: la pides cuando lo necesites, no sigue un calendario fijo. Las dos credenciales no rotan igual:
- API key. Neat emite una llave nueva y la anterior sigue funcionando hasta que Neat la revoca, en el momento que acordemos contigo. Así actualizas tu configuración sin una ventana de corte.
webhook_secret. Rota de inmediato, sin período de gracia: desde ese momento cada evento se firma sólo con el secreto nuevo. Coordina el momento con tu contacto en Neat y ten lista la actualización de tu lado, ver Rotación del secreto.
return_id: una o varias páginas de regreso
Sección titulada «return_id: una o varias páginas de regreso»Puedes registrar más de un return_id si tu comercio necesita distintas páginas de regreso para
distintos flujos. Cada sesión de checkout elige uno al crearse. Un return_id que no esté registrado
y activo hace que la creación de la sesión falle con 422 RETURN_NOT_REGISTERED; ver
Sesiones de checkout.
Ambientes
Sección titulada «Ambientes»Pruebas y producción usan credenciales y URLs distintas. No hay un encabezado de ambiente: la API key que uses determina si el cobro es de prueba o real. Las URLs y el detalle están en Autenticación y ambientes.
Cómo pruebas, siendo tú quien paga
Sección titulada «Cómo pruebas, siendo tú quien paga»Para probar la integración tienes que hacer lo mismo que hará tu residente: abrir el
checkout_url, entrar con un código, guardar una tarjeta y pagar.
Entras con el correo de tu equipo, el que nos diste en el alta. El código de seis dígitos llega ahí, igual que le va a llegar a tu residente. No hay un modo especial ni un código fijo: el ambiente de pruebas se recorre igual que el real, y esa es la idea — lo que pruebas es lo que van a vivir.
Si la sesión de prueba trae payer.email, sólo ese correo puede pagarla: el código se envía ahí y
cualquier otra cuenta ve «Este pago es para otra cuenta». Crea tus sesiones de prueba sin
payer.email o con el correo de tu equipo, nunca con el de un ejemplo de esta documentación. Si una
sesión salió con otro correo, no se corrige: crea otra con una Idempotency-Key nueva.
La primera vez que pagas con un correo, antes de guardar la tarjeta el checkout te pide tu nombre y tu
RFC; si entraste con Google, sólo el RFC, porque el nombre ya viene en tu cuenta. Si en pruebas no
tienes un RFC a mano, usa el RFC genérico del SAT, XAXX010101000. Sirve sólo para tus datos como
pagador: en beneficiary.rfc la API lo rechaza con 422 VALIDATION_ERROR, porque ahí va el RFC real
del condominio.
Tarjetas de prueba
Sección titulada «Tarjetas de prueba»Son las del procesador. Funcionan con cualquier CVV y cualquier fecha de vencimiento futura. No uses tarjetas reales aquí.
Al guardar una tarjeta, el checkout la verifica con 3D Secure. En pruebas, el procesador abre una
ventana de un banco de prueba que pide un código: escribe 1234.
| Tarjeta | Qué pasa |
|---|---|
4456528080389860 |
Pide el código 1234, la tarjeta se guarda y el cobro se aprueba. Úsala para pagar. |
5451951574925480 |
La tarjeta se rechaza al guardarla: en pruebas no pasa la verificación 3D Secure. |
4574441215190335 |
La tarjeta se rechaza al guardarla: sirve para probar tu manejo de error. |
4349001210846432 |
La tarjeta se rechaza al guardarla: el procesador responde que no es compatible. |
Con las de rechazo puedes comprobar que, tras un rechazo, la sesión sigue disponible para otro intento y tu integración no marca la obligación como pagada.
Cómo pides producción
Sección titulada «Cómo pides producción»Cuando tu integración pase el checklist, escríbenos con:
- tu
provider_id, - la fecha en que hiciste las pruebas (o el rango de días),
- el correo con el que entraste como pagador.
Con eso revisamos tu tráfico del ambiente de pruebas y confirmamos que cada punto del checklist ocurrió de verdad. No te pedimos capturas ni que nos cuentes lo que hiciste: lo vemos en los cobros, en los webhooks que entregamos y en el archivo de conciliación que descargaste.
Si algo falta, te decimos exactamente qué y lo repites. No es un examen — es que producción mueve dinero de personas y preferimos encontrarlo en pruebas.
Si el alta queda detenida
Sección titulada «Si el alta queda detenida»Escribe a tu contacto técnico en Neat con tu provider_id (si ya lo recibiste) y la razón social
registrada. No incluyas tu API key ni tu webhook_secret en ese mensaje.