VGSCollectSDK 提供本地输入，用于收集、验证并安全地向 VGS 租户提交支付卡、个人身份信息（PII）和文件。

目录

• 开始之前
• 功能特征
• 积分
• Swift 包管理器
• 可可豆
• AI 代理集成
• 快速启动
• 初始化并配置字段
• 观察田野状态
• 提交数据
• 卡片扫描
• 文件上传
• SwiftUI 支持
• 演示应用
• 文献资料
• 发行作品
• 分析与隐私
• 安全指导
• 依赖关系
• 许可证

开始之前

在 VGS 仪表盘中创建一个组织。使用其沙箱租户 ID （[ ） 初始化收集器。

特色

• 通过遮罩、格式化、验证和元数据（卡片品牌、BIN、last4）保护文本输入元素。
• 通过VGS提供的模块进行审计信用卡扫描（BlinkCard）。
• 通过显式的上传后清理，保障文件选择器和上传。
• 场状态观察 API，用于驱动 UI（根据有效性启用/禁用操作）。
• 多提交API（闭合、异步/等待、Combin发布版本）。
• 所有提供的文本字段类型都支持SwiftUI封装器。

整合

迅捷包管理器

需要Swift工具5.9版本及以上。

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