API publique

L'API publique Switag permettra à vos applications de se connecter à Switag. Elle est en cours de préparation : cette page présente ce qui est prévu et sera complétée au fur et à mesure de sa mise à disposition.

Pas encore disponible

Aucune route n'est ouverte aux partenaires pour le moment. Les anciennes pages « Switag Business » (charges, abonnements, versements, facturiers) ont été retirées : elles décrivaient une version précédente de la plateforme.

Ce qui est prévu#

Clés API pour les échanges de serveur à serveur. Une clé ne doit jamais être exposée dans une application web ou mobile.
OAuth pour les applications partenaires qui agissent pour le compte d'un marchand.
Webhooks signés pour recevoir les événements, par exemple payment.success, payment.failed, payment.refunded, invoice.certified ou stock.low. Leur traitement doit être idempotent : un même événement peut être reçu plusieurs fois.
Environnement de test avec des paiements simulés, distinct de la production.

Conventions#

Les montants sont des entiers dans la plus petite unité de la devise, avec la devise associée (par exemple 5000 et XOF), jamais des nombres à virgule.
Un paiement n'est confirmé qu'après la réponse de l'opérateur.

Être prévenu#

Écrivez à it@switag.com pour suivre l'ouverture de l'API ou présenter votre projet d'intégration.