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

> Richten Sie die Yoco-Zahlungsintegration für storekit-Stores in Südafrika ein: Schritt-für-Schritt zur Kartenannahme über das Yoco-Netzwerk erklärt.

Yoco ist ein führender Zahlungsanbieter in Südafrika und bietet einfache und günstige Kartenzahlungen für Unternehmen jeder Größe. storekit integriert sich für südafrikanische Läden direkt mit Yoco.

<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 ist eine eigenständige Zahlungsintegration, vollständig getrennt von storekit Payments (Adyen). Derzeit nutzen südafrikanische Läden Yoco anstelle von storekit Payments.
</Note>

## So funktioniert es

Wenn ein Gast in einem Yoco-fähigen Laden zur Kasse geht:

1. Der Gast schließt seine Bestellung ab und wechselt zur Zahlung
2. Er wird zur sicheren Yoco-Checkout-Seite weitergeleitet
3. Der Gast gibt seine Kartendaten ein oder zahlt mit einer gespeicherten Karte
4. Die Zahlung wird von Yoco verarbeitet
5. Der Gast wird mit Bestätigung zu Ihrem Laden zurückgeleitet

## Yoco verbinden

Anders als bei anderen Zahlungsmethoden müssen Sie bei Yoco Ihren API-Secret-Key in storekit eingeben:

<Steps>
  <Step title="Ein Yoco-Konto erstellen">
    Falls Sie noch keins haben, [registrieren Sie sich bei Yoco](https://www.yoco.com/za/) und schließen Sie den Onboarding-Prozess ab.
  </Step>

  <Step title="Ihren Secret Key erhalten">
    Melden Sie sich in der [Yoco-App](https://app.yoco.com/) an und navigieren Sie zu **Sales > Payment Gateway**. Dort sehen Sie Ihren **Test Secret Key** und **Live Secret Key**.
  </Step>

  <Step title="Secret Key in storekit eingeben">
    Gehen Sie in Ihrem storekit-Dashboard zu **Ladeneinstellungen > Yoco** und fügen Sie Ihren Secret Key ein.

    * Verwenden Sie beim Einrichten und Testen den **Test Secret Key**
    * Wechseln Sie zum **Live Secret Key**, sobald Sie bereit sind, echte Zahlungen anzunehmen
  </Step>

  <Step title="Zahlungen annehmen">
    Sobald konfiguriert, erscheint Yoco automatisch als Zahlungsmethode an der Kasse.
  </Step>
</Steps>

## Funktionen

| Funktion         | Unterstützt |
| ---------------- | ----------- |
| Kartenzahlungen  | Ja          |
| Rückerstattungen | Ja          |
| Webhooks         | Ja          |
| Positionsdetails | Ja          |

## Verfügbarkeit

| Region    | Währung |
| --------- | ------- |
| Südafrika | ZAR     |

## Rückerstattungen

Rückerstattungen für Yoco-Bestellungen funktionieren wie bei anderen Zahlungsmethoden:

1. Rufen Sie die Bestellung in Ihrem storekit-Dashboard auf
2. Klicken Sie auf **Erstatten**
3. Geben Sie den Erstattungsbetrag ein
4. Die Rückerstattung wird über Yoco ausgeführt und der Gast benachrichtigt

<Info>
  Rückerstattungen werden direkt über die Yoco-API abgewickelt. Die Rückerstattung erscheint auf dem Konto des Gastes gemäß den Standardbearbeitungszeiten von Yoco.
</Info>

## Auszahlungen

Yoco wickelt Auszahlungen direkt auf Ihr südafrikanisches Bankkonto ab. Zeitpunkt und Gebühren der Auszahlung ergeben sich aus den Einstellungen Ihres Yoco-Kontos, nicht aus storekit.

Um Ihre Auszahlungen und Transaktionshistorie einzusehen, melden Sie sich in Ihrem [Yoco-Portal](https://portal.yoco.com/) an.

## Yoco trennen

Falls Sie Ihre Yoco-Integration entfernen müssen:

1. Gehen Sie in Ihrem storekit-Dashboard zu **Ladeneinstellungen > Yoco**
2. Entfernen Sie Ihren Secret Key
3. Speichern Sie die Einstellungen

<Warning>
  Das Entfernen Ihres Yoco-Secret-Keys verhindert, dass Ihr Laden Zahlungen annimmt, bis Sie ihn erneut eingeben oder eine andere Zahlungsmethode einrichten.
</Warning>

## Fehlerbehebung

### Ungültiger Secret Key

Wenn Ihr Secret Key nicht funktioniert:

* Stellen Sie sicher, dass Sie den vollständigen Schlüssel aus der Yoco-App kopieren
* Prüfen Sie, ob Sie den richtigen Schlüssel verwenden (Test vs. Live)
* Vergewissern Sie sich, dass Ihr Yoco-Konto vollständig verifiziert und aktiv ist

### Zahlungen funktionieren nicht

Wenn Zahlungen nicht verarbeitet werden:

* Prüfen Sie, ob Sie für echte Zahlungen den **Live Secret Key** (nicht Test) verwenden
* Überprüfen Sie den Status Ihres Yoco-Kontos in der [Yoco-App](https://app.yoco.com/)
* Stellen Sie sicher, dass Ihr Laden auf die Region Südafrika eingestellt ist

Für weitere Unterstützung [wenden Sie sich an den Support](/docs/de/getting-started/contact-support).

## Mehr erfahren

Besuchen Sie [Yoco](https://www.yoco.com/za/), um mehr über Zahlungen in Südafrika zu erfahren.


## Related topics

- [5. Zahlungen einrichten](/docs/de/getting-started/launch/set-up-payments.md)