Saltar al contenido
PAGOS · Pagos en línea

Tu proceso de pago.
Una forma más clara de pagar.

Convierte un pedido en línea en un sencillo recorrido de pago. Conecta tu sitio web con NeroPay, dirige a los clientes al proceso de pago alojado y lleva el resultado de vuelta a tu flujo de trabajo empresarial.

✓ Proceso de pago en sitio web✓ API v2✓ Página de pago alojada

Diseñado para tu sitio web o aplicación. ¿Prefieres una solicitud lista para compartir? En su lugar, explora Link Payments.

Proceso de pago alojado · API v2Vista previa
POST /v2/hosted-payments
{
  "identifier": "ORDER-1001",
  "amount": 15.99,
  "currency": "GBP",
  "details": "Online order",
  "ipn_url": "https://example.com/payments/ipn",
  "success_url": "https://example.com/order/thank-you",
  "cancel_url": "https://example.com/order/cancelled",
  "customer_name": "Customer",
  "customer_email": "customer@example.com"
}
Pedido ORDER-1001El cliente continúa al proceso de pago alojado
£15.99
TU SERVIDOR→PROCESO DE PAGO ALOJADO→RESULTADO DEL PAGO
La respuesta inicial crea una URL de pago. No confirma el pago.
Para sus clientesUn importe claro y un proceso de pago alojado.
Para sus desarrolladoresUna solicitud API para crear la página de pago.
Para su negocioControle el resultado, no solo el clic.
PAGOS MÁS ALLÁ DEL MOSTRADOR

Venda en línea. Mantenga el recorrido conectado.

Ofrezca a los clientes una forma sencilla de pagar sin integrar un flujo de ingreso de tarjeta en su propio sitio web.

Un proceso de pago que se adapta a su sitio

Mantenga su propio carrito y experiencia de pedido. Cree una página de pago cuando el cliente esté listo y luego rediríjalo a NeroPay.

La entrada de tarjeta permanece en el proceso de pago alojado

Su integración envía información del pedido y del cliente, no detalles sin procesar de la tarjeta. Su clave API secreta permanece en su servidor.

Lleve el resultado de vuelta a su flujo de trabajo

Utilice una referencia única de pedido y su punto de notificación de pagos para vincular el resultado del pago con el pedido que lo originó.

DEL CARRITO AL PAGO

Una ruta simple desde el pedido hasta el pago.

Su sitio mantiene la lógica del pedido. NeroPay proporciona el paso de pago alojado. Su servidor confirma el resultado antes de que usted lo gestione.

1

Cree el pedido

Guarde el total del carrito, los datos del cliente y su propia referencia única. Mantenga el importe final controlado por su servidor.

2

Cree el proceso de pago alojado

Envíe la solicitud desde su servidor a la API v2 y dirija al cliente a la URL de pago devuelta.

3

Confirmar y cumplir

Gestiona el resultado del pago del lado del servidor, compáralo con tu pedido y procesa el cumplimiento sólo una vez.

EXPLORAR EL PROCESO

Vea el siguiente paso.

Pedido guardado

Mantén la cesta en tu sitio web.

Tu servidor calcula el importe a pagar y guarda la referencia del pedido antes de crear el pago.

Trayectoria del cliente£15.99
PARA TU DESARROLLADOR

Tu lógica de pedidos.
Nuestro pago alojado.

Crea la página de pago desde tu servidor. Envía al cliente a la URL de pago devuelta, y luego usa resultados de pago verificados para actualizar el pedido.

01
Una integración del lado del servidor

El ejemplo usa API v2 y unidades monetarias mayores: 15.99 significa £15.99 en GBP.

02
Autenticado y firmado

Mantén la clave secreta en tu servidor. Firma el cuerpo JSON exacto que envías usando una marca de tiempo nueva.

03
Reintentar sin crear un nuevo pedido

Guarda la carga útil y la clave de idempotencia con tu pedido. Reutilízalas sólo para un reintento exacto de esa petición.

04
Cumplir una vez, tras la confirmación

Verifique el resultado del pago y coincida la referencia, el importe y la moneda antes de actualizar su pedido.

Este es un ejemplo de creación del lado del servidor, no una integración completa para producción. Agregue su propia persistencia de pedidos, manejo de notificaciones verificadas, manejo de errores y conciliación.

POST Ejemplo de pago del lado del servidor
// Server-side only · Node.js 18+
import { createHmac } from 'node:crypto';

const secret = process.env.NEROPAY_SECRET_API_KEY;
if (!secret) throw new Error('Missing API secret');

// Store this payload and key with the order before sending.
// Retry the exact same payload with the same idempotency key.
const payload = {
  "identifier": "ORDER-1001",
  "amount": 15.99,
  "currency": "GBP",
  "details": "Online order",
  "ipn_url": "https://example.com/payments/ipn",
  "success_url": "https://example.com/order/thank-you",
  "cancel_url": "https://example.com/order/cancelled",
  "customer_name": "Customer",
  "customer_email": "customer@example.com"
};
const rawBody = JSON.stringify(payload);
const timestamp = String(Math.floor(Date.now() / 1000));
const signature = createHmac('sha256', secret)
  .update(timestamp + '.' + rawBody)
  .digest('hex');

