Mise en place des services

Cette section vous permettra de mettre en place les services Stancer pour votre commerce.

API

Stancer propose aux commerçants un service d'encaissement via une API (Application Programming Interface). Cette API vous permet d'encaisser vos clients depuis votre site commerçant. Afin d'utiliser nos services de paiements sur votre site, vous devez intégrer notre API en suivant les étapes ci-dessous :

1. Choisir un mode d'intégration

Le mode d'intégration adéquat pour votre activité dépend notamment de :

• votre disponibilité : certains modes d'intégration demandent une intégration généralement plus longue.
• votre souhait de personnaliser l'expérience de paiement : certains modes d'intégration offrent des possibilités de personnalisation.
• vos compétences techniques (développement et maintenance)

Modes d'intégration disponibles

Ce tableau synthétise l'ensemble des modes d'intégration possibles et leurs caractéristiques :

Mode d'intégration	Temps d'intégration	Possibilité de personnalisation	Compétences techniques requises
Lien de paiement	Aucun	Faible	Aucune
Modules CMS	Faible (< 1 jour)	Faible	Aucune
Redirect	Faible (< 1 jour)	Faible	Modérées
Iframe	Selon vos connaissances techniques	Forte	Avancées
Full API	Selon vos connaissances techniques	Forte	Avancées

Lien de paiement

Si vous ne disposez pas d'un site commerçant ou ne souhaitez pas traiter vos paiements sur ce dernier, ce mode est particulièrement adapté. Cette méthode consiste à créer, pour chaque transaction, un lien de paiement unique pour procéder au paiement. Il vous suffit alors de l'envoyer à votre client pour l'encaisser.

Questions fréquentes

• Le nom de mon entreprise apparait-il sur les reçus et relevés des clients ?

Oui, le nom de votre entreprise apparaîtra sur les reçus et relevés de vos clients. Après l'activation de votre contrat, il faut cependant prévoir un délai pouvant aller jusqu'à 48 heures pour que l’information se synchronise dans notre système de paiement. Si, passé ce délai, le nom n’apparaît pas correctement, contactez notre service client.

Modules CMS

Ce mode d'intégration convient si vous disposez déjà d'un site commerçant basé sur l'une des plateformes e-commerce (CMS) que nous supportons. Ce mode d'intégration consiste à installer un module de paiement développé par nos équipes sur votre CMS. Une fois installé et paramétré, ce module permet à vos clients de payer leurs achats sur votre site commerçant.

Pour découvrir comment installer ces modules, cliquez sur le CMS que vous utilisez pour votre site et laissez vous guider :

• PrestaShop
• WooCommerce
• Magento
• Microsoft Teams

Redirect : le lien vers une page de paiement sécurisée

Ce mode d'intégration consiste à renvoyer vos clients vers une page hébergée par Stancer pour les encaisser. C'est une manière sûre et efficace de commencer votre activité en ligne. Stancer prend en charge la gestion et maintenance complète de la page de paiement : vos clients paient leurs achats en toute sécurité. C'est une solution rapide à mettre en œuvre et qui vous décharge complètement de la gestion des transactions.

Iframe

Stancer développe et maintient des champs de paiement prêts à l'emploi pour votre site commerçant. Ces champs facilitent l'intégration de notre API et vous garantissent la conformité de votre site en matière de sécurité. Vous utilisez alors ces champs pour créer le formulaire de paiement de votre site commerçant. Ce formulaire est ainsi pleinement intégré à votre site commerçant pour une expérience de paiement optimisée.

Full API : le mode d'intégration complètement transparent

Ce mode d'intégration est adapté si vous développez ou avez développé complètement votre formulaire de paiement. L'expérience paiement est totalement transparente pour vos clients et vos équipes techniques. Vous pouvez personnaliser tous les champs du formulaire de paiement, pour une intégration complète à l'univers de votre site commerçant.

