Authorize.Net

Τι χρειάζεστε

Το API Login ID και το Transaction Key πάνε πάντα μαζί. Το Signature Key είναι ανεξάρτητο.

Γιατί ζητάμε κάθε πεδίο

API Login ID

Δίνει όνομα στον λογαριασμό σας στις κλήσεις API. Λειτουργεί μόνο όταν συνδυάζεται με το Transaction Key.

Transaction Key

Το μυστικό που αποδεικνύει ότι ένα αίτημα API είναι δικό σας. Μαζί με το API Login ID, μας επιτρέπει να φτιάξουμε τη φιλοξενούμενη φόρμα πληρωμής, ώστε η χρέωση να περάσει μέσα από τον λογαριασμό σας.

Signature Key

Αποδεικνύει ότι ένα εισερχόμενο webhook προέρχεται πραγματικά από το Authorize.Net, ώστε κανείς να μην μπορεί να πλαστογραφήσει ένα συμβάν "paid". Είναι ξεχωριστή τιμή από το Transaction Key.

Success and Cancel URL

Απλές ρυθμίσεις: πού καταλήγει ο αγοραστής αφού πληρώσει ή υπαναχωρήσει. Δεν είναι μυστικό.

Ρύθμιση

1. Δημιουργήστε έναν δωρεάν λογαριασμό sandbox (χωρίς πληρωμή)

   Δεν χρειάζεστε επί πληρωμή merchant account για να δοκιμάσετε. Το Authorize.Net προσφέρει ένα δωρεάν sandbox που αντικατοπτρίζει την παραγωγή, χωρίς να απαιτείται πιστωτική κάρτα.

   1. Πηγαίνετε στο developer.authorize.net/hello_world/sandbox.html και εγγραφείτε για έναν λογαριασμό sandbox. Χρησιμοποιήστε αυτόν τον σύνδεσμο, όχι την κύρια σελίδα εγγραφής ή τιμολόγησης (που είναι η επί πληρωμή live αίτηση).
   2. Συνδεθείτε στο Merchant Interface του sandbox στο sandbox.authorize.net.

   Το σχήμα υπογραφής είναι πανομοιότυπο με την παραγωγή, οπότε ό,τι επαληθεύσετε στο sandbox συμπεριφέρεται με τον ίδιο τρόπο και live.

2. Αντιγράψτε τα τρία διαπιστευτήριά σας

   Ίδια διαδρομή τόσο σε sandbox όσο και σε live: Account → Settings → Security Settings → General Security Settings → API Credentials and Keys.

   • Το API Login ID εμφανίζεται στην κορυφή.
   • Transaction Key: επιλέξτε "New Transaction Key", επιβεβαιώστε, και αντιγράψτε το αμέσως (εμφανίζεται μία φορά).
   • Signature Key: επιλέξτε "New Signature Key", επιβεβαιώστε, και αντιγράψτε το αμέσως.

   ⤢
3. Προσθέστε το webhook
   1. Account → Settings → Business Settings → Webhooks, προσθέστε ένα endpoint.
   2. Ορίστε το endpoint URL στη διεύθυνση webhook του έργου σας (παρακάτω).
   3. Εγγραφείτε σε συμβάντα. Εφάπαξ πληρωμές: net.authorize.payment.authorization.created, authcapture.created, capture.created, priorAuthCapture.created, refund.created, void.created, και τα συμβάντα fraud.* (held, approved, declined). Συνδρομές (Automated Recurring Billing): τα συμβάντα net.authorize.customer.subscription.*. Οι ανανεώσεις φτάνουν ως authcapture.created, ήδη καλυμμένο. Τα επιπλέον συμβάντα είναι ακίνδυνα.
   4. Αποθηκεύστε. Το Authorize.Net υπογράφει κάθε παράδοση με το Signature Key σας.

   https://api.coinmoebius.com/webhook/authorizenet/<your project id>

   ⤢

   Το Coin Moebius καταγράφει κάθε event id μία φορά και αγνοεί τα διπλότυπα, ώστε τα επαναλαμβανόμενα webhooks να αντιμετωπίζονται για εσάς.

4. Δοκιμάστε με κάρτες sandbox

   Οι κάρτες sandbox δεν χρεώνουν ποτέ πραγματική κάρτα. Χρησιμοποιήστε οποιαδήποτε μελλοντική λήξη (για παράδειγμα 12/2030) και οποιοδήποτε CVV (3 ψηφία, ή 4 για American Express).

   Δίκτυο	Κάρτα
   Visa	4111111111111111
   Mastercard	5424000000000015
   American Express	370000000000002
   Discover	6011000000000012

