Vous pouvez commencer sans site Web ni développeur, et passer à l'API plus tard sans changer de compte ni présenter une nouvelle demande. Chaque itinéraire ci-dessous utilise la même caisse hébergée, le même tableau de bord et les mêmes paiements.
Liens de paiement
Créez un lien dans votre tableau de bord et partagez-le par email, WhatsApp, un message ou une publication. Le client paie sur la page de paiement sécurisée et le paiement apparaît dans votre tableau de bord avec son nom, son adresse e-mail et son numéro de mobile.
Rien à installer et aucun code. Un lien vers un produit récurrent démarre un abonnement au lieu d'un paiement unique, et la page de paiement affiche les conditions de renouvellement avant que le client ne paie.
Séances de paiement hébergées
Votre serveur crée une session de paiement avec ce que le client achète, puis l'envoie à l'adresse de la session. Ils paient sur la page hébergée et reviennent à une adresse de retour que vous choisissez.
Une séance est valable 24 heures. Un webhook signé indique le résultat à votre serveur, afin que vous puissiez valider la commande même si le client ne revient jamais sur votre site.
L'API REST
JSON sur HTTPS sur utopia-payments.com/api/v1, avec une clé secrète que vous créez dans Tableau de bord → Développeurs. Les ressources sont les produits, les clients, les sessions de paiement, les paiements, les abonnements, les points de terminaison du webhook, les événements et votre propre compte.
- Les montants sont des unités mineures entières : 34 900 correspond à 349,00 AED.
- Les listes sont paginées avec un curseur, de sorte qu'un long historique se lit dans l'ordre sans interruption.
- Un POST avec une clé d'idempotence relit sa première réponse pendant 24 heures, donc une nouvelle tentative après un délai d'attente ne peut pas facturer deux fois.
- Les clés sont limitées à 240 requêtes par minute.
Les clés de test peuvent aujourd'hui créer des produits et des clients, mais une vérification de test hébergée nécessite des informations d'identification sandbox qui ne sont pas encore activées et il n'y a pas de numéros de carte de test. En attendant, essayez le flux avec une clé réelle et un petit paiement réel – jamais avec les détails de la carte de quelqu'un en remplacement.
Bibliothèques de nœuds et PHP
Les deux bibliothèques couvrent la même API, contiennent des ressources typées et vérifient les signatures des webhooks pour vous en un seul appel.
npm install @utopia-payments/nodecomposer require utopia-payments/utopia-phpWooCommerce
Un plugin WordPress ajoute Utopia comme mode de paiement lors du paiement WooCommerce : l'acheteur paie sur la page hébergée et la commande est marquée comme payée depuis le webhook plutôt que depuis le navigateur du client.
Téléchargez le zip à partir de la documentation et installez-le sous Plugins → Ajouter un nouveau → Télécharger le plugin. Il n'est pas encore répertorié sur WordPress.org, il se met donc à jour en remplaçant le zip.
Il n’existe pas encore d’application Shopify native. Les magasins Shopify utilisent un lien de paiement Utopia ainsi qu'un mode de paiement manuel jusqu'à ce qu'il y en ait un.
Documentation
Vous ne savez pas quel itinéraire vous convient ? Décrivez votre configuration à sales@utopia-payments.com.