Skip to main content
De Stripe-integratie van Macaly stelt u in staat om eenmalige en terugkerende betalingen (abonnementen) rechtstreeks in uw project te accepteren. Een volledig functionele testomgeving wordt automatisch aangemaakt, zodat u kunt beginnen met bouwen en testen zonder een Stripe-account. Wanneer u klaar bent om live te gaan, koppelt u uw Stripe-account en schakelt u over naar de live-modus.
Beschikbaar in de pakketten Pro en Bureaus

​
Betalingen toevoegen aan uw project

Beschrijf uw betalingsbehoeften aan de agent in de chat. Bijvoorbeeld:
De agent maakt uw project aan met een compleet betalingsproces en richt op de achtergrond een Stripe-testomgeving in. Zodra de configuratie is voltooid, verschijnt er een tabblad Betalingen in het project. U kunt direct beginnen met testen met de testkaart die wordt weergegeven in het tabblad Betalingen: Ga naar uw project, voer een testaankoop uit en controleer de betaalervaring.
We raden aan het volledige afrekenproces minstens één keer te doorlopen voordat u live gaat. Controleer de succespagina, foutafhandeling en mobiele responsiviteit.

​
Echte betalingen accepteren

Om echte transacties te verwerken, moet u twee stappen voltooien: uw Stripe-sandbox claimen en uw live API-sleutels invoeren. Beide worden afgehandeld vanuit het tabblad Betalingen.

​
Uw Stripe-sandbox claimen

Wanneer Macaly een testomgeving aanmaakt, creëert het een Stripe-sandbox die nog niet aan een account is gekoppeld. Door deze te claimen koppelt u de sandbox aan uw Stripe-account, zodat u echte uitbetalingen kunt ontvangen.
1

Open het tabblad Betalingen

Open het tabblad Betalingen in uw project. Onder “Activeer uw beveiligde testomgeving” ziet u een knop Claim uw Stripe-sandbox.
2

Klik op Claim uw Stripe-sandbox

Stripe opent in een nieuw tabblad met de pagina Claim uw sandbox.Als u een bestaand Stripe-account hebt, selecteer het dan uit de lijst. Klik anders op + Nieuw account aanmaken om er gratis een aan te maken.Klik op Doorgaan om verder te gaan.
3

Vul uw bedrijfsgegevens in

Stripe vraagt om enkele basisgegevens:
  1. Bedrijfsnaam en locatie. Voer uw bedrijfsnaam in en selecteer uw land. Klik op Doorgaan.
  2. Bedrijfswebsite en beschrijving. Geef uw website-URL op en een korte beschrijving van uw producten of diensten. Deze stap kan worden overgeslagen door te klikken op Nu overslaan.
  3. Beoogd gebruik van Stripe. Selecteer de betalingstypen die relevant zijn voor uw bedrijf (bijv. eenmalige of terugkerende betalingen). Deze stap kan ook worden overgeslagen.
4

Voltooi de sandbox-configuratie

Op het laatste scherm presenteert Stripe een samenvatting van de volgende stappen: uw configuratie voltooien, overschakelen naar de live-modus en betalingen accepteren. Klik op Ga naar sandbox om af te ronden.
5

Keer terug naar Macaly

Ga terug naar Macaly. Het tabblad Betalingen zou nu Betalingen staan in testmodus in oranje moeten weergeven, wat bevestigt dat het claimen is gelukt.
Statusupdates kunnen even duren. Als de claimknop nog steeds zichtbaar is, vernieuw dan de pagina.

​
Live gaan

Wanneer u klaar bent om echte betalingen te accepteren, moet u uw Stripe-account activeren en uw live API-sleutels koppelen aan Macaly.

​
Uw Stripe-account activeren

Voordat u toegang krijgt tot live API-sleutels, vereist Stripe dat u uw bedrijf verifieert. Dit is een standaard onboardingproces dat volledig aan de Stripe-kant plaatsvindt.
1

Open het Stripe Dashboard

Ga naar dashboard.stripe.com en log in met het account waarmee u de sandbox hebt geclaimd.
2

Voltooi de configuratiegids

Stripe zal u vragen uw accountconfiguratie te voltooien. Dit omvat doorgaans:
  • Bedrijfsgegevens (officiële naam, adres, type bedrijf)
  • Persoonlijke identiteitsverificatie
  • Bankrekening of uitbetalingsgegevens voor het ontvangen van geld
Volg de configuratiegids van Stripe totdat alle stappen als voltooid zijn gemarkeerd.
3

Wacht op verificatie

Stripe beoordeelt uw informatie en activeert uw account. Dit is meestal direct, maar kan enkele dagen duren afhankelijk van uw land en bedrijfstype.Na verificatie is uw account actief en zijn uw live API-sleutels beschikbaar in het Dashboard.
U kunt doorgaan met het bouwen en testen van uw project in testmodus terwijl u wacht op de verificatie door Stripe.

​
Uw live API-sleutels invoeren

Zodra uw Stripe-account is geverifieerd, kopieert u uw live-sleutels naar Macaly.
1

Kopieer uw sleutels uit het Stripe Dashboard

In het Stripe Dashboard worden uw API-sleutels weergegeven in de kaart API-sleutels aan de rechterkant van de startpagina. U kunt ze ook vinden onder Ontwikkelaars → API-sleutels onderaan de zijbalk.U ziet twee sleutels:
  • Publiceerbare sleutel begint met pk_live_.
  • Geheime sleutel begint met sk_live_.