En choisissant le mode d'intégration Full API, vous devenez responsable de l'envoi des informations des cartes bancaires de vos clients et de leur intégrité. Vous devez alors garantir leur envoi à Stancer. Au-delà d'un certain volume de transactions, une certification PCI-DSS est nécessaire. De fait, nos équipes conseillent ce mode d'intégration pour les entreprises disposant d'équipes techniques en mesure de mettre en place mais aussi de maintenir les formulaires de paiement développés.

2. Intégrer l'API Stancer

Au terme de cette phase d'intégration, vous serez en mesure de recevoir les premiers paiements de vos clients.

Prérequis

La documentation technique en ligne vous permettra d'initier vos premiers messages techniques à notre API. Au préalable, vous devrez vous munir des clés de tests à votre disposition dans l'Espace Client.

Outils

Les outils sont gratuitement à votre disposition dans votre Espace Client, rubrique Développeurs.

• Nos librairies informatiques : les librairies pour différents langages informatiques (Python, PHP, Perl),

• Modules CMS,

• La documentation technique de l'API Stancer.

Intégration selon le mode choisi

• Lien de paiement : aucune intégration n'est nécessaire. Pour créer votre lien de paiement : rendez-vous dans votre Espace Client puis renseignez le montant et les informations du paiement. Adressez ensuite le lien du paiement ainsi créé à votre client (e-mail ou SMS).

• CMS : vous devez installer le module Stancer sur votre CMS. Rendez-vous dans notre espace dédié pour sélectionner le module adapté à votre site commerçant. Suivez ensuite les étapes d'installation et de paramétrage du module afin de l'installer sur votre site commerçant.

• Redirect, iframe, Full API : Munissez-vous de vos clés de tests et clés de production.

Questions fréquentes

• Je n'ai pas reçu mes clés de production : que se passe-t-il ?

Veuillez noter que vos clés de production ne sont disponibles qu'après validation de votre Dossier Client. Une fois votre souscription finalisée et votre compte validé, vos clés de production sont disponibles dans la rubrique Développeurs de votre Espace Client. Si les clés de production ne sont toujours pas disponibles 48h après la validation de votre Dossier Client, veuillez contacter notre support via la rubrique Aide de l'Espace Client.

3. Tester l'API Stancer

Grâce aux outils, vous pouvez débuter l'intégration de notre API et lui adresser vos premiers paiements. Stancer met à votre disposition un jeu de cartes bancaires et d'IBANs de tests qui génèreront automatiquement les différentes réponses possibles de notre API.

4. Faites-vous payer

Une fois l'ensemble des tests réalisés, vous pourrez remplacer vos clés de tests par vos clés de production afin d'adresser des paiements effectifs à l'API Stancer en production.

Tap to Pay

Avec Tap to Pay via l’application Stancer, vous pouvez accepter tous les paiements en personne et sans contact directement sur votre smartphone ou tablette, qu’ils proviennent de cartes bancaires, Google Pay, Apple Pay ou d’autres portefeuilles numériques.

1. Comment l’activer ?

Pour utiliser Tap to Pay suivez ces étapes :

1. Inscrivez-vous et téléchargez l’application Stancer depuis le Google Play Store (Android) ou l’App Store (iPhone).
2. Connectez-vous à votre Compte Stancer.
3. Dans l’application, suivez les instructions pour activer Tap to Pay, ou cliquez sur "Tap to Pay" dans la section “Besoin d’aide ?”, rubrique "Compte".

2. Comment ça marche ?

Pour encaisser un paiement avec Tap to Pay :

1. Ouvrez l’application Stancer et saisissez le montant à payer.
2. Sélectionnez “Tap to Pay” et présentez votre appareil au client.
3. Le client approche sa carte ou son smartphone compatible à l’arrière de votre appareil pour effectuer le paiement.
4. Utilisez Tap to Pay pour accepter les paiements qui nécessitent la saisie d’un code PIN pour confirmer le paiement.
5. Transaction validée ! Le reçu s’affiche à l’écran et peut être partagé immédiatement.

Pour Android

Pour iPhone

3. Paiement sans contact et paiement par code PIN

Avec Tap to Pay et l’application Stancer, vous pouvez accepter :

• des paiements sans contact (carte, Apple Pay, Google Pay, portefeuilles numériques)
• des paiements nécessitant un code PIN

