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

# Papaya: prehľad

> Prepojte VEXiON cards s vaším Papaya POS, aby sa vernostné karty spracovávali priamo pri pokladni.

Prepojenie VEXiON cards s POS systémom **Papaya** znamená, že vernostné karty sa spracovávajú **priamo pri pokladni**. Keď zákazník naskenuje svoju kartu, VEXiON vypočíta jeho pečiatky, body alebo zľavu a Papaya ju uplatní na účet.

> [!NOTE]
>
> Toto je prehľad. Ostatné návody k Papaya pokrývajú [pripojenie a nastavenie](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-setup.md), [menu a produkty](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-menu.md), [typy kariet a nastavenie bodov](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-card-types.md) a [prácu pri pokladni](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-pos.md).

## Čo integrácia s Papaya robí

Prepája váš vernostný program VEXiON s vaším Papaya POS. **Vernostné body nastavujete v rámci VEXiON**, na zozname produktov synchronizovanom z Papaya, takže vernostný program neupravujete v administrácii Papaya.

* **Pripojenie po prevádzkach**: každá prevádzka sa pripája vlastnou **URL adresou** Papaya a **API tokenom**.
* **Dva webhooky**: Papaya volá VEXiON pri naskenovaní karty a znova pri zaplatení účtu.
* **Synchronizácia menu**: vaše produkty (názvy, ceny, kategórie) sa načítavajú z Papaya do VEXiON.
* **Body sa nastavujú vo VEXiON**: v tabuľke produktov vo VEXiON určujete, ktoré produkty priznávajú a ktoré čerpajú body.
* **Automatické alebo manuálne čerpanie**: pri každom type karty si vyberiete, ako sa odmena uplatní pri pokladni (toto je hlavná vec, ktorou sa Papaya odlišuje).

> [!NOTE]
>
> Papaya je **slovenský** POS systém a hlásenia, ktoré pokladník vidí na obrazovke Papaya, sú v slovenčine bez ohľadu na jazyk nastavený vo VEXiON.

## Ako to funguje

Papaya volá VEXiON **dvakrát** pri každom predaji: raz pri naskenovaní karty (na zistenie zľavy) a raz pri zaplatení účtu (na zaznamenanie transakcie a aktualizáciu karty).

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','actorBkg':'#E5F6FF','actorBorder':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
sequenceDiagram
    participant C as Zákazník
    participant P as Papaya POS
    participant V as VEXiON
    Note over V: Nastavenie raz vopred: vernostné body<br/>sa nastavujú na produktoch vo VEXiON
    C->>P: 1. Pokladník naskenuje kartu na otvorenom účte
    P->>V: 2. Papaya sa pýta VEXiON na zľavu
    V->>V: 3. VEXiON vyhodnotí vaše pravidlá<br/>(pečiatky, body, zľava)
    V-->>P: 4. VEXiON vráti zľavu na uplatnenie
    C->>P: 5. Zákazník zaplatí
    P->>V: 6. Papaya zaznamená transakciu
    V->>V: 7. VEXiON aktualizuje kartu
    V-->>C: 8. Zákazník vidí nový zostatok v peňaženke
```

### Automatické vs. manuálne čerpanie

Hlavnou voľbou pri Papaya je, **ako sa odmena uplatní**, a nastavujete ju samostatne pre pečiatkové karty a bodové (cashback) karty:

| Režim | Čo robí pokladník | Kedy použiť |
| - | - | - |
| **Automatický** | Nič. Odmena sa uplatní sama, keď má zákazník dostatok. | Najjednoduchšie pre personál |
| **Manuálny** | Pred naskenovaním pridá na účet špeciálny produkt **"VEXiON Odmena"**, len keď si zákazník praje odmenu čerpať. | Keď chcete, aby si zákazník vybral sám |

V **manuálnom** režime, ak produkt "VEXiON Odmena" nie je na účte, karta iba **získava body**, nečerpá ich. Podrobnosti nájdete v časti [Typy kariet a nastavenie bodov](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-card-types.md).

## Podporované typy kariet

| Typ karty | Podporované | Ako to funguje |
| - | :-: | - |
| Pečiatková karta | ✅ | Zbieranie pečiatok, čerpanie na zdarma alebo zvýhodnený produkt |
| Bodová karta (cashback) | ✅ | Body sa prevádzajú na zľavu v eurách |
| Zľavová karta | ✅ | Automatická percentuálna zľava podľa úrovne |
| Darčeková karta | ✅ | Predplatený kredit, ktorý predávate, dobíjate a zákazník ho míňa pri pokladni |

> [!NOTE]
>
> **Darčekové karty na Papaya fungujú.** Karty sa predávajú, dobíjajú a míňajú pri pokladni a zákazník, ktorý si kartu kúpil online, ju môže zaplatiť pri pulte. Pozrite si [Darčekové karty](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-gift-cards.md).

## Požiadavky

| Požiadavka | Podrobnosti |
| - | - |
| Účet Papaya | Aktívny účet Papaya POS |
| API token | Vygenerovaný v administrácii Papaya (Administrácia → API) |
| Vernostné webhooky | Nastavené v Papaya tak, aby mohli volať VEXiON |
| Účet VEXiON | Aktívny účet VEXiON cards |
| Vernostná karta | Aspoň jedna karta vytvorená vo VEXiON |

> [!NOTE]
>
> Papaya je POS integrácia a je súčasťou balíka **VEXiON cards PRO**. Pozrite si [Balíky a cenník](https://vexioncards.mintlify.site/cs/knowledge-base/billing-plans.md).

## Rýchly štart

**1. Pridajte svoju prevádzku**

V Nastavenia → Integrácie rozbaľte **Papaya**, pridajte prevádzku s jej **URL adresou** a **API tokenom** a otestujte pripojenie.

**2. Nastavte webhooky v Papaya**

V Papaya nastavte **typ** vernostného programu a vložte obe webhookové URL adresy VEXiON a token.

**3. Synchronizujte svoje menu**

Načítajte svoje produkty z Papaya do VEXiON.

**4. Nastavte vernostný program na svojich produktoch**

V tabuľke produktov vo VEXiON nastavte, ktoré produkty priznávajú a čerpajú body, a zvoľte automatické alebo manuálne čerpanie.

**5. Hotovo**

Integrácia je aktívna. Kompletný postup nájdete v časti [Pripojenie a nastavenie](https://vexioncards.mintlify.site/cs/knowledge-base/papaya-setup.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.