Swift SDK

Overview

CoinflowCardForm is a SwiftUI SDK that embeds Coinflow’s card tokenization form directly into iOS apps. The user enters their card inside your app, the SDK returns a payment token, and your backend charges the card via the standard Coinflow checkout API.

• Package: coinflow-swift
• Distribution: Swift Package Manager
• Current version: 0.2.0

Requirements

• iOS 15+
• Swift 5.9+
• Xcode 15+

Installation

https://github.com/coinflow-labs-us/coinflow-swift

Integration

1
import SwiftUI
2
import CoinflowCardForm
3
4
struct PaymentView: View {
5
    @StateObject private var coordinator = CardFormCoordinator()
6
7
    var body: some View {
8
        VStack {
9
            CoinflowCardFormView(
10
                variant: .cardForm,
11
                merchantId: "your-merchant-id",
12
                env: .sandbox,
13
                coordinator: coordinator
14
            )
15
            .frame(height: 52)
16
17
            Button("Pay") {
18
                Task { await tokenize() }
19
            }
20
        }
21
    }
22
23
    private func tokenize() async {
24
        do {
25
            let response = try await coordinator.tokenize()
26
            print("Token: \(response.token)")
27
        } catch {
28
            // surface error to user
29
        }
30
    }
31
}

1
#if DEBUG
2
let env: CoinflowEnv = .sandbox
3
#else
4
let env: CoinflowEnv = .prod
5
#endif

Variants

1
CoinflowCardFormView(variant: .cardForm, ...)         // full card entry
2
CoinflowCardFormView(variant: .cardNumberForm, ...)   // number + expiry only
3
CoinflowCardFormView(variant: .cvvForm, token: "...", ...) // CVV only for saved card

Theming

MerchantTheme styles the rendered form. All fields optional.

1
let theme = MerchantTheme(
2
    primary: "#165DFB",
3
    background: "#ffffff",
4
    textColor: "#05092E",
5
    ctaColor: "#165DFB",
6
    font: "Red Hat Display",
7
    style: .rounded
8
)
9
10
CoinflowCardFormView(theme: theme, /* ... */)

Dynamic height

The hosted form reflows responsively — at narrow widths the inputs wrap to multiple rows. To keep your SwiftUI container fitted, observe coordinator.contentHeight and bind it to your frame:

1
CoinflowCardFormView(
2
    merchantId: "your-merchant-id",
3
    coordinator: coordinator
4
)
5
.frame(height: coordinator.contentHeight ?? 52)

contentHeight is @Published on CardFormCoordinator and updates whenever the form reflows. Without this wiring the form may be clipped if it wraps.

Resources

• Source: github.com/coinflow-labs-us/coinflow-swift
• License: Apache 2.0
• Checkout API: Card Checkout endpoint