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

> Configura l'integrazione di pagamento Yoco per i negozi storekit in Sudafrica. Istruzioni passo-passo per accettare pagamenti con carta sulla rete Yoco.

Yoco è un fornitore di pagamenti leader in Sudafrica, che offre pagamenti con carta semplici e convenienti per attività di tutte le dimensioni. storekit si integra direttamente con Yoco per i negozi sudafricani.

<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 è un'integrazione di pagamento autonoma, completamente separata da storekit Payments (Adyen). Per ora, i negozi sudafricani utilizzano Yoco invece di storekit Payments.
</Note>

## Come funziona

Quando un cliente effettua il checkout in un negozio abilitato a Yoco:

1. Il cliente completa l'ordine e procede al pagamento
2. Viene reindirizzato alla pagina di checkout sicura di Yoco
3. Il cliente inserisce i dati della carta o paga con una carta salvata
4. Il pagamento viene elaborato da Yoco
5. Il cliente viene reindirizzato al tuo negozio con la conferma

## Collegamento di Yoco

A differenza di altri metodi di pagamento, Yoco richiede l'inserimento della tua API secret key in storekit:

<Steps>
  <Step title="Crea un account Yoco">
    Se non ne hai già uno, [registrati a Yoco](https://www.yoco.com/za/) e completa il loro processo di onboarding.
  </Step>

  <Step title="Ottieni la tua chiave segreta">
    Accedi all'[app Yoco](https://app.yoco.com/) e vai a **Sales > Payment Gateway**. Vedrai la tua **Test Secret Key** e la **Live Secret Key**.
  </Step>

  <Step title="Inserisci la tua chiave segreta in storekit">
    Nella tua dashboard storekit, vai a **Store Settings > Yoco** e incolla la tua chiave segreta.

    * Usa la **Test Secret Key** durante la configurazione e il testing
    * Passa alla **Live Secret Key** quando sei pronto ad accettare pagamenti reali
  </Step>

  <Step title="Inizia ad accettare pagamenti">
    Una volta configurato, Yoco apparirà automaticamente come metodo di pagamento al checkout.
  </Step>
</Steps>

## Funzionalità

| Funzionalità                 | Supportata |
| ---------------------------- | ---------- |
| Pagamenti con carta          | Sì         |
| Rimborsi                     | Sì         |
| Webhook                      | Sì         |
| Dettagli delle voci d'ordine | Sì         |

## Disponibilità

| Regione   | Valuta |
| --------- | ------ |
| Sudafrica | ZAR    |

## Rimborsi

I rimborsi per gli ordini Yoco funzionano allo stesso modo degli altri metodi di pagamento:

1. Vai all'ordine nella tua dashboard storekit
2. Clicca su **Refund**
3. Inserisci l'importo del rimborso
4. Il rimborso viene elaborato tramite Yoco e il cliente viene notificato

<Info>
  I rimborsi vengono elaborati direttamente tramite l'API di Yoco. Il rimborso apparirà sul conto del cliente secondo i tempi di elaborazione standard di Yoco.
</Info>

## Payout

Yoco gestisce i payout direttamente sul tuo conto bancario sudafricano. La tempistica e le commissioni dei payout sono determinate dalle impostazioni del tuo account Yoco, non da storekit.

Per visualizzare i tuoi payout e la cronologia delle transazioni, accedi al tuo [Yoco Portal](https://portal.yoco.com/).

## Disconnessione di Yoco

Se devi rimuovere l'integrazione con Yoco:

1. Vai a **Store Settings > Yoco** nella tua dashboard storekit
2. Rimuovi la tua chiave segreta
3. Salva le impostazioni

<Warning>
  La rimozione della chiave segreta Yoco impedirà al tuo negozio di accettare pagamenti fino a quando non la reinserirai o configurerai un metodo di pagamento alternativo.
</Warning>

## Risoluzione dei problemi

### Chiave segreta non valida

Se la tua chiave segreta non funziona:

* Assicurati di copiare la chiave completa dall'app Yoco
* Controlla di utilizzare la chiave corretta (Test o Live)
* Verifica che il tuo account Yoco sia completamente verificato e attivo

### I pagamenti non funzionano

Se i pagamenti non vengono elaborati:

* Controlla di aver inserito la **Live Secret Key** (non Test) per i pagamenti reali
* Verifica lo stato del tuo account Yoco nell'[app Yoco](https://app.yoco.com/)
* Assicurati che il tuo negozio sia impostato sulla regione Sudafrica

Per ulteriore assistenza, [contatta l'assistenza](/docs/it/getting-started/contact-support).

## Scopri di più

Visita [Yoco](https://www.yoco.com/za/) per saperne di più sull'accettazione dei pagamenti in Sudafrica.


## Related topics

- [5. Configura i pagamenti](/docs/it/getting-started/launch/set-up-payments.md)