VGS Collect iOS SDK

VGSCollectSDK provides native inputs to collect, validate, and securely submit payment cards, PII, and files to a VGS tenant.

Table of Contents

• Before You Start
• Features
• Integration
  • Swift Package Manager
  • CocoaPods
• AI Agent Integration
• Quick Start
  • Initialize & Configure Fields
  • Observe Field State
  • Submit Data
• Card Scanning
• File Upload
• SwiftUI Support
• Demo Application
• Documentation
• Releases
• Analytics & Privacy
• Security Guidance
• Dependencies
• License

Before You Start

Create an organization in the VGS Dashboard. Use its sandbox tenant ID (``) to initialize the collector.

Features

• Secure text input elements with masking, formatting, validation & metadata (card brand, BIN, last4).
• Audited credit card scanning (BlinkCard) via VGS‑provided modules.
• Secure file picker & upload with explicit post‑upload cleanup.
• Field state observation API to drive UI (enable/disable actions based on validity).
• Multiple submission APIs (closure, async/await, Combine publisher variants).
• SwiftUI wrappers for all provided text field types.

Integration

Swift Package Manager

Requires Swift tools version 5.9 or higher. Check your installed version:

xcrun swift -version

The SDK is currently validated with Xcode 26.5 / Swift 6.3 while keeping the package manifest at swift-tools-version: 5.9 for customer compatibility.

Add the package in Xcode using the repository URL:

https://github.com/verygoodsecurity/vgs-collect-ios.git