> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/besteron.md).

# Besteron

Modul Besteron umožňuje přijímat online platby na vašem e-shopu prostřednictvím platební brány Besteron.

### Co modul nabízí?

* Platby kartou (Visa, Mastercard)
* Apple Pay
* Google Pay
* Bankovní tlačítka (přímé platby z internetového bankovnictví)
* QR platby
* Podporu měn EUR a CZK
* Automatickou změnu stavu objednávky po zaplacení

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

### Kde najdu nastavení?

V administraci e-shopu přejděte do **Nastavení → Besteron**.

## Nastavení modulu

### Jak modul zprovoznit?

{% stepper %}
{% step %}

#### Zaregistrujte se na portálu Besteron

Odkaz najdete přímo v nastavení modulu.
{% endstep %}

{% step %}

#### Počkejte na schválení

Po schválení obdržíte přístupové údaje.
{% endstep %}

{% step %}

#### Zadejte přístupové údaje

Zadejte přístupové údaje do nastavení modulu.
{% endstep %}

{% step %}

#### Otestujte platbu

Otestujte platbu v testovacím režimu.
{% endstep %}

{% step %}

#### Přepněte modul do ostrého provozu

Přepněte modul do ostrého provozu.
{% endstep %}
{% endstepper %}

## Přístupové údaje

Pro fungování platební brány potřebujete zadat tři údaje:

#### CID

Unikátní identifikátor vašeho obchodního účtu. Obdržíte ho při registraci u Besteron.

#### Platební klíč

Klíč pro zabezpečení komunikace s platební bránou. Najdete ho v administraci Besteron.

#### API klíč

Klíč pro ověřování stavů plateb. Najdete ho v administraci Besteron.

### Kde najdu tyto údaje?

{% stepper %}
{% step %}

#### Přihlaste se do administrace Besteron

{% endstep %}

{% step %}

#### Přejděte do nastavení obchodníka

{% endstep %}

{% step %}

#### Zkopírujte jednotlivé klíče

Zkopírujte jednotlivé klíče do nastavení modulu.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Upozornění:** Nikdy nikomu nesdělujte své přístupové údaje. Používejte je pouze v nastavení e-shopu.
{% endhint %}

## Podporované platební metody

### Platby kartou

Zákazníci mohou platit kartami Visa a Mastercard. Tato metoda je dostupná pro obě měny (EUR i CZK).

### Apple Pay a Google Pay

Rychlé platby pomocí digitálních peněženek. Dostupné pouze pro měnu EUR.

### Bankovní tlačítka — Slovensko (EUR)

* Slovenská spořitelna
* Tatra banka
* VÚB
* UniCredit Bank SK
* Poštová banka
* VIAMO

### Bankovní tlačítka — Česko (CZK)

* Raiffeisenbank
* Česká spořitelna
* Komerční banka
* mBank
* MONETA Money Bank
* Fio banka
* UniCredit Bank CZ

### QR platby

Platba pomocí QR kódu naskenovaného v mobilní aplikaci banky. Dostupné pro měnu EUR.

## Stavy objednávek

Modul automaticky mění stav objednávky podle výsledku platby.

### Nastavení stavů

V nastavení modulu můžete pro každou situaci zvolit odpovídající stav objednávky:

* **Stav po úspěšném zaplacení** — objednávka bude přesunuta do tohoto stavu, jakmile zákazník úspěšně zaplatí
* **Stav po neúspěšné platbě** — objednávka bude přesunuta do tohoto stavu, pokud platba selže nebo ji zákazník zruší
* **Stav při čekání na platbu** — objednávka bude v tomto stavu, dokud zákazník nedokončí platbu

### Doporučené nastavení

| Situace          | Doporučený stav     |
| ---------------- | ------------------- |
| Úspěšná platba   | Přijato / Zaplaceno |
| Neúspěšná platba | Zrušeno             |
| Čekání na platbu | Čeká na vyřízení    |

## Omezení platebních metod

Pokud nechcete nabízet všechny platební metody, můžete některé zakázat.

### Jak zakázat platební metody?

{% stepper %}
{% step %}
V nastavení modulu zapněte **Zakázat některé typy plateb**.
{% endstep %}

{% step %}
V seznamu vyberte metody, které nechcete nabízet.
{% endstep %}

{% step %}
Uložte nastavení
{% endstep %}
{% endstepper %}

Zakázané metody se zákazníkům na platební bráně nezobrazí.

### Kdy je vhodné omezit metody?

* Pokud nepodporujete určitou měnu
* Pokud chcete zjednodušit výběr pro zákazníky
* Pokud máte s některou metodou provozní problémy

## Testovací režim

Před spuštěním do ostrého provozu doporučujeme modul otestovat.

### Jak zapnout testovací režim?

V nastavení modulu zaškrtněte **Zapnout testovací prostředí**.

### Co testovací režim umožňuje?

* Vyzkoušet celý platební proces bez skutečných peněz
* Ověřit správné nastavení stavů objednávek
* Otestovat e-mailové notifikace

### Testovací platba

V testovacím režimu použijte testovací údaje karty poskytnuté Besteronem. Skutečná platba se neprovede.

{% hint style="warning" %}
**Důležité:** Před spuštěním e-shopu nezapomeňte testovací režim vypnout!
{% endhint %}

## Často kladené otázky

### Obecné otázky

<details>

<summary>Kolik stojí používání Besteron?</summary>

Poplatky za transakce závisí na vaší smlouvě s Besteron. Kontaktujte Besteron pro aktuální ceník.

</details>

<details>

<summary>Jak dlouho trvá registrace u Besteron?</summary>

Registrace a ověření obchodníka obvykle trvá několik pracovních dní.

</details>

<details>

<summary>Musím mít slovenskou nebo českou firmu?</summary>

Besteron je slovenská platební brána. Pro registraci kontaktujte přímo Besteron ohledně podmínek.

</details>

### Platby

<details>

<summary>Zákazník nemůže dokončit platbu. Co mám dělat?</summary>

Zkontrolujte, zda máte správně zadané přístupové údaje a zda není zapnutý testovací režim. Pokud problém přetrvává, kontaktujte podporu Besteron.

</details>

<details>

<summary>Platba proběhla, ale stav objednávky se nezměnil.</summary>

Zkontrolujte nastavení stavů objednávek. Systém automaticky kontroluje stav plateb a aktualizuje objednávky.

</details>

<details>

<summary>Mohu vrátit peníze zákazníkovi?</summary>

Vrácení platby (refund) se provádí přímo v administraci Besteron, nikoli v e-shopu.

</details>

<details>

<summary>Proč některé banky nejsou dostupné?</summary>

Dostupnost bankovních tlačítek závisí na měně objednávky. České banky jsou dostupné pouze pro CZK, slovenské pouze pro EUR.

</details>

### Nastavení

<details>

<summary>Kde najdu přístupové údaje?</summary>

Po registraci a schválení u Besteron je najdete v administraci obchodníka na webu Besteron.

</details>

<details>

<summary>Mohu používat různé účty pro testování a ostrý provoz?</summary>

Ano, Besteron poskytuje oddělené testovací a produkční přístupy.

</details>

<details>

<summary>Co se stane, když zadám špatné údaje?</summary>

Platby nebudou fungovat. Zákazníci uvidí chybovou hlášku při pokusu o platbu.

</details>