const response = await fetch(
  'https://eu.neropay.app/v2/hosted-payments',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + secret,
      'Accept': 'application/json',
      'Content-Type': 'application/json',
      'X-NeroPay-Timestamp': timestamp,
      'X-NeroPay-Signature': signature,
      'Idempotency-Key': 'hosted-order-1001-v1'
    },
    body: rawBody
  }
);

const result = await response.json();
if (!response.ok || !result.success) {
  throw new Error('Could not create checkout');
}

// Send this URL to the customer; do not mark the order paid here.
const checkoutUrl = result.data.checkout_url;
// Fulfil only after a verified server-side payment result.

Reemplace el cliente de ejemplo y las URL con los datos y puntos finales de su pedido. Nunca coloque su secreto de API en el HTML de la página o en JavaScript del lado del cliente.

DISEÑADO PARA VENTAS REALES

Más de una manera de vender en línea.

Elija la ruta de pago en línea que corresponda con la forma en que los clientes ordenan en su negocio.

Pedidos desde el sitio web

Utilice su cesta existente y envíe a los clientes a una página de pago alojada para el paso final del pago.

Reservas y depósitos

Construya un pago alrededor de un monto de reserva acordado y conecte la referencia de pago con la reserva.

Portales personalizados para clientes

Agregue un paso de pago a una cuenta de cliente, orden de servicio o flujo de trabajo entre empresas.

SU SITIO WEB, SU LÓGICA DE PEDIDOS

Mantenga las decisiones donde corresponden.

Una integración confiable comienza con una clara división de responsabilidades. Su sitio web define el pedido; el sistema de pago confirma si se pagó.

Valide el total en su servidor

No confíe en un precio suministrado por el navegador o en una referencia de pedido editada por el cliente.

Mantenga las credenciales fuera del navegador

Su clave secreta, la firma de solicitudes y las comprobaciones de resultados de pago pertenecen a su servidor.

Trate un redireccionamiento como una navegación, no como una prueba

Un cliente que llega a su página de agradecimiento no confirma por sí solo un pago exitoso.

LA HERRAMIENTA ADECUADA PARA LA SOLICITUD

Una cuenta. Más formas de recibir pagos.

Elija la vía que coincide con cómo compra su cliente—no un proceso de pago único para todos.

PARTE DE UN NEGOCIO CONECTADO

Los pagos son solo el comienzo.

Explore las herramientas NeroPay que se adaptan a cómo su negocio atiende a los clientes—en línea, con cita previa o en el mostrador.

NeroWeb

Menús y pedidos en línea
Lleve su experiencia de pedido de comida en línea y mantenga los pagos como parte del recorrido del cliente.

Explorar NeroWeb →

NeroBooking

Reservas y servicio al cliente
Mantenga la información de reservas cerca del resto de su negocio y elija la solicitud de pago adecuada para cada servicio.

Explorar NeroBooking →

NeroPOS

En el mostrador y más allá
Conecte su servicio presencial con la experiencia NeroPay más amplia, desde pedidos en la caja hasta pagos con tarjeta compatibles.

Explora NeroPOS →
El software NeroPOS, NeroWeb y NeroBooking es gratuito cuando usa pagos NeroPay. El procesamiento de pagos, hardware y cualquier servicio opcional tienen precios y términos aplicables propios. Ver precios →
TUS PREGUNTAS, RESPONDIDAS

Pagos en línea.
Los detalles útiles.

¿Necesita ayuda para elegir la configuración adecuada para su negocio? Nuestro equipo puede explicarle las opciones.

Hable con NeroPay →

Referencia oficial de la API v2 ↗

¿Necesito crear mi propio formulario de pago con tarjeta?

No. La API crea una página de pago alojada en NeroPay. Su sitio web controla el carrito y redirige al cliente al pago; los datos de la tarjeta se ingresan en la página alojada.

¿Necesito un desarrollador para conectar un sitio web existente?

Una integración personalizada de la API normalmente requiere un desarrollador. Si no necesita un carrito personalizado, Link Payments, Invoice Payments y NeroForm ofrecen otras formas de solicitar el pago.

¿Dónde puedo encontrar la referencia de la API?

La referencia de la API NeroPay v2 contiene los campos de solicitud, detalles de autenticación, ejemplos y guía para notificaciones de pago. Use la referencia más reciente al construir su integración.

¿Cómo debería mi sitio confirmar que un pedido está pagado?

Utilice un resultado de pago verificado en el servidor y compárelo con la referencia del pedido y el importe. No procese la entrega solo porque se abrió la página de pago o el cliente regresó a una URL de éxito.

¿Pueden los pagos en línea y presenciales usar la misma cuenta NeroPay?

Sí. Su cuenta NeroPay puede soportar herramientas de pago en línea junto con su configuración habilitada para pagos presenciales. Los métodos disponibles y los requisitos de la cuenta dependen de su negocio y región.

¿Qué significa el importe en el ejemplo de la API?

El ejemplo usa unidades principales de la moneda: 15.99 significa £15.99 cuando la moneda es GBP. Siempre siga el formato de importe documentado del endpoint.

¿Dónde puedo consultar tarifas y detalles de liquidación?

Consulte la tarifa actual NeroPay y los términos para su cuenta. Un pago exitoso del cliente y la disponibilidad de fondos para pago son etapas separadas; no prometa disponibilidad instantánea a partir de la respuesta del pago.

Ofrezca a su sitio web un recorrido de pago que valga la pena completar.

Explore el pago alojado, revise la referencia de la API y elija la configuración de pago en línea adecuada para su negocio.