🔹 Sans contact : Tap to Pay n’impose aucune limite de montant. La limite dépend de la banque du client (ex : la plupart des cartes françaises plafonnent à 50 €).
🔹 Avec code PIN : si nécessaire, l’appareil affiche automatiquement un clavier sécurisé (Apple pour iPhone, Stancer pour Android) pour la saisie du code.

Questions fréquentes

• Quels sont les appareils compatibles avec Tap to Pay ?

Android

Smartphones et tablettes sous Android 13 ou version ultérieure, certifiés GMS, équipés de la technologie NFC et à jour. Les appareils doivent avoir les services Google Play, être non rootés, avec le mode débogage et les options développeur désactivés, ainsi que l’heure automatique activée pour assurer une bonne synchronisation réseau. Les modèles d’entrée de gamme dotés d’une antenne NFC faible peuvent présenter des performances réduites.

iPhone

Modèles iPhone XS ou plus récents, avec la dernière version d’iOS.

• Quels sont les modes de paiement acceptés ?

Avec Tap to Pay, acceptez des paiements en personne et sans contact, provenant de cartes bancaires, d’Apple Pay, et de smartphones munis d’autres portefeuilles numériques.

• Quel est le délai de reversement de mon argent ?

Les sommes collectées sont reversées sous 7 jours ouvrés. Ce délai permet de vérifier les paiements et prévenir la fraude. Les fonds sont conservés sur votre Compte de Reversement pendant cette période et transférés ensuite sur votre Compte Bancaire, déduction faite des commissions.

Remarque : Ce délai peut être prolongé en cas de jour férié.

• Que faire en cas d'impossibilité de lecture d'une carte de paiement sans contact ?

1. Vérifiez la présence du symbole sans contact sur la carte.
2. Placez la carte sur la zone NFC de votre appareil, puce côté gauche.
3. Si la lecture échoue, glissez légèrement la carte pour centrer la puce.
4. Si le problème persiste, la carte peut être endommagée ou incompatible. Proposez une autre carte ou un portefeuille numérique.

• Tap to Pay prend-il en charge les transactions nécessitant un code PIN ?

Oui. Après avoir présenté sa carte, le client peut être invité à saisir son code PIN via l’interface sécurisée (Apple sur iPhone, Stancer sur Android).

• Comment effectuer un remboursement ?

1. Ouvrez l’application Stancer et allez dans Transactions.
2. Sélectionnez le paiement Tap to Pay.
3. Appuyez sur Rembourser et confirmez.

Remarque : Avec Tap to Pay, veuillez noter que la carte utilisée pour le remboursement doit être identique à la carte précédemment utilisée pour effectuer le paiement. Le remboursement peut être effectué à partir de n'importe quel appareil qui partage le même type de système d'exploitation.

• Le nom de mon entreprise apparait-il sur les reçus et relevés des clients ?

Oui, le nom de votre entreprise apparaîtra sur les reçus et relevés de vos clients. Après l'activation de votre contrat, il faut cependant prévoir un délai pouvant aller jusqu'à 48 heures pour que l’information se synchronise dans notre système de paiement. Si, passé ce délai, le nom n’apparaît pas correctement, contactez notre service client.

4. Liens utiles

• Foire aux questions
• Tap to Pay sur iPhone et confidentialité
• Sécurité « Tap to Pay sur iPhone »
• How to use Tap to Pay on iPhone for your business
• Find the software version on your iPhone, iPad, or iPod

App2App Deeplink

L’intégration App2App via Deeplink permet à votre application mobile de lancer un encaissement Tap to Pay dans l’application Stancer et de récupérer automatiquement le résultat du Paiement dans votre application.

Cette fonctionnalité est disponible sur Android et iPhone.

1. Comment ça marche ?

Le fonctionnement repose sur un échange entre deux applications via des deeplinks :