Kopieer beide sleutels.
Uw geheime sleutel geeft volledige toegang tot uw Stripe-account. Deel deze nooit en plak deze nooit in de chat.
2

Voeg uw sleutels toe in Macaly

Klik in het tabblad Betalingen op Stripe-verbinding toevoegen. Plak elke sleutel in het bijbehorende veld en klik op API-sleutels opslaan.
3

Schakel over naar de live-modus

Klik op Overschakelen naar Live-modus. Macaly configureert uw project opnieuw om uw live Stripe-account te gebruiken. De status wordt bijgewerkt naar Betalingen zijn live in groen.
4

Publiceer uw project

Publiceer uw project om de wijzigingen te implementeren. Live betalingen worden alleen verwerkt op de gepubliceerde site, niet in de voorvertoning.

​
Uw integratie beheren

Alle betalingsinstellingen zijn toegankelijk vanuit het tabblad Betalingen:
  • Stripe openen opent het Stripe Dashboard waar u transacties kunt bekijken, terugbetalingen kunt doen en uitbetalingen kunt volgen.
  • Overschakelen naar Live-modus / Overschakelen naar testmodus stelt u in staat om op elk moment tussen omgevingen te wisselen zonder uw projectcode te beïnvloeden.
  • Stripe-verbinding beheren stelt u in staat uw live API-sleutels bij te werken na de initiële configuratie.
  • Testbetalingen toont de testkaartgegevens ter referentie in testmodus.

​
Probleemoplossing

Een sandbox is een tijdelijke testomgeving die Macaly voor u aanmaakt. Deze wordt geleverd met eigen test-API-sleutels en stelt u in staat betalingen te simuleren zonder echt geld aan te raken. Het is niet uw Stripe-account. Wanneer u de sandbox claimt, koppelt u deze aan uw daadwerkelijke Stripe-account. Zolang u deze niet claimt, is de sandbox anoniem en verloopt na 60 dagen.
Zorg ervoor dat u het testkaartnummer 4242 4242 4242 4242 gebruikt met een toekomstige vervaldatum, een willekeurige 3-cijferige CVC en een willekeurige postcode. Als het probleem aanhoudt, bekijk de chat voor foutdetails of vraag de agent om het betalingsproces te diagnosticeren.
Testmodus gebruikt de sandbox-omgeving met testsleutels. Alle betalingen worden gesimuleerd en er is geen echt geld bij betrokken. Live-modus gebruikt uw geverifieerde Stripe-account met live-sleutels. Er wordt echt geld in rekening gebracht en op uw bankrekening gestort. U kunt op elk moment wisselen tussen modi in het tabblad Betalingen. Het wisselen van modus heeft geen invloed op uw projectcode, alleen op welke Stripe-sleutels actief zijn.
De sandbox claimen en uw Stripe-account verifiëren zijn twee afzonderlijke stappen. Het claimen koppelt de sandbox aan uw account, maar u moet nog steeds de bedrijfsverificatie van Stripe voltooien (identiteit, bedrijfsgegevens, bankrekening) voordat live-sleutels worden gegenereerd. Open het Stripe Dashboard en volg de configuratiegids om de verificatie af te ronden. Als u alleen testsleutels ziet (beginnend met pk_test_ en sk_test_), is uw account nog niet volledig geverifieerd.
Het verifiëren van uw Stripe-account schakelt Macaly niet automatisch over naar de live-modus. U moet handmatig uw live API-sleutels invoeren in het tabblad Betalingen en vervolgens op Overschakelen naar Live-modus klikken. Macaly houdt u in testmodus totdat u expliciet overschakelt.
Controleer drie dingen in volgorde:
  1. Hebt u uw project gepubliceerd? Live betalingen worden alleen verwerkt op de gepubliceerde site, niet in de voorvertoning.
  2. Zijn uw sleutels correct? Controleer of u uw publiceerbare sleutel (beginnend met pk_live_) en geheime sleutel (beginnend met sk_live_) hebt ingevoerd. Als u per ongeluk testsleutels hebt geplakt, klik dan op Stripe-verbinding beheren en werk ze bij.
  3. Is uw Stripe-account volledig geverifieerd? Open het Stripe Dashboard en controleer op openstaande stappen in de configuratiegids. Stripe kan aanvullende documenten vereisen voordat live betalingen worden verwerkt.
Niet-geclaimde sandboxes verlopen na 60 dagen. Open het tabblad Betalingen en klik op Nieuwe sandbox instellen om een nieuwe omgeving aan te maken. Uw bestaande betalingscode blijft ongewijzigd. Als u uw Stripe-account al had geclaimd en geverifieerd, moet u uw live-sleutels opnieuw invoeren na het aanmaken van een nieuwe sandbox.

​
Goed om te weten

  • Stripe-kosten zijn van toepassing. Macaly brengt geen extra kosten in rekening voor betalingen. Standaard Stripe-verwerkingskosten zijn van toepassing op elke transactie (zie stripe.com/pricing).
  • Sandbox-verloop. Niet-geclaimde testomgevingen verlopen na 60 dagen. Als dit gebeurt, open het tabblad Betalingen en klik op Nieuwe sandbox instellen om een nieuwe aan te maken.
  • Webhooks worden automatisch beheerd. Macaly configureert en onderhoudt alle webhook-endpoints. Geen handmatige configuratie is vereist in het Stripe Dashboard.
  • Test- en live-omgevingen zijn geïsoleerd. Testtransacties verschijnen niet in uw live Stripe-account en er worden geen echte kosten in rekening gebracht.