Introducción

NetPay Link es la forma más sencilla de vender a distancia, es un nuevo método de pago que te permite mandarle a tus clientes una liga de cobro segura y personalizada.

Puedes enviar el link de pago por Correo, Chat y Redes Sociales para que puedas continuar vendiendo desde la seguridad de tu casa.

Este documento le mostrará cómo usar nuestra API REST para autenticar, realizar solicitudes y recuperar datos. Todas las respuestas hacia y desde la API estarán en JSON, utiliza códigos de respuesta HTTP, autenticación y verbos estándar.
Puede usar la API NetPay en modo de prueba, que no afecta sus datos en vivo ni interactúa con las redes bancarias. La clave API que utiliza para autenticar la solicitud determina si la solicitud es en modo en vivo o en modo de prueba.

Base URL

En cada acción se deberá de sustituir la variable ​{{baseUrl}} ​ para poder realizar la petición.

Pruebas: https://ecommerce.netpay.com.mx/gateway-ecommerce

Producción: https://suite.netpay.com.mx/gateway-ecommerce

Códigos de estado HTTP

Utilizamos códigos de respuesta HTTP convencionales para indicar el éxito o el fracaso de una solicitud al API. En general, los códigos en el rango 2xx indican éxito, los códigos en el rango 4xx indican un error que resultó de la información proporcionada (por ejemplo, faltaba un parámetro requerido, sintaxis no válida, etc.), y los códigos en el rango 5xx indican un error con Servidores de NetPay.

CódigoDescripción
200 - OKTodo funcionó como se bien.
400 - Petición IncorrectaLa solicitud era inaceptable, a menudo debido a la falta de un parámetro requerido.
401 - No autorizadoNo se proporcionó una clave API válida.
402: solicitud fallidaLos parámetros eran válidos pero la solicitud falló.
403 - ProhibidoLa clave API no tiene permisos para realizar la solicitud.
404 - No encontradoEl recurso solicitado no existe.
405 - Método incorrectoEsta esperando que utilices un método distinto al que se esta mandando
409 - ConflictoLa solicitud entra en conflicto con otra solicitud.
429 - Demasiadas solicitudesDemasiadas solicitudes llegan a la API demasiado rápido. Recomendamos un retroceso exponencial de sus solicitudes.
500, 502, 503, 504 - Errores del servidorError en nuestros servidores, por favor, envía un correo a [email protected] notificando el error.

Request

Las solicitudes deben realizarse a través de HTTPS para garantizar que las transacciones estén cifradas. Los siguientes métodos de solicitud son compatibles:

MétodoDescripción
GETRecupera datos sobre colecciones y recursos individuales.
POSTPara colecciones, crea un nuevo recurso de ese tipo. También se utiliza para realizar acciones en puntos finales de acción.
PUTActualiza un recurso existente.
DELETEBorra un recurso. Esta es una acción destructiva.

Información importante antes de empezar

Tarjetas de prueba

DébitoDatos
Visa4000000000000002 con cualquier cvv y exp date válido (Enrolada 3DS)
MasterCard5200000000000007 con cualquier cvv y exp date válido (Enrolada 3DS)
Crédito MSIDatos
Visa4918717162313532 con cualquier cvv y exp date válido
MasterCard5120481234567895 con cualquier cvv y exp date válido
AMEX340000000003961 con cualquier cvv y exp date válido (Enrolada 3DS)
Tarjetas que pasaran por nuestro Dynamic 3DS y se rechazaran automáticamente (No aplican en MSI)Datos
Visa4000000000000010 con cualquier cvv y exp date válido (Enrolada 3DS)
MasterCard5200000000000015 con cualquier cvv y exp date válido (Enrolada 3DS)
AMEX340000000006022 con cualquier cvv y exp date válido (Enrolada 3DS)

Información para aplicar MSI

Los MSI disponibles son 3, 6, 9, 12 y 18 3_months, 6_months, 9_months, 12_months, 18_months

"monthlyPayment": ["3_months"]

Para poder utilizar los meses sin intereses la cantidad total de la compra debe de cumplir con las siguientes reglas:

CantidadTipo de MSI
>= 300 && < 6003 meses sin intereses
>= 600 && < 9003 y 6 meses sin intereses
>= 900 && < 12003, 6 y 9 meses sin intereses
>= 1200 && < 18003, 6 y 9 meses sin intereses
>= 18003, 6, 9, 12 y 18 meses sin intereses*
Recuerda que las cantidades están expresadas en pesos mexicanos.
*De 3-18 MSI se puede aplicar en tarjetas Visa Y Master Card Amex solo aplica de 3-12 MSI