> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Signifyd Antifraud (iOS)

> Add Signifyd device profiling to Yuno SDK iOS checkouts with the SdkAntifraudSignifyd module.

The `SdkAntifraudSignifyd` module adds **Signifyd device profiling** to the Yuno SDK for iOS (`SdkPayments`). When Signifyd is a fraud screening provider in your Yuno payment route, the Yuno SDK profiles the device during checkout with Signifyd's Profiling SDK and sends the session ID with the payment. Yuno then forwards it to Signifyd with the order.

> [!NOTE]
>
> The module is **opt-in**: add it only if your Yuno account uses Signifyd for fraud screening. Installing it does not change your payment or enrollment code.

Unlike the other [native modules](https://docs.y.uno/docs/yuno-sdk/features/native-modules.md), Signifyd ships in **its own Swift Package Manager package**, and Signifyd's Profiling SDK is downloaded from Signifyd's private repository with **your own Signifyd token**. Yuno does not bundle or redistribute Signifyd's SDK.

## Requirements

* iOS **14.0** or higher.
* Xcode **26.2** or higher.
* **`SdkPayments` or `SdkPayments-Static` 3.2.0 or higher**, installed through **Swift Package Manager**.
* A **Signifyd SDK download token**, issued by your Signifyd solution engineer.
* Signifyd enabled as a **fraud screening provider** in your Yuno payment route.

> [!WARNING]
>
> The module is available through **Swift Package Manager only**. There is no CocoaPods pod. The Yuno SDK must also come from Swift Package Manager: if your app installs `SdkPayments` with CocoaPods and this module with Swift Package Manager, the app loads two copies of the Yuno SDK and checkout does not use Signifyd.

## Installation

**1. Add your Signifyd token**

The token lets Swift Package Manager download Signifyd's Profiling SDK from Signifyd's private repository. It is only used when your build resolves packages, never at runtime.

* **Xcode 26:** go to **Xcode > Settings > Source Control**, click **+**, choose **GitHub**, and enter the GitHub account and the token that Signifyd gave you. On earlier Xcode versions the same option is under **Settings > Accounts**.
* **CI:** write the token to `~/.netrc` before the build, and remove the file when the build finishes:

  ```
  machine github.com
    login x-access-token
    password <your-signifyd-token>
  ```

**2. Add the package**

In Xcode go to **File > Add Package Dependencies...**, add:

```
https://github.com/yuno-payments/yuno-sdk-ios-signifyd
```

choose **Up to Next Major Version** from `2.0.0`, and add the `SdkAntifraudSignifyd` product to your app target, next to the `SdkPayments` or `SdkPayments-Static` product you already use. Xcode downloads Signifyd's Profiling SDK automatically.

If your app uses a `Package.swift`, add the dependency there instead:

```swift theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
dependencies: [
    .package(url: "https://github.com/yuno-payments/yuno-sdk-ios.git", from: "3.2.0"),
    .package(url: "https://github.com/yuno-payments/yuno-sdk-ios-signifyd.git", from: "2.0.0")
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "SdkPayments", package: "yuno-sdk-ios"),
            .product(name: "SdkAntifraudSignifyd", package: "yuno-sdk-ios-signifyd")
        ]
    )
]
```

**3. Enable Signifyd in Yuno**

Ask your Yuno account team to add Signifyd as a fraud screening provider in your payment route. Without it, the module is installed but the Yuno SDK never runs it.

## Activating the module

The module **registers itself** when the app launches, with either `SdkPayments` or `SdkPayments-Static`. No code is required beyond adding the `SdkAntifraudSignifyd` product to your app target.

> [!TIP]
>
> Once the module is installed and Signifyd is in your payment route, the Yuno SDK uses it automatically in every checkout. You do not need to change any payment or enrollment code.

## How it works

1. When the app launches, the module registers the Signifyd provider with the Yuno SDK.
2. During checkout, if Signifyd is a fraud screening provider for the transaction, the Yuno SDK runs the module.
3. The module profiles the device with Signifyd's Profiling SDK and returns the session ID it profiled under.
4. The Yuno SDK sends that session ID with the payment, and Yuno forwards it to Signifyd with the order.

If profiling fails or takes longer than the checkout allows, the payment continues without the Signifyd fingerprint.

## Troubleshooting

> [accordion] Package resolution fails for ios-sdk-dist (401 or repository not found)
>
> Swift Package Manager could not download Signifyd's Profiling SDK. Check that your Signifyd token is added in **Xcode > Settings > Source Control** (or in `~/.netrc` on CI) and that it is still valid. If the token expired or was revoked, ask your Signifyd solution engineer for a new one. Apps you already released keep working, because the token is only used at build time.

> [accordion] The module is installed but payments carry no Signifyd fingerprint
>
> Check that the `SdkAntifraudSignifyd` product is added to your **app target**, not only to the project, and that Signifyd is a fraud screening provider in your Yuno payment route.

> [accordion] Package resolution fails with a version conflict on yuno-sdk-ios
>
> Versions 2.x of this package require `yuno-sdk-ios` 3.2.0 or higher. Versions 1.x are for the Legacy SDK (`YunoSDK` 2.x), see [Signifyd antifraud (Legacy iOS)](https://docs.y.uno/docs/sdks/external-native-modules/signifyd-ios.md).

> [accordion] My app installs SdkPayments with CocoaPods
>
> The module depends on the Yuno SDK from Swift Package Manager. Remove the pod and add `SdkPayments-Static` (the same static linking you had with CocoaPods) from Swift Package Manager before adding this module.

> [accordion] Duplicate SignifydProfilingSdk framework
>
> The `SdkAntifraudSignifyd` package already brings Signifyd's Profiling SDK. If your app also embeds `SignifydProfilingSdk.xcframework` manually, remove it and keep only the package dependency.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.