Native modules

​

How it works

1. You add the module to your app next to the SDK, as a package product, a pod or a Gradle dependency.
2. When the app starts, the module registers itself with the SDK. On iOS with CocoaPods you call its register() once; everywhere else there is no code to write.
3. During a transaction, the SDK asks Yuno which providers apply and uses the matching module: it collects a device fingerprint and attaches it to the payment, runs the 3DS challenge natively instead of in a WebView, or opens the Revolut Pay checkout.

​

Available modules

​

Install

platform :ios, '14.0'   # 15.0 if you add SdkPaymentsRevolutPay

target 'YourApp' do
  use_frameworks!
  pod 'SdkPayments'
  # Add only the modules your account uses
  pod 'YunoClearsaleAntifraud'
  pod 'SdkAntifraudMagnes'
  pod 'SdkAntifraudKoin'
  pod 'SdkPaymentsNetcetera'
  pod 'SdkPaymentsRevolutPay'
end

repositories {
    maven { url = uri("https://yunopayments.jfrog.io/artifactory/snapshots-libs-release") }
}

dependencies {
    implementation("com.yuno.payments:android-sdk:3.0.0")
    // Add only the modules your account uses
    implementation("com.yuno.payments:yuno-sdk-antifraud-clearsale:1.0.0")
    implementation("com.yuno.payments:yuno-sdk-antifraud-koin:1.0.0")
    implementation("com.yuno.payments:yuno-sdk-antifraud-riskified:1.0.0")
    implementation("com.yuno.payments:yuno-sdk-3ds-netcetera:1.0.1")
}

​

Activate

import SdkPayments
import SdkAntifraudClearsale
import SdkAntifraudMagnes
import SdkAntifraudKoin
import SdkPaymentsNetcetera
import SdkPaymentsRevolutPay

SdkAntifraudClearsale.register()
SdkAntifraudMagnes.register()
SdkAntifraudKoin.register()
SdkPaymentsNetcetera.register()
SdkPaymentsRevolutPay.register()

SdkPayments.initialize(apiKey: "your-public-api-key")

import com.yuno.payments.sdk.api.SdkPayments

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        SdkPayments.initialize(this, apiKey = "your-public-api-key")
    }
}

import androidx.startup.AppInitializer
import com.yuno.antifraud.clearsale.ClearSaleAntifraudInitializer
import com.yuno.antifraud.koin.KoinAntifraudInitializer
import com.yuno.threedsecure.netcetera.Netcetera3DSInitializer

val initializer = AppInitializer.getInstance(applicationContext)
initializer.initializeComponent(ClearSaleAntifraudInitializer::class.java)
initializer.initializeComponent(KoinAntifraudInitializer::class.java)
initializer.initializeComponent(Netcetera3DSInitializer::class.java)

​

What each module needs from your app

​

Antifraud modules

• The fingerprint travels as the payment’s customer.device_fingerprint. Nothing changes in the data you send.
• Collection runs when the shopper confirms the payment, and the shopper waits for it. On iOS the SDK waits up to 6 seconds for the fingerprint and sends the payment without it when it does not arrive. On Android collection is bounded by the timeout configured for the provider in your Yuno account (5 seconds by default). Keep it short.
• None of them requests location. On Android, do not add play-services-location version 21 or higher next to the ClearSale module: those versions are incompatible with the bundled ClearSale SDK.

​

Netcetera 3DS

• Runs the 3D Secure challenge inside your app, for payments and enrollment, instead of the WebView challenge. If you customize the SDK styles, they propagate to the challenge screen.
• The challenge is still presented full-screen by the SDK: it does not come through showView.
• Sandbox only: the Netcetera SDK needs a Visa test root certificate (acq-root-certeq-prev-environment.crt) in your app bundle. Ask your Yuno TAM for it, it is not distributed publicly. On iOS, add it to your app target and check it appears under Build Phases > Copy Bundle Resources. Production builds do not use it.

​

Revolut Pay

• iOS only, through CocoaPods, on iOS 15.0 or higher. The pod brings RevolutPayments/RevolutPay and lottie-ios with it. If your Podfile already pins either, align the versions with the module.
• Start the payment as usual, with paymentMethodType: "REVOLUT_PAY". The SDK creates the payment, then opens the Revolut Pay flow directly: no form, no action view. showView is not called for it; showLoading is.
• Revolut returns to your app through a deeplink. Declare the return URL in your Info.plist under the key YunoRevolutPayReturnURL, as a full URL such as myapp://revolut-pay. Without the key, the SDK uses the first URL scheme of CFBundleURLTypes with the host revolut-pay. Forward incoming URLs to SdkPayments.handleDeeplink, as described in Handle deeplinks. The SDK passes the URL to Revolut only while a Revolut Pay payment is in flight.
• To let Revolut detect its app for the app-to-app flow, add revolut to LSApplicationQueriesSchemes in your Info.plist.
• Every Revolut callback is confirmed against the payment status before onStatus runs. A payment still pending after that check is reported as PENDING. An abandoned flow is reported as USER_CANCEL. A Revolut-side failure, a device below iOS 15 or a missing module is reported as INTERNAL_ERROR with message.code REVOLUT_PAY_FAILED.

​

Troubleshooting

​

Related

• Get Started. Install and initialize the SDK.
• Handle deeplinks. Return to your app after an external step.
• Netcetera 3DS on Android. Maven repository and permissions.