Convert to Credit (C2C) Support — iOS

Convert to Credit (C2C) Support — iOS

Convert to Credit allows users to convert withdrawable Lucra funds into your app’s internal currency or credits. This feature increases retention by keeping value inside your ecosystem rather than leaving through withdrawals.

---

🎯 Overview

When a user goes to Withdraw Funds, Lucra presents:

• Traditional withdrawal methods (ACH, Venmo, PayPal, etc.)

• Convert to Credit as an additional option — only if you provide a C2C provider

Your app supplies:

• Conversion rules

• Display strings

• Reward metadata

• Optional styling

Lucra handles:

• UI

• User confirmation

• Flow transitions

• Webhook delivery to your backend

You must apply the credit on your backend.

---

🧩 ConvertToCreditProvider

Implement the protocol:

public protocol ConvertToCreditProvider {
    func withdrawMethod(for amount: Decimal) async -> CreditWithdrawal
}

Lucra calls this every time:

• The Withdraw screen opens

• The withdrawal amount changes

---

📌 Registering the Provider

let provider = MyConvertToCreditProvider()
lucraClient.registerConvertToCreditProvider(provider)

Without this registration:

👉 Convert to Credit will not appear in the Lucra UI.

---

🛠 Implementing the Provider

Example:

final class MyConvertToCreditProvider: ConvertToCreditProvider {
    func withdrawMethod(for amount: Decimal) async -> CreditWithdrawal {

        // Example: 3x multiplier conversion
        let multiplier: Decimal = 3
        let converted = amount * multiplier

        return CreditWithdrawal(
            id: "coins",
            title: "Convert to Coins",
            iconUrl: URL(string: "https://example.com/coins.png"),
            theme: CreditWithdrawal.Theme(),
            conversionTerms: "Instant • No fees",
            convertedAmount: converted,
            convertedDisplayAmount: "\(converted) Coins",
            shortDescription: "Turn your balance into bonus coins!",
            longDescription: "Use coins anywhere in the app to unlock new experiences.",
            metaData: [
                "currency": "coins",
                "multiplier": "\(multiplier)"
            ]
        )
    }
}

The function is async, so you can fetch rules from your backend.

---

🔄 Backend Requirements (Critical)

• Backend Integration (https://docs.lucrasports.com/lucra-sdk/convert-to-credit/convert-to-credit-backend-integration)