• Votre application déclenche une demande d’encaissement.
• L’application Stancer s’ouvre automatiquement.
• L’utilisateur réalise le paiement Tap to Pay.
• Stancer traite le résultat du paiement.
• L’utilisateur est automatiquement redirigé vers votre application avec le statut du Paiement.
• L'application peut également envoyer automatiquement un ticket de caisse au Payeur par e-mail ou SMS après un Paiement réussi.

Schéma général :

┌─────────────────────┐
│ Votre application   │
└─────────┬───────────┘
          │
          │ Deeplink de paiement
          ▼
┌─────────────────────┐
│ Application Stancer │
└─────────┬───────────┘
          │
          │ Encaissement Tap to Pay
          ▼
┌─────────────────────┐
│ Votre application   │
└─────────┬───────────┘
          │
          │ Résultat du paiement
          ▼
┌──────────────────────────────────────--──┐
│ Traitement métier dans votre application │
└────────────────────────────────────────--┘

2. Prérequis

Sur iPhone :

• iPhone (XS ou ultérieur) sous iOS 16.4+, avec l'application Stancer installée.
• Compte Client Stancer avec Tap to Pay activé (appareil enrôlé).
• Votre application doit déclarer une URL scheme (deeplink) pour recevoir le retour.

Sur Android :

• Appareil Android compatible NFC sous Android 13 (API level 33) ou ultérieur, avec l'application Stancer installée.
• Compte Client Stancer avec Tap to Pay activé (appareil enrôlé).
• Votre application doit déclarer un intent-filter avec une URL scheme (deeplink) pour recevoir le retour.

3. Déclencher un Paiement

Ouvrez l'URL suivante depuis votre application : stancer://pay?amount=12.50&order_id=CMD-2026-042&return_url=monapp%3A%2F%2Fstancer-callback

Paramètre	Requis	Description
amount	Oui	Montant en euros, unités décimales (pas en centimes). Point ou virgule, 2 décimales max, > 0. Ex : 12.50 ou 12,50. Tout autre format est rejeté.
return_url	Oui	Deeplink de votre application, URL-encodé, rappelé avec le résultat. Le schéma Stancer est refusé. Une demande sans return_url valide est ignorée.
currency	Non	Code ISO 4217 (3 lettres). Défaut : EUR. V1 : seul EUR est accepté. Toute autre devise entraîne un retour immédiat status=failure.
order_id	Non	Votre référence de commande. Rattachée au paiement Stancer et renvoyée telle quelle dans le retour.
send_receipt	Non	true ou 1 : envoi automatique du ticket de caisse au Payeur après un paiement réussi.
email	Non	E-mail du Payeur pour le reçu.
mobile	Non	Numéro de téléphone du Payeur pour le reçu par SMS, au format international E.164 (ex : +33612345678, encodé %2B33612345678).

4. Retour du Paiement

Lorsque le paiement atteint un état final, Stancer ouvre votre application via le return_url. Exemple : monapp://stancer-callback? status=success& payment_id=paym_ab12cd34& amount=1250& order_id=CMD-2026-042

Paramètre	Description
status	success: Paiement accepté. failure: Paiement refusé ou impossible. cancelled: lecture Carte ou saisie PIN annulée.
payment_id	Identifiant du Paiement Stancer (paym_xxx). Absent si le Paiement n'a pas pu être créé (échec précoce).
amount	Montant payé, en centimes d'euros (nombre entier). Ex: 1250 pour 12,50 €.
order_id	Écho de votre référence, si fournie.
currency	Devise (EUR).

Note

Un seul retour est envoyé pour chaque demande de paiement. Il correspond au résultat final du Paiement. Nous vous recommandons de prévoir un délai d'attente de 90 secondes. Aucun retour ne sera envoyé si l'application Stancer n'est pas configurée sur l'appareil ou si Tap to Pay ne peut pas démarrer. Pour confirmer le résultat d'un Paiement, utilisez le payment_idxx pour vérifier son statut via l'API Stancer.

5. Gestion des erreurs

Un retour immédiat en erreur peut arriver dans les cas suivants :

• Appareil incompatible avec Tap to Pay.
• Un Paiement App2App est déjà en cours.
• Le terminal Tap to Pay n’a pas pu être initialisé dans les 60 secondes.
• Devise différente de EUR (à prévoir pour une version ultérieure).

