Ce dont vous avez besoin
| Champ | Ce qu'il fait |
|---|---|
| API Login ID | Identifie votre compte sur les appels API. Couplé à la Transaction Key. |
| Transaction Key | La moitié secrète de l'authentification API. Avec le Login ID, elle génère chaque formulaire de paiement. Secrète. |
| Signature Key | Confirme qu'un webhook vient vraiment d'Authorize.Net. Distincte de la Transaction Key. Secrète. |
| URL de réussite / URL d'annulation | Où l'acheteur atterrit après avoir payé ou renoncé. |
L'API Login ID et la Transaction Key vont toujours de pair. La Signature Key est indépendante.
Pourquoi nous demandons chaque champ
API Login ID
Nomme votre compte sur les appels API. Ne fonctionne que couplé à la Transaction Key.
Transaction Key
Le secret qui prouve qu'une requête API est la vôtre. Avec l'API Login ID, elle nous permet de construire le formulaire de paiement hébergé, pour que le débit passe par votre compte.
Signature Key
Prouve qu'un webhook entrant provient bien d'Authorize.Net, pour que personne ne puisse falsifier un événement « payé ». C'est une valeur distincte de la Transaction Key.
URL de réussite et d'annulation
Réglages simples : où l'acheteur atterrit après avoir payé ou renoncé. Pas secret.
Configuration
- Créez un compte sandbox gratuit (sans paiement)
Vous n'avez pas besoin d'un compte marchand payant pour tester. Authorize.Net offre un sandbox gratuit qui reflète la production, sans carte de crédit requise.
- Allez sur developer.authorize.net/hello_world/sandbox.html et inscrivez-vous pour un compte sandbox. Utilisez ce lien, pas l'inscription principale ni la page de tarifs (qui est la candidature live payante).
- Connectez-vous au Merchant Interface du sandbox sur sandbox.authorize.net.
Le schéma de signature est identique à la production, donc tout ce que vous vérifiez dans le sandbox se comporte de la même façon en live.
- Copiez vos trois identifiants
Même chemin en sandbox et en live : Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.
- L'API Login ID est affiché en haut.
- Transaction Key : sélectionnez « New Transaction Key », confirmez, et copiez-la immédiatement (elle n'est affichée qu'une fois).
- Signature Key : sélectionnez « New Signature Key », confirmez, et copiez-la aussitôt.
Account → Settings → Security Settings → API Credentials and Keys - Ajoutez le webhook
- Account → Settings → Business Settings → Webhooks, ajoutez un endpoint.
- Réglez l'URL de l'endpoint sur l'adresse de webhook de votre projet (ci-dessous).
- Abonnez-vous aux événements. Paiements uniques : net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created, et les événements fraud.* (held, approved, declined). Abonnements (Automated Recurring Billing) : les événements net.authorize.customer.subscription.*. Les renouvellements arrivent en authcapture.created, déjà couvert. Les événements en plus sont sans danger.
- Enregistrez. Authorize.Net signe chaque livraison avec votre Signature Key.
https://api.coinmoebius.com/webhook/authorizenet/<your project id>Account → Settings → Business Settings → Webhooks Coin Moebius enregistre chaque identifiant d'événement une fois et ignore les doublons, donc les webhooks rejoués sont gérés pour vous.
- Testez avec des cartes sandbox
Les cartes sandbox ne débitent jamais une vraie carte. Utilisez n'importe quelle date d'expiration future (par exemple 12/2030) et n'importe quel CVV (3 chiffres, ou 4 pour American Express).
Réseau Carte Visa 4111111111111111 Mastercard 5424000000000015 American Express 370000000000002 Discover 6011000000000012 - Connectez dans le tableau de bord
Add provider → Authorize.Net. Saisissez l'URL de réussite, l'URL d'annulation, et le groupe Live (API Login ID, Transaction Key, Signature Key). Ajoutez le groupe Sandbox optionnel pour tester. Le groupe Sandbox est tout-ou-rien : les trois champs, ou aucun. Live et sandbox sont vérifiés séparément.
Après la connexion
Faites un paiement de test avant de passer en live :
- Créez un produit et réglez son Environnement sur Testing. Cela fait tourner le produit sur vos identifiants sandbox, pour que vous puissiez passer une commande complète sans déplacer d'argent. (Si vous avez sauté le jeu sandbox, un produit Testing retombe sur le live, donc ajoutez-le d'abord.)
- Placez le bouton d'achat sur une page (un fichier HTML local convient) pointé vers votre projet.
- Finalisez le paiement avec une carte de test sandbox ci-dessus.
- Ouvrez l'onglet Transactions. Une nouvelle ligne apparaît, étiquetée Testing. Quand son statut atteint succeeded, vos identifiants et votre webhook fonctionnent tous deux de bout en bout.
Basculez l'Environnement du produit sur Live quand vous êtes prêt pour de vrais paiements.
Dépannage
Commencez par Vérifier. Dans le tableau de bord, cliquez sur Vérifier (ou Vérifier les identifiants de test pour le jeu sandbox) pour contrôler votre API Login ID et votre Transaction Key.
La vérification échoue.
L'API Login ID et la Transaction Key doivent être la paire du même compte (live ou sandbox). Recopiez les deux.
La vérification de signature échoue.
La Signature Key est une valeur différente de la Transaction Key. Copiez la Signature Key depuis le même écran. Le schéma est identique en sandbox et en live.
Le paiement se finalise mais la commande reste en attente.
Confirmez que l'URL du webhook correspond exactement et que vous vous êtes abonné aux événements de paiement.
Un produit de test a débité une carte live.
Un produit marqué comme test retombe sur vos identifiants live quand aucun jeu sandbox complet n'est configuré. Ajoutez les trois champs sandbox, ou retirez la marque test du produit.
Confirmez de bout en bout.
Authorize.Net ne ping que les webhooks inactifs : réglez l'endpoint sur inactif, envoyez un ping, puis réactivez-le, et observez la commande se mettre à jour.
Bon à savoir
Les jetons sont de courte durée. Le jeton du formulaire hébergé dure environ 15 minutes. Nous en générons un nouveau à chaque paiement.
Devise. Authorize.Net est principalement une passerelle américaine, USD. Le hors-USD dépend de votre accord de processeur.
Rotation des clés. Générez une nouvelle Transaction Key ou Signature Key à tout moment, puis collez-la. Les champs secrets restent vides à la modification.
Des questions ? Join our Discord