> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe-integratie

> Accepteer betalingen in uw Macaly-project

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.

<Callout icon="user">
  Beschikbaar in de [**pakketten Pro en Bureaus**](/docs/nl/welcome/pricing)
</Callout>

## Betalingen toevoegen aan uw project

Beschrijf uw betalingsbehoeften aan de agent in de chat. Bijvoorbeeld:

```
Ik wil mijn huidverzorgingsproducten online verkopen. Ik heb een winkel
nodig met een catalogus en afrekenen zodat klanten met een kaart kunnen betalen.
```

```
Ik heb een e-book geschreven en wil het verkopen voor $19. Maak een pagina
waar mensen kunnen betalen en het direct downloaden.
```

```
Ik start een maandelijkse online yogales voor € 29 per maand. Maak een
landingspagina waar leden zich kunnen aanmelden en hun abonnement kunnen starten.
```

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:

| Veld        | Waarde                               |
| ----------- | ------------------------------------ |
| Kaartnummer | 4242 4242 4242 4242                  |
| Vervaldatum | Elke toekomstige datum (bijv. 01/30) |
| CVC         | 3 willekeurige cijfers (bijv. 111)   |
| Postcode    | Elke waarde (bijv. 11000)            |

Ga naar uw project, voer een testaankoop uit en controleer de betaalervaring.

<Tip>
  We raden aan het volledige afrekenproces minstens één keer te doorlopen voordat u live gaat. Controleer de succespagina, foutafhandeling en mobiele responsiviteit.
</Tip>

## 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.

<iframe src="https://www.youtube.com/embed/GamiyPgFbuU" />

<Steps>
  <Step title="Open het tabblad Betalingen">
    Open het tabblad **Betalingen** in uw project. Onder "Activeer uw beveiligde testomgeving" ziet u een knop **Claim uw Stripe-sandbox**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Info>
      Statusupdates kunnen even duren. Als de claimknop nog steeds zichtbaar is, vernieuw dan de pagina.
    </Info>
  </Step>
</Steps>

### 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.

<Steps>
  <Step title="Open het Stripe Dashboard">
    Ga naar [dashboard.stripe.com](https://dashboard.stripe.com) en log in met het account waarmee u de sandbox hebt geclaimd.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Info>
  U kunt doorgaan met het bouwen en testen van uw project in testmodus terwijl u wacht op de verificatie door Stripe.
</Info>

#### Uw live API-sleutels invoeren

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

<Steps>
  <Step title="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.

    <Warning>
      Uw geheime sleutel geeft volledige toegang tot uw Stripe-account. Deel deze nooit en plak deze nooit in de chat.
    </Warning>
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Publiceer uw project">
    Publiceer uw project om de wijzigingen te implementeren. Live betalingen worden alleen verwerkt op de gepubliceerde site, niet in de voorvertoning.
  </Step>
</Steps>

## 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

<AccordionGroup>
  <Accordion title="Wat is een sandbox en hoe verschilt het van mijn Stripe-account?">
    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.
  </Accordion>

  <Accordion title="Testbetalingen werken niet">
    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.
  </Accordion>

  <Accordion title="Wat is het verschil tussen testmodus en live-modus?">
    **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.
  </Accordion>

  <Accordion title="Ik kan geen live API-sleutels vinden in mijn Stripe Dashboard">
    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.
  </Accordion>

  <Accordion title="Macaly toont nog steeds testmodus nadat ik mijn Stripe-account heb 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.
  </Accordion>

  <Accordion title="Live betalingen werken niet">
    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.
  </Accordion>

  <Accordion title="Wat gebeurt er als mijn sandbox verloopt?">
    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.
  </Accordion>
</AccordionGroup>

## 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](https://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.