Passer au contenu
NeroPay Menu | Ressources Intégrations En vedette
PAIEMENTS · Paiements en ligne

Votre passage en caisse.
Une manière plus claire de payer.

Transformez une commande en ligne en un parcours de paiement simple. Connectez votre site web à NeroPay, envoyez les clients vers une caisse hébergée et récupérez le résultat dans votre flux de travail.

✓ Caisse sur site✓ API v2✓ Page de paiement hébergée

Conçu pour votre site web ou application. Vous préférez une demande prête à partager ? Découvrez plutôt les Link Payments.

Caisse hébergée · API v2Aperçu
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"
}
Commande ORDER-1001Le client poursuit vers la caisse hébergée
£15.99
VOTRE SERVEUR→CAISSE HÉBERGÉE→RÉSULTAT DU PAIEMENT
La réponse initiale crée une URL de paiement. Elle ne confirme pas le paiement.
Pour vos clientsUn montant clair et un paiement hébergé.
Pour vos développeursUne seule requête API pour créer la page de paiement.
Pour votre entrepriseSuivez le résultat, pas seulement le clic.
PAIEMENTS AU-DELÀ DU COMPTOIR

Vendez en ligne. Gardez le parcours connecté.

Offrez à vos clients une manière simple de payer sans intégrer un formulaire de saisie de carte sur votre site.

Un paiement qui s’adapte à votre site

Conservez votre propre panier et expérience de commande. Créez une page de paiement quand le client est prêt, puis redirigez-le vers NeroPay.

La saisie de la carte reste dans le paiement hébergé

Votre intégration envoie les informations de commande et client—pas les données brutes de la carte. Votre clé API secrète reste sur votre serveur.

Ramenez le résultat dans votre flux de travail

Utilisez une référence de commande unique et votre point de notification de paiement pour relier le résultat du paiement à la commande correspondante.

DU PANIER AU PAIEMENT

Un chemin simple de la commande au paiement.

Votre site conserve la logique de commande. NeroPay fournit l’étape de paiement hébergé. Votre serveur confirme le résultat avant la livraison.

1

Créez la commande

Enregistrez le total du panier, les détails client et votre propre référence unique. Gardez le montant final contrôlé par votre serveur.

2

Créez le paiement hébergé

Envoyez la requête depuis votre serveur à l’API v2 et dirigez le client vers l’URL de paiement retournée.

3

Confirmer et exécuter

Gérez le résultat de paiement côté serveur, rapprochez-le avec votre commande et procédez à l'exécution une seule fois.

DÉCOUVRIR LE PROCESSUS

Voyez l'étape suivante.

Commande enregistrée

Conservez le panier sur votre site web.

Votre serveur calcule le montant à payer et enregistre la référence de commande avant que le paiement ne soit créé.

Parcours client£15.99
POUR VOTRE DÉVELOPPEUR

La logique de votre commande.
Notre paiement hébergé.

Créez la page de paiement depuis votre serveur. Envoyez le client à l'URL du paiement renvoyée, puis utilisez les résultats de paiement vérifiés pour mettre à jour la commande.

01
Une intégration côté serveur

L'exemple utilise l'API v2 et des unités monétaires principales : 15.99 signifie £15.99 en GBP.

02
Authentifié et signé

Gardez la clé secrète sur votre serveur. Signez le corps JSON exact que vous envoyez en utilisant un horodatage récent.

03
Réessayez sans créer une nouvelle commande

Conservez la charge utile et la clé d'idempotence avec votre commande. Réutilisez-les uniquement pour une reprise exacte de cette requête.

04
Exécutez une seule fois, après confirmation

Vérifiez le résultat du paiement et confrontez la référence, le montant et la devise avant de mettre à jour votre commande.

Ceci est un exemple de création côté serveur — ce n’est pas une intégration complète pour la production. Ajoutez votre propre persistance de commande, la gestion des notifications vérifiées, la gestion des erreurs et la réconciliation.

POST Exemple de paiement côté serveur
// 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.

Remplacez le client exemple et les URL par vos données de commande et vos points de terminaison. Ne placez jamais votre clé secrète API dans le code HTML de la page ni dans le JavaScript côté client.

CONÇU AUTOUR DE VENTES RÉELLES

Plus d’une façon de vendre en ligne.

Choisissez la méthode de paiement en ligne qui correspond à la manière dont les clients commandent auprès de votre entreprise.

Commandes sur site web

Utilisez votre panier existant et envoyez les clients vers une page de paiement hébergée pour l’étape finale de paiement.

Réservations et acomptes

