Wat u nodig hebt
| Veld | Wat het doet |
|---|---|
| API Login ID | Identificeert uw account bij API-aanroepen. Gekoppeld aan de Transaction Key. |
| Transaction Key | De geheime helft van de API-auth. Samen met de Login ID maakt het elk betaalformulier aan. Geheim. |
| Signature Key | Bevestigt dat een webhook echt van Authorize.Net kwam. Apart van de Transaction Key. Geheim. |
| Success-URL / Cancel-URL | Waar de koper belandt na het betalen of afhaken. |
De API Login ID en Transaction Key reizen altijd samen. De Signature Key staat los.
Waarom we om elk veld vragen
API Login ID
Benoemt uw account bij API-aanroepen. Het werkt alleen wanneer het is gekoppeld aan de Transaction Key.
Transaction Key
Het geheim dat bewijst dat een API-verzoek van u is. Samen met de API Login ID laat het ons het gehoste betaalformulier bouwen, zodat de afschrijving via uw account loopt.
Signature Key
Bewijst dat een inkomende webhook echt van Authorize.Net is, zodat niemand een "betaald"-event kan vervalsen. Het is een aparte waarde van de Transaction Key.
Success- en Cancel-URL
Gewone instellingen: waar de koper belandt na het betalen of afhaken. Niet geheim.
Instellen
- Maak een gratis sandbox-account aan (geen betaling)
U hebt geen betaald merchant-account nodig om te testen. Authorize.Net biedt een gratis sandbox die productie weerspiegelt, zonder creditcard vereist.
- Ga naar developer.authorize.net/hello_world/sandbox.html en meld u aan voor een sandbox-account. Gebruik die link, niet de hoofdaanmelding of prijspagina (dat is de betaalde live-aanvraag).
- Log in op de sandbox Merchant Interface op sandbox.authorize.net.
Het handtekeningschema is identiek aan productie, dus alles wat u in de sandbox verifieert, gedraagt zich live op dezelfde manier.
- Kopieer uw drie inloggegevens
Zelfde pad in zowel sandbox als live: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.
- API Login ID staat bovenaan getoond.
- Transaction Key: selecteer "New Transaction Key", bevestig, en kopieer hem meteen (hij wordt één keer getoond).
- Signature Key: selecteer "New Signature Key", bevestig, en kopieer hem meteen.
Account → Settings → Security Settings → API Credentials and Keys - Voeg de webhook toe
- Account → Settings → Business Settings → Webhooks, voeg een endpoint toe.
- Stel de endpoint-URL in op uw projectwebhook-adres (hieronder).
- Abonneer u op events. Eenmalige betalingen: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created, en de fraud.*-events (held, approved, declined). Abonnementen (Automated Recurring Billing): de net.authorize.customer.subscription.*-events. Verlengingen arriveren als authcapture.created, al gedekt. Extra events zijn onschadelijk.
- Sla op. Authorize.Net ondertekent elke levering met uw Signature Key.
https://api.coinmoebius.com/webhook/authorizenet/<your project id>Account → Settings → Business Settings → Webhooks Coin Moebius registreert elk event-id één keer en negeert duplicaten, dus opnieuw afgespeelde webhooks worden voor u afgehandeld.
- Test met sandbox-kaarten
Sandbox-kaarten belasten nooit een echte kaart. Gebruik een willekeurige toekomstige vervaldatum (bijvoorbeeld 12/2030) en een willekeurige CVV (3 cijfers, of 4 voor American Express).
Netwerk Kaart Visa 4111111111111111 Mastercard 5424000000000015 American Express 370000000000002 Discover 6011000000000012 - Verbind in het dashboard
Provider toevoegen → Authorize.Net. Voer Success-URL, Cancel-URL, en de Live-groep in (API Login ID, Transaction Key, Signature Key). Voeg de optionele Sandbox-groep toe om te testen. De Sandbox-groep is alles-of-niets: alle drie de velden, of geen. Live en sandbox worden apart gecontroleerd.
Nadat u verbindt
Voer één testbetaling uit voordat u live gaat:
- Maak een product aan en zet zijn Omgeving op Testing. Dat draait het product op uw sandbox-inloggegevens, zodat u een volledige bestelling kunt plaatsen zonder geld te verplaatsen. (Als u de sandbox-set oversloeg, valt een Testing-product terug op live, dus voeg hem eerst toe.)
- Plaats de buy button op een pagina (een lokaal HTML-bestand werkt) gericht op uw project.
- Rond de checkout af met een sandbox-testkaart van hierboven.
- Open het tabblad Transacties. Een nieuwe rij verschijnt, gemarkeerd als Testing. Wanneer zijn status succeeded bereikt, werken zowel uw inloggegevens als webhook end-to-end.
Zet de Omgeving van het product op Live wanneer u klaar bent voor echte betalingen.
Problemen oplossen
Begin met Verifiëren. Klik in het dashboard op Verifiëren (of Testinloggegevens verifiëren voor de sandbox-set) om uw API Login ID en Transaction Key te controleren.
Verifiëren mislukt.
De API Login ID en Transaction Key moeten het paar uit hetzelfde account zijn (live of sandbox). Kopieer beide opnieuw.
Handtekeningverificatie mislukt.
De Signature Key is een andere waarde dan de Transaction Key. Kopieer de Signature Key van hetzelfde scherm. Het schema is identiek in sandbox en live.
Betaling voltooit maar de bestelling blijft in behandeling.
Bevestig dat de webhook-URL exact overeenkomt en dat u zich op de betaalevents abonneerde.
Een testproduct belastte een live kaart.
Een product gemarkeerd als test valt terug op uw live inloggegevens wanneer er geen volledige sandbox-set is geconfigureerd. Voeg alle drie de sandbox-velden toe, of demarkeer het product als test.
Bevestig het end-to-end.
Authorize.Net pingt alleen inactieve webhooks: zet de endpoint inactief, stuur een ping, heractiveer hem dan, en kijk hoe de bestelling bijwerkt.
Goed om te weten
Tokens zijn kortlevend. Het token van het gehoste formulier duurt ongeveer 15 minuten. We maken er een verse per checkout aan.
Valuta. Authorize.Net is primair een Amerikaanse, USD-gateway. Niet-USD hangt af van uw verwerkersovereenkomst.
Sleutels roteren. Genereer wanneer u maar wilt een nieuwe Transaction Key of Signature Key, plak hem dan in. Geheime velden blijven leeg bij bewerken.
Vragen? Join our Discord