5. Συνδέστε στον πίνακα ελέγχου

   Add provider → Authorize.Net. Εισαγάγετε Success URL, Cancel URL, και την ομάδα Live (API Login ID, Transaction Key, Signature Key). Προσθέστε την προαιρετική ομάδα Sandbox για δοκιμή. Η ομάδα Sandbox είναι όλα ή τίποτα: και τα τρία πεδία, ή κανένα. Το live και το sandbox ελέγχονται ξεχωριστά.

Αφού συνδεθείτε

Κάντε μία δοκιμαστική πληρωμή πριν βγείτε live:

1. Δημιουργήστε ένα προϊόν και ορίστε το Environment του σε Testing. Αυτό τρέχει το προϊόν στα διαπιστευτήρια sandbox σας, ώστε να κάνετε μια πλήρη παραγγελία χωρίς να κινηθούν χρήματα. (Αν παραλείψατε το σύνολο sandbox, ένα προϊόν Testing επιστρέφει στο live, οπότε προσθέστε το πρώτα.)
2. Τοποθετήστε το κουμπί αγοράς σε μια σελίδα (ένα τοπικό αρχείο HTML λειτουργεί) που δείχνει στο έργο σας.
3. Ολοκληρώστε το checkout με μια κάρτα δοκιμής sandbox από πάνω.
4. Ανοίξτε την καρτέλα Transactions. Μια νέα γραμμή εμφανίζεται, με ετικέτα Testing. Όταν η κατάστασή της φτάσει στο succeeded, τα διαπιστευτήριά σας και το webhook λειτουργούν και τα δύο από άκρη σε άκρη.

Αλλάξτε το Environment του προϊόντος σε Live όταν είστε έτοιμοι για πραγματικές πληρωμές.

Αντιμετώπιση προβλημάτων

Ξεκινήστε με το Verify. Στον πίνακα ελέγχου, κάντε κλικ στο Verify (ή Verify test credentials για το σύνολο sandbox) για να ελέγξετε το API Login ID και το Transaction Key σας.

Το Verify αποτυγχάνει.

Το API Login ID και το Transaction Key πρέπει να είναι το ζεύγος από τον ίδιο λογαριασμό (live ή sandbox). Αντιγράψτε ξανά και τα δύο.

Η επαλήθευση υπογραφής αποτυγχάνει.

Το Signature Key είναι διαφορετική τιμή από το Transaction Key. Αντιγράψτε το Signature Key από την ίδια οθόνη. Το σχήμα είναι πανομοιότυπο σε sandbox και live.

Η πληρωμή ολοκληρώνεται αλλά η παραγγελία μένει σε εκκρεμότητα.

Επιβεβαιώστε ότι το webhook URL ταιριάζει ακριβώς και ότι εγγραφήκατε στα συμβάντα πληρωμής.

Ένα προϊόν δοκιμής χρέωσε μια live κάρτα.

Ένα προϊόν σημειωμένο ως δοκιμαστικό επιστρέφει στα live διαπιστευτήριά σας όταν δεν έχει ρυθμιστεί πλήρες σύνολο sandbox. Προσθέστε και τα τρία πεδία sandbox, ή ξεσημειώστε το προϊόν ως δοκιμαστικό.

Επιβεβαιώστε το από άκρη σε άκρη.

Το Authorize.Net κάνει ping μόνο σε ανενεργά webhooks: ορίστε το endpoint ανενεργό, στείλτε ένα ping, μετά ενεργοποιήστε το ξανά, και παρακολουθήστε την παραγγελία να ενημερώνεται.

Καλό να γνωρίζετε

Τα tokens είναι βραχύβια. Το token της φιλοξενούμενης φόρμας διαρκεί περίπου 15 λεπτά. Δημιουργούμε ένα φρέσκο ανά checkout.

Νόμισμα. Το Authorize.Net είναι κατά κύριο λόγο μια πύλη ΗΠΑ, USD. Τα μη-USD εξαρτώνται από τη συμφωνία με τον επεξεργαστή σας.

Εναλλαγή κλειδιών. Δημιουργήστε ένα νέο Transaction Key ή Signature Key οποτεδήποτε, μετά επικολλήστε το. Τα μυστικά πεδία μένουν κενά κατά την επεξεργασία.

Ερωτήσεις; Join our Discord