Rýchly štart

Zistite, ako nastaviť SDK, nakonfigurovať prostredie a úspešne vykonať prvú transakciu.

Merchant

KYB

Your App

Accept SDK

Your Backend

Accept SDK beží vo vašej aplikácii a spracúva platby priamo na zariadení: načíta kartu alebo platbu cez Tap to Pay, zašifruje údaje a udrží prácu s kartou mimo váš kód, takže zostávate mimo rozsahu PCI. Váš backend overuje každú reláciu SDK voči Tapaya API, zabezpečuje onboarding obchodníkov a spúšťa KYB. Tapaya vykonáva kontroly KYB a zúčtováva prostriedky obchodníkovi.

Zvoľte spôsob integrácie

Platby kartou cez Tap to Pay môžete prijímať dvoma spôsobmi. Oba odovzdávajú samotnú interakciu s kartou pluginovej aplikácii Tapaya Terminal na tom istom zariadení. Líšia sa tým, akú veľkú časť tohto odovzdania riadi vaša aplikácia:

Accept SDK (odporúčané)

Vložte SDK do svojej aplikácie pre Android a výsledok získajte v callbackoch. Tento sprievodca opisuje práve tento spôsob.

Iba Tapaya Terminal

Bez SDK: otvorte Tapaya Terminal pomocou intentu alebo deeplinku a priebežne zisťujte stav platby.

Nastavenie účtu integrátora

Skôr ako začnete písať kód, nastavte si účet, voči ktorému sa bude váš backend autentifikovať:

Zaregistrujte sa na platform.tapaya.com/register. Registrácia je samoobslužná: pozvánka nie je potrebná.
Prihláste sa a potom vytvorte organizáciu alebo sa pripojte k existujúcej; vyzveme vás na to automaticky hneď po registrácii.
Vygenerujte si Server Secret Token na stránke API kľúčov: váš backend ho používa na volanie Tapaya Platform API (pozrite autentifikácia v Platform API).

Nejde o onboarding obchodníkov

Toto je nastavenie účtu pre vás, integrátora. Vaši obchodníci prechádzajú onboardingom samostatne, a to buď cez SDK, Tapaya Platform UI, vaše vlastné UI, alebo pomocou odkazu s pozvánkou. Podrobnosti nájdete v časti Onboarding obchodníkov. POST /merchant/auth/register iba vytvorí základný záznam obchodníka; hostovaný onboarding cez pozvánku sa začína volaním POST /integrator/merchant/send-registration-invite.

Zvyšok tohto sprievodcu opisuje pridanie SDK do projektu, autentifikáciu relácie a vykonanie prvej transakcie.

Pridanie závislosti

Na Androide je SDK publikované v Maven Central; v React Native sa inštaluje z npm príkazom npx expo install @tapayadot/accept-react-native a zapojí sa pomocou svojho konfiguračného pluginu.

build.gradle.kts

dependencies {
    implementation("com.tapaya:accept:1.15.0")
}

Synchronizujte projekt (Android) alebo spustite npx expo prebuild --clean (React Native) a potom vykonajte inicializáciu a autentifikáciu v kóde aplikácie.

MyApplication.kt

// Step 1: Initialize (once, in Application.onCreate)
Accept.initialize(this) // sandbox by default; pass isProduction = true to go live

Autentifikujte reláciu obchodníka pomocou tokenu získaného z vášho backendu. authenticate je funkcia typu suspend a pri zlyhaní vyhodí výnimku AcceptException.

// Step 2: Authenticate (suspend; call from a coroutine)
try {
    val sdkToken = myBackend.login() // token from POST /merchant/auth/login
    Accept.auth.authenticate(sdkToken)
    // Accept.state now emits SdkState.Authenticated
} catch (e: AcceptException) {
    // handle authentication failure
}

Onboarding obchodníka

Skôr ako budú povolené akékoľvek transakcie, obchodník musí dokončiť onboarding KYB. Onboarding už neriadi Accept SDK. Dokončite ho cez Tapaya Platform UI, vlastné UI napojené na Tapaya API, alebo pomocou odkazu s pozvánkou. Všetky spôsoby nájdete v časti Onboarding obchodníkov.

Automatické schválenie v sandboxe

V sandboxe sú obchodníci schválení automaticky hneď po onboardingu, takže nemusíte čakať na posúdenie spracovateľom platieb.

Overenie pripravenosti obchodníka

Uistite sa, že obchodník dokončil onboarding a je schválený na prijímanie platieb.

val ready = when (val status = Accept.merchant.onboardingStatus()) {
    OnboardingStatus.ReadyForPayments -> true
    is OnboardingStatus.RequiresAction -> false // status.state describes what's blocking
}

Obchodník je pripravený až potom, ako ho schváli spracovateľ platieb. Ak niektoré údaje chýbajú, onboarding je nutné zopakovať. V niektorých prípadoch môže spracovateľ platieb obchodníka úplne zablokovať, napríklad pri predaji zakázaného tovaru.

Inštalácia a aktivácia terminálu

Vyžaduje sa pluginová aplikácia

Platby kartou vyžadujú, aby bol na zariadení nainštalovaný plugin Tapaya Accept. Na kontrolu použite Accept.plugin.isInstalled(), a ak plugin chýba, otvorte jeho stránku v obchode pomocou Accept.plugin.install().

Plugin Tapaya Accept je pre platby kartou nevyhnutný. Skontrolujte, či je nainštalovaný, a potom aktivujte terminál, prípadne otvorte stránku pluginu v Obchode Play a nainštalujte ho.

Plugin

if (Accept.plugin.isInstalled()) {
    // suspend; returns ActivateTerminalResult (Success / Canceled / Failed)
    Accept.plugin.activateTerminal()
} else {
    Accept.plugin.install() // opens the store listing
}

Vytvorenie platobnej transakcie

Transakciu vykonáte volaním Accept.payments.pay() so sumou (v najmenšej jednotke meny) a kódom meny podľa ISO 4217. Metóda vracia Flow<PaymentEvent>; odoberajte z neho udalosti (collect), aby ste sledovali priebeh a konečný výsledok. pay() nikdy nevyhadzuje výnimku: zlyhania prichádzajú ako PaymentEvent.CreationFailed.

Na rýchly štart stačia iba amount a currency. Všetky voliteľné parametre, napríklad pevné prepitné, úpravy účtenky alebo metadáta, nájdete v časti Vytvorenie platby.

Platba

Accept.payments.pay(amount = 15000, currency = "CZK") // 150.00 Kč
    .collect { event ->
        when (event) {
            PaymentEvent.Creating -> Log.d("pay", "creating")
            is PaymentEvent.Created -> Log.d("pay", "created ${event.paymentToken}")
            PaymentEvent.Launched -> Log.d("pay", "launched")
            is PaymentEvent.Result -> Log.d("pay", event.payResult.toString())
            is PaymentEvent.CreationFailed -> Log.e("pay", event.cause.toString())
        }
    }

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