Home › Kennisbank › ViPayments
Hoe werken API-sleutels en testmodus in ViPayments?
Direct antwoord
Een gekoppelde webshop heeft twee sleutels: een API key-ID en een API secret. Testsleutels beginnen met vipk_test_ en live-sleutels met vipk_live_. De modus in de ViPayments-plugin in WooCommerce moet overeenkomen met het soort sleutel.
Wat heb je nodig?
- Toegang tot je ViPayments-dashboard
- Toegang tot het WordPress-dashboard van je webshop
- Een API key-ID. Heb je die nog niet, dan maak je hem aan in stap 2
- Een API secret. Dat maak je tegelijk met de API key-ID aan
- De juiste modus in de ViPayments-plugin: Testmodus aan bij testsleutels en uit bij live-sleutels
Stappenplan7 stappen
Wat zijn een API key-ID en een API secret?
De ViPayments-plugin is de uitbreiding in WordPress die je webshop aan ViPayments koppelt. API-sleutels zijn de codes waarmee de plugin verbinding maakt met je ViPayments-account.
Een gekoppelde webshop heeft twee sleutels: een API key-ID en een API secret. De twee horen bij elkaar. Het API secret is het geheime deel.
Het API secret is alleen zichtbaar bij het aanmaken en wordt maar één keer getoond. Je maakt je sleutels aan in je ViPayments-dashboard onder WooCommerce-koppeling.
Wat is het verschil tussen testsleutels en live-sleutels?
Met testsleutels test je de koppeling zonder echt geld. Met live-sleutels ontvang je echte betalingen.
In de ViPayments-plugin staat de instelling Testmodus. Die moet passen bij het soort sleutel.
| Soort sleutel | Begint met | Testmodus in de plugin | Waarvoor |
|---|---|---|---|
| Testsleutel | vipk_test_ | Aan | Testen zonder echt geld |
| Live-sleutel | vipk_live_ | Uit | Echte betalingen |
Past de sleutel niet bij de modus, dan toont de plugin een rode waarschuwing over test of live. Wil je overstappen van testen naar echte betalingen, lees dan hoe je live gaat met echte betalingen via ViPayments.
Zo pak je het aan 7 stappen
Stap 1: Open WooCommerce-koppeling
Log in op je ViPayments-dashboard via vipayments.vivortis.com en ga naar WooCommerce-koppeling.
Stap 2: Maak test- of live-sleutels aan
Maak testsleutels aan als je wilt testen. Maak live-sleutels aan als je echte betalingen wilt ontvangen.
Let op: maak je nieuwe sleutels aan voor een webshop die al sleutels heeft, dan stoppen de oude sleutels direct met werken.
Stap 3: Kopieer het API secret direct
Het API secret wordt maar één keer getoond. Kopieer het direct, samen met de API key-ID.
Stap 4: Open de ViPayments-plugin in WooCommerce
Log in op het WordPress-dashboard van je webshop. Ga naar WooCommerce > Instellingen, klik op het tabblad Betalingen en klik in de lijst met betaalmethodes op ViPayments.
Gebeurt er niets, klik dan op de knop die achter ViPayments staat, bijvoorbeeld Beheren. Staat ViPayments niet in de lijst, lees dan hoe je WooCommerce aan ViPayments koppelt.
Stap 5: Plak de sleutels in de plugin
Plak de API key-ID en het API secret in de velden voor de sleutels. Plak het API secret alleen in de ViPayments-plugin.
Stap 6: Kies de juiste modus
Gebruik je sleutels die beginnen met vipk_test_, zet Testmodus dan aan. Gebruik je sleutels die beginnen met vipk_live_, zet Testmodus dan uit.
Klik daarna op Opslaan.
Stap 7: Test de verbinding
Klik in de plugin op Test verbinding.
Controleer of het gelukt is
Na een klik op Test verbinding zie je direct of de sleutels geldig zijn en of de modus klopt.
Werkt het niet?
Je ziet een rode waarschuwing over test of live
De sleutel past niet bij de modus. Zet Testmodus goed, of maak sleutels van het juiste soort aan.
Krijg je de waarschuwing niet weg, dien dan een ticket in bij de helpdesk van ViVortis en voeg waar mogelijk een screenshot toe.
Je bent je API secret kwijt
Maak nieuwe sleutels aan onder WooCommerce-koppeling. Het oude secret wordt ongeldig.
Betalingen starten niet meer nadat je nieuwe sleutels hebt aangemaakt
Vul de nieuwe sleutels direct in de plugin in en klik op Opslaan.
Veelgestelde vragen
Waar vind ik mijn sleutels?
Je vindt ze in je ViPayments-dashboard onder WooCommerce-koppeling. Het API secret is alleen zichtbaar bij het aanmaken.
Wat gebeurt er als ik nieuwe sleutels genereer?
De oude sleutels stoppen direct met werken. Vul de nieuwe sleutels meteen in WooCommerce in.
Kan iemand met alleen mijn key-ID iets doen?
Nee. Zonder het bijbehorende API secret is de key-ID niet bruikbaar.
Wanneer moet ik mijn sleutels vervangen?
Vervang ze direct als je vermoedt dat het API secret is gelekt. Bijvoorbeeld na een beveiligingsincident of als het per ongeluk is gedeeld.
Hulp nodig?
Schakel de helpdesk van ViVortis in als:
- je niet weet welke modus actief is
- de testverbinding blijft mislukken
- je vermoedt dat een secret is gelekt
- betalingen niet meer starten nadat je nieuwe sleutels hebt aangemaakt
- je de rode waarschuwing niet kunt oplossen
Dien een ticket in via de helpdesk van ViVortis en voeg waar mogelijk een screenshot toe.
Lukt het niet?
Dien een ticket in met een screenshot van wat je ziet. De helpdesk reageert meestal binnen één werkdag.