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

# Yoco

> Stel de Yoco-betaalintegratie in voor storekit-winkels in Zuid-Afrika. Stapsgewijze instructies om kaartbetalingen te accepteren via het netwerk van Yoco.

Yoco is een toonaangevende betaalprovider in Zuid-Afrika die eenvoudige en betaalbare kaartbetalingen biedt voor bedrijven van elke omvang. storekit integreert rechtstreeks met Yoco voor Zuid-Afrikaanse winkels.

<Frame>
  <img src="https://mintcdn.com/storekit/KWICXJPGJEfLt5cY/images/yoco-logo.svg?fit=max&auto=format&n=KWICXJPGJEfLt5cY&q=85&s=2ebdfac2c715d64ddf91a1a8d47aba97" alt="Yoco" width="120" noZoom data-path="images/yoco-logo.svg" />
</Frame>

<Note>
  Yoco is een op zichzelf staande betaalintegratie, volledig gescheiden van storekit Payments (Adyen). Zuid-Afrikaanse winkels gebruiken voorlopig Yoco in plaats van storekit Payments.
</Note>

## Hoe het werkt

Wanneer een klant afrekent bij een winkel met Yoco ingeschakeld:

1. De klant voltooit de bestelling en gaat naar de betaling
2. Ze worden doorgestuurd naar de veilige afrekenpagina van Yoco
3. De klant voert kaartgegevens in of betaalt met een opgeslagen kaart
4. De betaling wordt verwerkt door Yoco
5. De klant wordt teruggestuurd naar je winkel met bevestiging

## Yoco koppelen

In tegenstelling tot andere betaalmethoden vereist Yoco dat je je API-geheime sleutel in storekit invoert:

<Steps>
  <Step title="Maak een Yoco-account aan">
    Als je er nog geen hebt, [meld je aan bij Yoco](https://www.yoco.com/za/) en voltooi hun onboardingproces.
  </Step>

  <Step title="Haal je Secret Key op">
    Log in bij de [Yoco App](https://app.yoco.com/) en ga naar **Sales > Payment Gateway**. Je ziet je **Test Secret Key** en **Live Secret Key**.
  </Step>

  <Step title="Voer je Secret Key in storekit in">
    Ga in je storekit-dashboard naar **Store Settings > Yoco** en plak je secret key.

    * Gebruik de **Test Secret Key** tijdens het instellen en testen
    * Schakel over naar de **Live Secret Key** wanneer je klaar bent om echte betalingen te accepteren
  </Step>

  <Step title="Start met betalingen accepteren">
    Zodra dit is geconfigureerd, verschijnt Yoco automatisch als betaalmethode bij het afrekenen.
  </Step>
</Steps>

## Functies

| Functie           | Ondersteund |
| ----------------- | ----------- |
| Kaartbetalingen   | Ja          |
| Terugbetalingen   | Ja          |
| Webhooks          | Ja          |
| Regelitem-details | Ja          |

## Beschikbaarheid

| Regio       | Valuta |
| ----------- | ------ |
| Zuid-Afrika | ZAR    |

## Terugbetalingen

Terugbetalingen voor Yoco-bestellingen werken hetzelfde als andere betaalmethoden:

1. Ga naar de bestelling in je storekit-dashboard
2. Klik op **Refund**
3. Voer het terugbetalingsbedrag in
4. De terugbetaling wordt verwerkt via Yoco en de klant wordt op de hoogte gebracht

<Info>
  Terugbetalingen worden rechtstreeks verwerkt via de API van Yoco. De terugbetaling verschijnt op de rekening van de klant volgens de standaard verwerkingstijden van Yoco.
</Info>

## Uitbetalingen

Yoco verzorgt uitbetalingen rechtstreeks naar je Zuid-Afrikaanse bankrekening. Uitbetalingstiming en kosten worden bepaald door je Yoco-accountinstellingen, niet door storekit.

Om je uitbetalingen en transactiegeschiedenis te bekijken, log in bij je [Yoco Portal](https://portal.yoco.com/).

## Yoco loskoppelen

Als je je Yoco-integratie moet verwijderen:

1. Ga naar **Store Settings > Yoco** in je storekit-dashboard
2. Verwijder je secret key
3. Sla de instellingen op

<Warning>
  Het verwijderen van je Yoco secret key voorkomt dat je winkel betalingen kan accepteren totdat je deze opnieuw invoert of een alternatieve betaalmethode instelt.
</Warning>

## Probleemoplossing

### Ongeldige Secret Key

Als je secret key niet werkt:

* Zorg dat je de volledige sleutel uit de Yoco App kopieert
* Controleer of je de juiste sleutel gebruikt (Test vs Live)
* Verifieer dat je Yoco-account volledig geverifieerd en actief is

### Betalingen werken niet

Als betalingen niet verwerkt worden:

* Controleer of je de **Live Secret Key** (niet Test) hebt ingevoerd voor echte betalingen
* Verifieer de status van je Yoco-account in de [Yoco App](https://app.yoco.com/)
* Zorg dat je winkel is ingesteld op de regio Zuid-Afrika

Voor verdere ondersteuning, [neem contact op met support](/docs/nl/getting-started/contact-support).

## Meer informatie

Bezoek [Yoco](https://www.yoco.com/za/) voor meer informatie over het accepteren van betalingen in Zuid-Afrika.


## Related topics

- [5. Betalingen instellen](/docs/nl/getting-started/launch/set-up-payments.md)