Démarrage rapide

Ajouter la dépendance

Sur Android, le SDK est publié sur Maven Central ; sur React Native, il s’installe depuis npm avec npx expo install @tapayadot/accept-react-native et est configuré par son plugin de configuration.

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

Synchronisez le projet (Android) ou exécutez npx expo prebuild --clean (React Native), puis initialisez le SDK et authentifiez-vous dans le code de votre application.

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

Authentifiez une session commerçant avec un jeton obtenu depuis votre backend. authenticate est une fonction suspend qui lève une AcceptException en cas d’échec.

// 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
}

Effectuer l’onboarding du commerçant

Avant de pouvoir effectuer la moindre transaction, le commerçant doit terminer l’onboarding KYB. L’onboarding n’est plus piloté par l’Accept SDK. Effectuez-le via la Tapaya Platform UI, votre propre interface s’appuyant sur l’API Tapaya, ou un lien d’invitation. Consultez Onboarding des commerçants pour toutes les méthodes.

Vérifier que le commerçant est prêt

Assurez-vous que le commerçant a terminé l’onboarding et qu’il est approuvé pour accepter des paiements.

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

Le commerçant n’est prêt qu’une fois approuvé par le processeur de paiement. S’il manque des informations, l’onboarding doit être recommencé. Dans certains cas, le processeur de paiement peut bloquer complètement le commerçant, par exemple s’il vend des produits interdits.

Installer et activer le terminal

Le plugin Tapaya Accept est requis pour les paiements par carte. Vérifiez s’il est installé, puis activez le terminal, ou ouvrez sa fiche sur le Play Store pour l’installer.

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

Créer une transaction de paiement

Pour exécuter une transaction, appelez Accept.payments.pay() avec le montant (dans la plus petite unité de la devise) et un code de devise ISO 4217. La méthode renvoie un Flow<PaymentEvent> ; collectez-le pour suivre la progression et le résultat final. pay() ne lève jamais d’exception : les échecs arrivent sous forme de PaymentEvent.CreationFailed.

Le démarrage rapide ne nécessite que amount et currency. Pour tous les paramètres facultatifs, comme un pourboire fixe, la personnalisation du reçu ou les métadonnées, consultez Créer un paiement.

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())
        }
    }