CartDNA est Shopify Partenaire de développement d'applications de paiement

Logo CartDNA

API CartDNA

Utilisez l'API CartDNA pour vous authentifier en toute sécurité, créer des requêtes de paiement, contrôler la sélection des méthodes de paiement et maintenir vos systèmes à jour via des workflows callback. Conçu pour les équipes qui ont besoin d'une infrastructure de paiement flexible et d'un contrôle backend fiable.

Ce que l'API vous permet de faire

L'API CartDNA vous donne les actions essentielles nécessaires pour l'orchestration des paiements. Vous pouvez demander un token d'accès, soumettre des requêtes de paiement, définir les données client et commande, choisir les méthodes de paiement supportées et recevoir des mises à jour de statut via des URLs callback.

Capacités API clés

Authentification

Utilisez les identifiants clients pour demander un token d'accès, puis incluez ce token dans les requêtes autorisées.

Création de paiement

Créez des requêtes de paiement avec détails de commande, montant, devise, données client et sélection de méthode de paiement.

Contrôles de sécurité

Protégez chaque requête avec validation d'horodatage, clés d'idempotence et signatures de requête.

Flux de redirection client

Utilisez l'URL de paiement retournée pour envoyer les clients dans l'expérience de paiement.

Mises à jour pilotées par callback

Recevez les mises à jour de paiement dans votre backend pour que votre système de commande reste précis.

Conçu pour les flux de transaction réels

Les requêtes API CartDNA supportent les actions de transaction courantes telles que création de paiement et flux de type pré-autorisation, selon votre configuration commerçant. Cela donne aux développeurs de la flexibilité lors de la gestion des captures directes, paiements échelonnés ou logique checkout spécifique à la méthode.

Support de paiement local et global

La référence API publique montre le support pour plusieurs méthodes de paiement et devises, incluant cartes et méthodes locales sélectionnées. Cela donne aux commerçants plus de flexibilité lors de la vente sur différents marchés et aide les développeurs à construire des expériences de paiement qui correspondent aux attentes clients.

Exemples :

  • Cartes pour large couverture globale
  • Bancontact pour la Belgique
  • Boleto et Pix pour le Brésil
  • Klarna pour certains marchés internationaux
  • Przelewy24 pour la Pologne

La sécurité avant tout

CartDNA utilise une protection des requêtes en couches. Les tokens contrôlent l'accès API. Les horodatages aident à réduire les problèmes de replay. Les clés d'idempotence réduisent les doublons accidentels. Les signatures protègent les champs de paiement critiques contre les modifications. Cette structure est pratique pour les systèmes de production où la fiabilité des paiements compte.

Anticipez les états d'échec prévisibles

Votre intégration doit gérer les cas d'échec API courants tels que tokens invalides, requêtes expirées, requêtes en double et signatures invalides. Construisez des retrys clairs lorsque c'est sûr, journalisez le contexte des requêtes et affichez des messages d'erreur internes utiles aux équipes support.

Comment construire proprement

Gardez tous les secrets côté serveur

Utilisez des clés d'idempotence UUID

Standardisez les formats d'ID de commande

Journalisez les livraisons callback

Réconciliez les résultats de redirection avec le statut backend final

Séparez les identifiants sandbox et production

Testez la génération de signature avec des échantillons de payload fixes

Besoin de détails au niveau endpoint ?

Pour les en-têtes exacts, exemples de requêtes, champs de payload et formats de réponse, utilisez la référence API CartDNA complète.

Aller à la référence API