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:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
merchantToken | string | Jedineč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. | |||
merchantName | string | Čitateľný názov, podľa ktorého obchodníka spoznáte v dashboarde a reportoch. Ak ho neuvediete, | |
použije sa merchantToken. | |||
email | string | ✓ | E-mail správcu obchodníka, ktorý sa používa na prihlásenie a dôležitú komunikáciu. |
Odpovede:
| Kód | Popis |
|---|---|
200 | Obchodník bol úspešne zaregistrovaný |
400 | Chyba validácie požiadavky |
401 | Neoprávnený prístup |
409 | Konflikt: 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:
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
merchantToken | string | ✓ | Identifikátor obchodníka u integrátora, pre ktorého bude autentifikačný token |
vydaný. Rovnaký ako v /auth/register. | |||
allowOnboarding | boolean | true, 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. | |||
employeeEmail | string | E-mail zamestnanca, ktorý používa terminál. |
Odpovede:
| Kód | Popis |
|---|---|
200 | Obchodník bol úspešne prihlásený |
400 | Chyba validácie požiadavky |
401 | Neoprávnený prístup |
404 | Nená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.