Construisez un paiement autour d’un montant de réservation convenu et associez la référence de paiement à la réservation.

Portails clients sur mesure

Ajoutez une étape de paiement à un compte client, une commande de service ou un workflow business-to-business.

VOTRE SITE WEB, VOTRE LOGIQUE DE COMMANDE

Gardez les décisions là où elles doivent être.

Une intégration fiable commence par une division claire des responsabilités. Votre site web définit la commande ; le système de paiement confirme si elle a été payée.

Validez le total sur votre serveur

Ne faites pas confiance à un prix fourni par le navigateur ou à une référence de commande modifiée par le client.

Ne laissez pas les identifiants dans le navigateur

Votre clé secrète, la signature des requêtes et les vérifications des résultats de paiement doivent rester sur votre serveur.

Considérez une redirection comme une navigation — pas comme une preuve

Le fait qu’un client arrive sur votre page de remerciement ne confirme pas à lui seul un paiement réussi.

L’OUTIL ADAPTÉ POUR LA DEMANDE

Un compte. Plus de façons d’être payé.

Choisissez la voie correspondant à la façon dont votre client achète — pas un parcours de paiement universel.

PARTIE D’UNE ENTREPRISE CONNECTÉE

Les paiements ne sont que le début.

Découvrez les outils NeroPay adaptés à la façon dont votre entreprise sert ses clients — en ligne, sur rendez-vous ou au comptoir.

NeroWeb

Menus et commandes en ligne
Mettez l’expérience de commande de repas en ligne et intégrez les paiements dans le parcours client.

Explorer NeroWeb →

NeroBooking

Réservations et service client
Gardez les informations de réservation proches du reste de votre activité et choisissez la demande de paiement appropriée pour chaque service.

Explorer NeroBooking →

NeroPOS

Au comptoir et au-delà
Connectez votre service en personne à une expérience NeroPay plus large, allant des commandes à la caisse aux paiements par carte pris en charge.

Découvrez NeroPOS →
Le logiciel NeroPOS, NeroWeb et NeroBooking est gratuit lorsque vous utilisez les paiements NeroPay. Le traitement des paiements, le matériel et les services optionnels ont leurs propres tarifs et conditions applicables. Voir les tarifs →
VOS QUESTIONS, NOS RÉPONSES

Paiements en ligne.
Les détails utiles.

Besoin d’aide pour choisir la configuration adaptée à votre entreprise ? Notre équipe peut vous expliquer les options.

Parlez à NeroPay →

Référence officielle de l’API v2 ↗

Dois-je créer mon propre formulaire de paiement par carte ?

Non. L’API crée une page de paiement hébergée par NeroPay. Votre site contrôle le panier et redirige le client vers le paiement ; les coordonnées de la carte sont saisies sur la page hébergée.

Ai-je besoin d’un développeur pour connecter un site existant ?

Une intégration API personnalisée nécessite généralement un développeur. Si vous n’avez pas besoin d’un panier personnalisé, les paiements Link, les paiements par facture et NeroForm offrent d’autres moyens de demander un paiement.

Où puis-je trouver la référence de l’API ?

La référence de l’API NeroPay v2 contient les champs de requête, les détails d’authentification, des exemples et des instructions pour la notification de paiement. Utilisez la dernière référence lors de la création de votre intégration.

Comment mon site doit-il confirmer qu’une commande est payée ?

Utilisez un résultat de paiement côté serveur vérifié et associez-le à la référence et au montant de la commande. Ne validez pas simplement parce que la page de paiement s’est ouverte ou que le client est revenu à une URL de succès.

Les paiements en ligne et en personne peuvent-ils utiliser le même compte NeroPay ?

Oui. Votre compte NeroPay peut prendre en charge les outils de paiement en ligne ainsi que votre configuration de paiement en personne activée. Les méthodes disponibles et les exigences du compte dépendent de votre entreprise et de votre région.

Que signifie le montant dans l’exemple d’API ?

L’exemple utilise les unités principales de la devise : 15.99 signifie £15.99 lorsque la devise est GBP. Respectez toujours le format de montant documenté pour le point d’extrémité.

Où puis-je vérifier les frais et les détails de règlement ?

Consultez la tarification actuelle NeroPay et les conditions pour votre compte. Un paiement client réussi et la disponibilité des fonds pour le paiement sont des étapes distinctes ; ne promettez pas une disponibilité instantanée à partir de la réponse du paiement.

Offrez à votre site un parcours de paiement qu’on a envie de finir.

Découvrez le paiement hébergé, consultez la référence API et choisissez la configuration de paiement en ligne adaptée à votre entreprise.