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

> Configurez l'intégration de paiement Yoco pour les magasins storekit en Afrique du Sud. Instructions pas à pas pour accepter les cartes via le réseau Yoco.

Yoco est un prestataire de paiement de premier plan en Afrique du Sud, offrant des paiements par carte simples et abordables pour les entreprises de toutes tailles. storekit s'intègre directement avec Yoco pour les magasins sud-africains.

<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 est une intégration de paiement autonome, totalement distincte de storekit Payments (Adyen). Pour l'instant, les magasins sud-africains utilisent Yoco à la place de storekit Payments.
</Note>

## Fonctionnement

Lorsqu'un client passe à la caisse dans un magasin où Yoco est activé :

1. Le client finalise sa commande et procède au paiement
2. Il est redirigé vers la page de paiement sécurisée de Yoco
3. Le client saisit les détails de sa carte ou paie avec une carte enregistrée
4. Le paiement est traité par Yoco
5. Le client est redirigé vers votre magasin avec la confirmation

## Connecter Yoco

Contrairement à d'autres moyens de paiement, Yoco nécessite que vous saisissiez votre clé secrète API dans storekit :

<Steps>
  <Step title="Créer un compte Yoco">
    Si vous n'en avez pas encore, [inscrivez-vous à Yoco](https://www.yoco.com/za/) et suivez leur processus d'onboarding.
  </Step>

  <Step title="Récupérer votre clé secrète">
    Connectez-vous à l'[App Yoco](https://app.yoco.com/) et allez dans **Sales > Payment Gateway**. Vous y verrez votre **Test Secret Key** et votre **Live Secret Key**.
  </Step>

  <Step title="Saisir votre clé secrète dans storekit">
    Dans votre tableau de bord storekit, allez dans **Store Settings > Yoco** et collez votre clé secrète.

    * Utilisez la **Test Secret Key** pendant la configuration et les tests
    * Passez à la **Live Secret Key** lorsque vous êtes prêt à accepter de vrais paiements
  </Step>

  <Step title="Commencer à accepter des paiements">
    Une fois configuré, Yoco apparaîtra automatiquement comme moyen de paiement au moment du paiement.
  </Step>
</Steps>

## Fonctionnalités

| Fonctionnalité                | Prise en charge |
| ----------------------------- | --------------- |
| Paiements par carte           | Oui             |
| Remboursements                | Oui             |
| Webhooks                      | Oui             |
| Détails des lignes d'articles | Oui             |

## Disponibilité

| Région         | Devise |
| -------------- | ------ |
| Afrique du Sud | ZAR    |

## Remboursements

Les remboursements pour les commandes Yoco fonctionnent de la même manière que pour les autres moyens de paiement :

1. Allez sur la commande dans votre tableau de bord storekit
2. Cliquez sur **Refund**
3. Saisissez le montant du remboursement
4. Le remboursement est traité via Yoco et le client est notifié

<Info>
  Les remboursements sont traités directement via l'API de Yoco. Le remboursement apparaîtra sur le compte du client selon les délais de traitement standard de Yoco.
</Info>

## Versements

Yoco gère les versements directement sur votre compte bancaire sud-africain. Les délais et frais de versement sont déterminés par les paramètres de votre compte Yoco, et non par storekit.

Pour consulter vos versements et votre historique de transactions, connectez-vous à votre [Yoco Portal](https://portal.yoco.com/).

## Déconnecter Yoco

Si vous devez supprimer votre intégration Yoco :

1. Allez dans **Store Settings > Yoco** dans votre tableau de bord storekit
2. Supprimez votre clé secrète
3. Enregistrez les paramètres

<Warning>
  La suppression de votre clé secrète Yoco empêchera votre magasin d'accepter des paiements jusqu'à ce que vous la saisissiez à nouveau ou configuriez un autre moyen de paiement.
</Warning>

## Dépannage

### Clé secrète invalide

Si votre clé secrète ne fonctionne pas :

* Assurez-vous de copier la clé complète depuis l'App Yoco
* Vérifiez que vous utilisez la bonne clé (Test vs Live)
* Vérifiez que votre compte Yoco est entièrement vérifié et actif

### Les paiements ne fonctionnent pas

Si les paiements ne s'exécutent pas :

* Vérifiez que vous avez saisi la **Live Secret Key** (et non Test) pour de vrais paiements
* Vérifiez le statut de votre compte Yoco dans l'[App Yoco](https://app.yoco.com/)
* Assurez-vous que votre magasin est défini sur la région Afrique du Sud

Pour toute assistance supplémentaire, [contactez le support](/docs/fr/getting-started/contact-support).

## En savoir plus

Consultez [Yoco](https://www.yoco.com/za/) pour en savoir plus sur l'acceptation des paiements en Afrique du Sud.


## Related topics

- [5. Configurer les paiements](/docs/fr/getting-started/launch/set-up-payments.md)