# Platform API (/sk/platform-api)





Tapaya Platform API vám umožňuje spravovať obchodníkov, platby a nastavenia organizácie z vášho servera. Ktoré
endpointy potrebujete, závisí od toho, ako vaša aplikácia prijíma platby; nie každý integrátor potrebuje všetky sekcie.

<SwaggerBanner href="https://api.tapaya.com/openapi/index.html" />

<Callout title="Výčtové hodnoty sú číselné" type="info">
  Polia ako `businessTypeId`, `countryId`, `currencyId`, `documentType` a `refundReasonId` sú všetky číselné
  výčty (enums). Možné hodnoty pre každé z nich nájdete v
  [dokumentácii Swagger](https://api.tapaya.com/openapi/index.html), nie v tomto sprievodcovi.
</Callout>

## Ktoré sekcie sa vás týkajú [#which-sections-apply-to-you]

| Vaša integrácia                                                                                                               | [Autentifikácia obchodníkov](/in-store/integration/backend_integration#merchant-authentication-accept-sdk-integrations) | [Onboarding obchodníkov](/platform-api/merchant_onboarding) | [Reporting a platby](/platform-api/reporting) |
| ----------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------: | :-------------------------------------------: |
| **Accept SDK** (vložené do vašej aplikácie)                                                                                   |                                                        🟢 Povinné                                                       |                         🟡 Voliteľné                        |                  🟡 Voliteľné                 |
| **Iba aplikácia Tapaya Terminal** ([intent/deeplink](/in-store/integration/card_terminal#integrate-without-the-sdk), bez SDK) |                                                    ⚪ Nie je potrebné                                                    |                         🟡 Voliteľné                        |                  🟡 Voliteľné                 |
| **Iba reporting / back office**                                                                                               |                                                    ⚪ Nie je potrebné                                                    |                      ⚪ Nie je potrebné                      |                   🟢 Povinné                  |

* **Autentifikácia obchodníkov**: SDK sa autentifikuje ako obchodník pomocou prihlasovacieho tokenu, ktorý si vyžiada váš backend. Pri
  integráciách s Tapaya Terminal nie je potrebné: obchodník sa prihlasuje priamo do aplikácie Tapaya Terminal, takže neexistuje žiadna
  relácia SDK, ktorú by váš backend musel autentifikovať.
* **Onboarding obchodníkov**: voliteľný pre každú platobnú integráciu, v predajni aj online. Obchodník prejde onboardingom raz a
  tento onboarding pokrýva oba kanály. Onboarding prebieha cez Tapaya Platform UI, hostovanú pozvánku alebo API, podľa toho,
  kto má údaje obchodníka zhromažďovať.
* **Reporting a platby**: voliteľné pre ktorúkoľvek platobnú integráciu, ak si budujete vlastné dashboardy;
  povinné (a samo osebe postačujúce), ak iba sťahujete dáta na reporting a nemáte vlastnú platobnú integráciu.

Všetky riadky stále vyžadujú [autentifikáciu](#authentication) pomocou tokenu Server Secret Token.

<Callout title="Použitie Secret key pre Checkout" type="info">
  [Online Checkout](/online/integration/api_integration#authentication) prijíma ten istý **Secret key** zo
  [stránky API Keys](https://platform.tapaya.com/api-keys/), tu nazývaný Server Secret Token.
  Checkout vyžaduje `Authorization: Bearer <secret-key>` a organizáciu priradí k obchodníkovi.
  Požiadavky na priradenie obchodníka nájdete v časti [Autentifikácia Checkoutu](/online/integration/api_integration#authentication).
</Callout>

## Prostredia [#environments]

Tapaya Platform API podporuje tieto prostredia:

* **Produkcia:** Beží na `https://api.tapaya.com`. Toto prostredie používa skutočné účty a pracuje so skutočnými prostriedkami. &#x2A;*Produkčné prostredie nepoužívajte na testovanie.**
* **Sandbox:** Beží na `https://api.sandbox.tapaya.com`. Toto prostredie vám umožňuje testovať integráciu bez akéhokoľvek pohybu skutočných prostriedkov. Viac o testovaní nájdete v našom [sprievodcovi testovaním / sandboxom](/in-store/getting-started/testing).

## Autentifikácia [#authentication]

Požiadavky na Platform API používajú váš Server Secret Token, na stránke API Keys označený ako **Secret key**. Odovzdávajte ho bez zmeny v hlavičke `Authorization` svojich HTTP požiadaviek.

```http
Authorization: REPLACE_ME
```

Aby ste svoju platformu voči API autentifikovali, musíte na [stránke API Keys](https://platform.tapaya.com/api-keys/) vygenerovať **Secret key**, tu označovaný ako Server Secret Token, a nahradiť ním *REPLACE\_ME* vyššie.

<Callout title="Bezpečnostné upozornenie" type="warn">
  Váš Server Secret Token má vysoké oprávnenia. **Nikdy** ho nezverejňujte v kóde na strane klienta (mobilné aplikácie, webové
  prehliadače). Smie sa používať iba z vašich zabezpečených backendových serverov.
</Callout>

Ak je token kompromitovaný, zrušte ho na [stránke API Keys](https://platform.tapaya.com/api-keys/); zrušenie
platí okamžite a nemožno ho vrátiť späť. Náhradný token vygenerujte pred zrušením alebo po ňom, podľa potreby;
akcia „rotácie“ tokenu na mieste neexistuje, takže keď nový token vytvoríte, aktualizujte ním konfiguráciu svojho backendu.

<Callout title="Bez obmedzenia rozsahu kľúčov" type="info">
  Každý Server Secret Token má rovnaké oprávnenia v rámci celej organizácie; tokeny zatiaľ nemožno obmedziť na
  konkrétne endpointy alebo obchodníkov. Každý token považujte za ekvivalent plného prístupu k API pre vašu organizáciu.
</Callout>

Server je dostupný iba cez protokol HTTPS, pričom na úrovni infraštruktúry je vynútený TLS 1.2 alebo novší. Platí obmedzenie počtu požiadaviek (100 požiadaviek za minútu na IP adresu); požiadavky, ktoré server preťažujú, vrátia chybu `429 Too Many Requests`.