Votre application doit prévoir un timeout recommandé de 90 secondes.

6. Envoi automatique du ticket de caisse

Votre application peut demander l’envoi automatique d’un ticket de caisse après un Paiement réussi.

Activation : send_receipt=true
Conditions :

• E-mail ou numéro de téléphone valide fourni.
• Paiement accepté.

Règles :

• L’envoi est automatique après succès du Paiement.
• L’envoi est asynchrone.
• Il ne bloque pas le retour vers votre application.
• Aucun reçu n’est envoyé pour un Paiement refusé ou annulé.

Si e-mail et numéro de télphone sont fournis :

• Email prioritaire.
• SMS en complément si nécessaire.

7. Exemples de retour

Demande minimale :

stancer://pay?amount=12.50&return_url=monapp%3A%2F%2Fstancer-callback

Demande complète :

stancer://pay?amount=12.50&currency=EUR&order_id=CMD-2026-042&return_url=monapp%3A%2F%2Fstancer-callback&send_receipt=true&email=client%40exemple.fr&mobile=%2B33612345678

Retours correspondants :

Paiement réussi : monapp://stancer-callback?status=success&payment_id=paym_ab12cd34&amount=12.5&currency=EUR&order_id=CMD-2026-042

Paiement échoué : monapp://stancer-callback?status=failure&payment_id=paym_ab12cd34&amount=12.5&currency=EUR&order_id=CMD-2026-042

Paiement annulé : monapp://stancer-callback?status=cancelled&amount=12.5&currency=EUR&order_id=CMD-2026-042

8. Exemples d'intégration (Swift / SwiftUI)

// Déclencher le paiement — URLComponents encode return_url automatiquement 

var components = URLComponents(string: "stancer://pay")! 

components.queryItems = [ 
URLQueryItem(name: "amount", value: "12.50"), 
URLQueryItem(name: "order_id", value: "CMD-2026-042"), 
URLQueryItem(name: "return_url", value: "monapp://stancer-callback"), 
URLQueryItem(name: "send_receipt", value: "true"), 
URLQueryItem(name: "email", value: "client@exemple.fr"), 
] 

UIApplication.shared.open(components.url!) 

// Recevoir le retour 

.onOpenURL { url in 
let items = URLComponents(url: url, resolvingAgainstBaseURL: false)?.queryItems ?? [] 
let status = items.first { $0.name == "status" }?.value // success | failure | cancelled 
let paymentID = items.first { $0.name == "payment_id" }?.value 
let orderID = items.first { $0.name == "order_id" }?.value// ... traiter le résultat 
}

N'oubliez pas de déclarer votre scheme dans le projet : Target → Info → URL Types → URL Schemes.

9. Bonnes pratiques

• Encodez toujours return_url.
• Utilisez un order_id unique pour chaque paiement.
• Prévoyez un délai d'attente de 90 secondes.
• Vérifiez le statut du Paiement via l'API Stancer avec le payment_id.
• Attendez le résultat d'un paiement avant d'en lancer un nouveau.

Terminal

Débuter avec le terminal ne vous prendra que quelques minutes. Suivez les étapes de cette rubrique pour commencer à encaisser vos clients dans votre point de vente.

1. Commander votre terminal

Rendez-vous dans la rubrique Terminal de votre Espace client et laissez vous guider. Une fois votre commande passée, vous recevrez un e-mail de confirmation et vous pourrez suivre l'avancée de votre commande sur votre Espace Client.

2. Réceptionner votre terminal

Stancer vous adresse un colis contenant :

• Le terminal de paiement,
• Sa base de chargement,
• Votre carte commerçant : il s'agit d'une carte magnétique encryptée permettant, au besoin, de rembourser vos clients.

Si vous n'avez pas reçu l'un de ces éléments, contactez nos équipes via la rubrique Aide de l'Espace Client.

3. Mise en service de votre terminal

Dès réception du terminal, vous devez le mettre en service. Pour cela, suivez les étapes suivantes :

