Paiements en ligne
Acceptez les paiements par carte sur votre site.
Votre site crée une session avec l'API. Votre client paie sur une page hébergée, en français ou en anglais, avec 3-D Secure. Le résultat arrive sur votre serveur par un webhook signé.
- Visa et Mastercard
- 3-D Secure à chaque paiement
- Page en français et en anglais

Comment ça marche
Du panier à la commande payée, en quatre étapes.
- 1
Créez une session
Votre serveur envoie le montant, le client et votre référence de commande. L'API répond avec l'adresse de la page de paiement.
- 2
Redirigez votre client
Il arrive sur pay.sollupay.com, avec le nom de votre boutique, sa commande et le montant.
- 3
Il paie, protégé par 3-D Secure
Il saisit sa carte sur la page sécurisée de la Société Monétique Tunisie, puis sa banque confirme le paiement.
- 4
Vous validez la commande
Sollupay envoie le résultat signé à votre serveur. Vous validez la commande et votre client revient sur votre site.
La page de paiement
Une page de paiement que vous n'avez pas à construire.
Votre client voit votre nom, sa commande et le montant, choisit sa langue et paie par carte. Vous n'avez rien à héberger.
- Aucune donnée de carte chez vousLa carte est saisie sur la page sécurisée de la Société Monétique Tunisie. Elle ne passe jamais par votre site ni par vos serveurs.
- 3-D Secure sur chaque paiementLa banque du client vérifie que la carte est bien la sienne : un code par SMS, une validation dans son application, ou rien du tout.
- Un refus ne fait pas perdre la venteAprès un refus, votre client réessaie sur la même page, avec la même carte ou une autre. Cinq essais par défaut, de 1 à 10 selon votre choix.
- Aussi dans votre application mobileOuvrez la page dans un onglet de navigateur intégré à l'application. 3-D Secure y fonctionne comme sur le web.
Tentatives de paiement
Commande JW-2031
- Essai 1RefuséFonds insuffisants
- Essai 2AcceptéVisa •••• 1119 · 3-D Secure
3 essais restaient disponibles
Pour les développeurs
Une API pensée pour ne jamais encaisser deux fois.
Des appels simples, un environnement de test isolé et des garde-fous contre les doublons, à l'aller comme au retour.
- Une référence, une sessionRenvoyer la même merchant_reference renvoie la même session : une requête relancée ne crée pas de second paiement.
- Mode test completClés sk_test et cartes de test, sans argent réel. Les clés de production arrivent après la vérification de votre entreprise et ne s'affichent qu'une fois.
- Vos données vous suiventAjoutez vos propres champs à la session. Ils reviennent tels quels dans chaque webhook.
- Consulter, lister, annulerLisez une session et ses tentatives, listez vos paiements, annulez une session qui n'a pas été payée.
Webhook reçu par votre serveur
POST/webhooks/sollupay
X-Webhook-Signature: t=1795689840,v1=5257a869e7ecebeda32a…
{ "id": "evt_5f1c2a9d8e7b6a5f4e3d2c1b", "event": "session.succeeded", "livemode": true, "data": { "merchant_reference": "JW-2031", "amount": "184.500", "currency": "TND", "status": "SUCCEEDED", "payment": { "card_brand": "VISA", "card_last_four": "1119" }, "metadata": { "cart_id": "8812" } }}Webhooks
Le résultat de chaque paiement, signé et livré.
Validez vos commandes sur le webhook, pas sur le retour du navigateur : votre client peut fermer l'onglet avant d'être redirigé.
- Signature HMACChaque requête est signée avec votre secret. Vous vérifiez qu'elle vient bien de Sollupay et qu'elle est récente.
- Rotation du secretChangez de secret quand vous voulez : l'ancien reste valable 24 heures, le temps de mettre à jour votre serveur.
- 10 nouvelles tentativesSi votre serveur ne répond pas, Sollupay réessaie 10 fois sur environ 3 jours.
- Journal et renvoiRetrouvez chaque envoi dans votre tableau de bord et renvoyez un événement en un clic.
Sept événements
- session.succeededLe paiement est accepté. Validez la commande.
- session.attempt_failedUn essai est refusé. Votre client peut réessayer.
- session.failedTous les essais autorisés ont été refusés.
- session.expiredLa session n'a pas été payée dans les 24 heures environ.
- checkout.session.expiredUn lien de paiement a expiré. La session reste payable.
- refund.succeededLe remboursement est arrivé chez le client.
- refund.failedLe remboursement n'a pas abouti.
Remboursements
Rembourser un client, depuis l'API ou le tableau de bord.
Un remboursement total est accepté tout de suite. Un remboursement partiel l'est une fois le paiement réglé, en général le lendemain.
- Total ou partiel, en plusieurs fois jusqu'au montant payé
- Une clé Idempotency-Key pour relancer sans rembourser deux fois
- Les webhooks refund.succeeded et refund.failed suivent chaque remboursement
Rembourser · commande JW-2031
- Payé
- 184,500 TND
- Déjà remboursé
- 0,000 TND
Montant à rembourser
30,000 TND
Motif
Article endommagé
RembourserIntégrations
Branché sur les outils que vous utilisez déjà.
Des modules pour les principales plateformes e-commerce et d'hébergement arrivent bientôt. En attendant, connectez votre site avec l'API.
Prêt à encaisser en ligne ?
Créez votre compte, essayez tout en mode test, puis passez aux paiements réels une fois votre entreprise vérifiée.