Tapaya
Prijímanie platieb v predajniSprievodca integráciouIntegrácia API

Integrácia API

Autentifikujte obchodníkov pre Accept SDK zo svojho backendu.

Aby vaši obchodníci mohli používať Tapaya Accept SDK, váš backend zaregistruje každého obchodníka a pre každú reláciu SDK si vyžiada krátkodobý prihlasovací token. Obe volania používajú váš Server Secret Token; ako ho vygenerovať, popisuje autentifikácia v Platform API.

Onboarding obchodníkov a sťahovanie platobných údajov fungujú pre všetky produkty Tapaya rovnako a sú popísané v zdieľanej sekcii Prehľad: API na onboarding obchodníkov a Reporting a platby.

Smerovanie podľa prostredia

Accept SDK automaticky smeruje požiadavky podľa toho, ako bolo inicializované:

  • Sandbox (predvolené): Pripája sa k sandboxu na adrese https://api.sandbox.tapaya.com.
  • Produkcia: Pripája sa k produkčnému prostrediu na adrese https://api.tapaya.com.

Autentifikácia obchodníkov (integrácie cez Accept SDK)

Len pre integrácie cez Accept SDK

Túto sekciu preskočte, ak ovládate aplikáciu Tapaya Terminal priamo (intent/deeplink, bez vloženého SDK); obchodníkom zodpovedným za transakciu (merchant of record) je potom účet prihlásený v Tapaya Terminal a váš backend nikdy neautentifikuje reláciu obchodníka. Pozrite si Integrácia bez SDK.

Aby vaši obchodníci mohli používať Tapaya Accept SDK, musíte na svojom backende implementovať nasledujúce endpointy.

Registrácia nového obchodníka

Predtým, ako môže obchodník používať SDK, musí byť zaregistrovaný v systéme Tapaya. Zvyčajne sa to robí vtedy, keď sa používateľ zaregistruje do vašej služby. Obchodníka stačí zaregistrovať raz. Registráciu môžete vykonať v Tapaya Platform UI alebo pomocou API.

Endpoint: POST /merchant/auth/register

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/register' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "merchantName": "Acme Corp",
        "email": "admin@acme.com"
    }'

Parametre:

PoleTypPovinnéPopis
merchantTokenstringJedinečný a stály identifikátor z vášho systému (napr. ID v databáze), ktorý identifikuje
obchodníka. Ak ho neuvediete, vygeneruje sa náhodný token.
merchantNamestringČitateľný názov, podľa ktorého obchodníka spoznáte v dashboarde a reportoch. Ak ho neuvediete,
použije sa merchantToken.
emailstring✓E-mail správcu obchodníka, ktorý sa používa na prihlásenie a dôležitú komunikáciu.

Odpovede:

KódPopis
200Obchodník bol úspešne zaregistrovaný
400Chyba validácie požiadavky
401Neoprávnený prístup
409Konflikt: obchodník je už zaregistrovaný

Telo odpovede:

{
    "merchantToken": "unique_merchant_id_from_your_db"
}

Vygenerovanie prihlasovacieho tokenu

Aby mobilné zariadenie mohlo inicializovať SDK pre konkrétneho obchodníka, musíte vygenerovať krátkodobý prihlasovací token. Vaša mobilná aplikácia si ho vyžiada od vášho backendu a váš backend si ho vyžiada od Tapaya. Nový token potrebujete pri každej inicializácii SDK.

Endpoint: POST /merchant/auth/login

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/login' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "allowOnboarding": true,
        "employeeEmail": "john@acme.com"
    }'

Parametre:

PoleTypPovinnéPopis
merchantTokenstring✓Identifikátor obchodníka u integrátora, pre ktorého bude autentifikačný token
vydaný. Rovnaký ako v /auth/register.
allowOnboardingbooleantrue, ak používateľ smie v mene obchodníka zobrazovať a upravovať údaje onboardingu/KYB, registrovať nové
platobné metódy a schvaľovať obchodné podmienky. Pri prvom volaní musí byť true, aby obchodník mohol
zaregistrovať aspoň jednu platobnú metódu. false, ak používateľ nemá prístup k onboardingu a môže používať len
už nakonfigurované platobné metódy. Predvolená hodnota je true.
employeeEmailstringE-mail zamestnanca, ktorý používa terminál.

Odpovede:

KódPopis
200Obchodník bol úspešne prihlásený
400Chyba validácie požiadavky
401Neoprávnený prístup
404Nenájdené

Telo odpovede:

{
    "token": "EesrFq4PUK1WxHUj93hkrKASDFp8GxJ0"
}

Odovzdajte tento token svojej mobilnej aplikácii, aby mohla SDK inicializovať. Do mobilnej aplikácie ho preneste bezpečne a hneď po použití ho vymažte. Token je viazaný na obchodníka identifikovaného pomocou merchantToken.

Bezpečnostné upozornenie

Pri získavaní tokenu pre SDK sa uistite, že používate správny merchantToken. Tapaya SDK tento token používa na prihlásenie v mene obchodníka, čím získava prístup k jeho údajom a prostriedkom.

Chýba vám niečo na tejto stránke?Navrhnite funkciu. Pripojíme túto stránku, aby tím videl súvislosti.