Collect a Card

Before You Start

Read the following guides before proceeding:

Overview

WirexCollectForm is one UIView holding the card inputs. The user types the card inside it; the SDK
registers the card with Wirex and returns a token. Your code receives the token, the brand, the BIN and the
last four digits — never the PAN or the CVV.

Collect needs no action token: it uses accessToken() and the identity from your WirexCredentialProvider.

Choose a Profile

Step 1: Place the Form

import UIKit
import WirexMobileSDK

final class CollectViewController: UIViewController {
    private let credentials = AppCredentials()
    private var form: WirexCollectForm?

    override func viewDidLoad() {
        super.viewDidLoad()
        guard let collect = WirexCollect.create(credentials: credentials, testMode: true, chainId: "<chain id>") else { return }
        let form = collect.form(profile: .topup)
        self.form = form
        view.addSubview(form)
        form.frame = CGRect(x: 16, y: 100, width: view.bounds.width - 32, height: form.naturalHeight)
        form.onChange = { [weak self] state in self?.updateSubmit(isComplete: state.isComplete) }
    }
}

Size the form to form.naturalHeight. To lay fields out yourself, form.row(for:) returns a single sealed row.
form.errorLine sets where validation messages render: hidden, reserved or animated.

Step 2: Gate Your Submit Button

onChange delivers WirexCollectState:

The sealed fields replace only the card inputs. The billing address and card label come from your own views.
Enable submit only when isComplete is true and your billing address is complete.

Step 3: Tokenize

Top-Up Card

func tokenize() {
    guard let form else { return }
    Task { @MainActor in
        do {
            let token = try await form.tokenizeTopUp(WirexTopUpTokenizeParams(
                billingDetails: WirexBillingDetails(line1: "1 High Street", zipCode: "N1 9GU", city: "London", country: "GB"),
                label: "Personal Visa"))
            try await backend.topUp(externalCardId: token.cardId)
        } catch let error as WirexError {
            print(error.code, error.retryable, error.reason as Any)
        }
    }
}

Result (WirexTopUpCardToken):

bin and last4 are out of PCI scope and safe to display.

Payout Card

let token = try await form.tokenizeOctDestination(WirexOctTokenizeParams(
    cardLabel: "Alex Visa", isSaved: true, isThirdParty: false))

The result carries externalCardId — the card token for push to card.

Call form.clear() when the screen goes away.

Step 4: Hand the Token to Your Backend

The SDK makes no money-moving call. Your backend continues the REST flow:

Errors

tokenizeTopUp and tokenizeOctDestination throw WirexError { code, retryable, reason }.

Full error handling: Errors, Logging and Troubleshooting.