1. Branchez la base de chargement de votre terminal sur le secteur puis posez votre terminal sur cette dernière.
2. Le terminal débutera automatiquement sa charge.
3. Allumez votre terminal. Le terminal se connecte directement aux réseaux 4G grâce à la carte SIM déjà activée. Une fois connecté, le terminal peut parfois installer une mise à jour : aucune action n'est nécessaire de votre part. Laissez votre terminal se mettre à jour avant d'effectuer votre premier paiement.
4. Connectez-vous à votre Espace Client : votre terminal doit maintenant apparaître dans la rubrique Terminal.
5. Félicitations, vous pouvez désormais encaisser votre premier client !

4. Procédure de retour d’un TPE

La procédure de retour d’un terminal de paiement électronique (TPE) s’applique dans les situations suivantes :

• Échange de TPE

• Restitution simple (hors cas de résiliation de contrat)

Pour l’échange d’un TPE :

Dans le cadre d’un échange, notre partenaire logistique vous remettra votre nouveau TPE contre remise de l’ancien.

Ainsi, il est important de préparer l’ancien TPE afin de faciliter le remplacement :

• Déconnectez le TPE de toute source d’alimentation et de connexion

• Réinitialisez le TPE

• Réalisez une télécollecte manuellement

• Rangez le TPE dans son emballage d’origine avec tous ses accessoires

En cas d’indisponibilité, modifiez les modalités de livraison de votre nouveau TPE directement depuis la plateforme de notre partenaire en cliquant sur le lien contenu dans le mail de suivi.

⚠️ Note

Si cette collecte ne peut être réalisée au moment de la livraison car l’ancien terminal n’est pas prêt à être récupéré, vous devrez retourner le TPE à vos frais.

Restitution simple :

Pour restituer le TPE, il vous suffit de suivre les étapes suivantes :

• Déconnectez le terminal de toute source d’alimentation et de connexion

• Réinitialisez le terminal

• Rangez le terminal dans son emballage d’origine avec tous ses accessoires

Adressez alors ce colis directement à l’adresse indiquée dans l’Espace Client, rubrique ‘Terminal’.

Notez que le numéro de suivi du colis pourra vous être demandé par notre équipe support afin de faciliter la réception de votre TPE : veillez à le conserver lors de l’envoi.

Pour toute question ou assistance concernant cette procédure, notre équipe reste à votre disposition à l’adresse : support@stancer.com.

Questions fréquentes

• Mon terminal n'a pas de réseau : que faire ?

Il peut arriver que la connexion avec les réseaux téléphoniques soit complexe : magasin souterrain, forte épaisseur des murs, zone de faible couverture... Vous pouvez alors utiliser la connexion Wifi de votre terminal grâce au mode d'emploi fourni avec l'équipement. Vous bénéficiez alors de la connexion de votre box internet ou de votre téléphone grâce aux options de partage de connexion / point d'accès mobile.

• J'ai égaré, endommagé mon terminal : comment disposer d'un nouveau terminal ?

Signalez dès que possible sa perte/vol/casse à notre numéro de support (numéro indiqué sur la base de votre terminal) afin de faire une demande de remplacement.

• Comment ajouter un nouveau terminal à mon parc ?

Rendez-vous sur votre Espace Client et commandez un nouveau terminal dans la rubrique Terminal.

• J'ai perdu ma carte commerçant: que faire ?

Commandez une nouvelle carte commerçant dans la rubrique Terminal de l'Espace Client : cliquez sur le terminal concerné puis cliquez sur "Commander une carte commerçant". Notez que des frais inhérents à cette démarche s'appliquent suivant les Conditions Tarifaires.

• Je ne vois pas le terminal de paiement dans mon Espace Client.

L'actualisation de votre Espace Client peut parfois nécessiter quelques minutes. Si après 24 heures, le terminal de paiement n'apparaît pas, contactez nos équipes via la rubrique Aide de l'Espace Client.

• À quelle adresse dois-je retourner le Terminal ?

Verifone c/o NSE Bâtiment B – Porte B/D ZA La Tour 03200 Abrest