VGSCollect Class Reference

Custom HTTP Headers


                    
                    
                    customHeaders

Set your custom HTTP headers.

Declaration

Swift

@MainActor
public var customHeaders: [String : String]? { get set }

Show on GitHub

Observe VGSTextField states

observeFieldState
Observe only focused VGSTextField on editing events.
Declaration
Swift

@MainActor public var observeFieldState: ((_ textField: VGSTextField) -> Void)?
Show on GitHub
observeStates
Observe all VGSTextField on editing events.
Declaration
Swift

@MainActor public var observeStates: ((_ form: [VGSTextField]) -> Void)?
Show on GitHub

Get Registered VGSTextFields

textFields
Returns array of VGSTextFields associated with VGSCollect instance.
Declaration
Swift

@MainActor public var textFields: [VGSTextField] { get }
Show on GitHub

Initialization


                    
                    
                    init(id:environment:hostname:)

Initialization.

Declaration

Swift

@MainActor
public init(id: String, environment: String, hostname: String? = nil)

Parameters

`id`	`String` object, your organization vault id.
`environment`	`String` object, your organization vault environment with data region.(e.g. “live”, “live-eu1”, “sandbox”).
`hostname`	`String?` object, custom Hostname, if not set, data will be sent to Vault Url. Default is `nil`.

Show on GitHub


                    
                    
                    init(id:environment:dataRegion:hostname:)

Initialization.

Declaration

Swift

@MainActor
public convenience init(id: String, environment: Environment = .sandbox, dataRegion: String? = nil, hostname: String? = nil)

Parameters

`id`	`String` object, your organization vault id.
`environment`	`Environment` object, your organization vault environment. By default `Environment.sandbox`.
`dataRegion`	`String` object, id of data storage region (e.g. “eu-123”).
`hostname`	`String` object, custom Hostname, if not set, data will be sent to Vault Url. Default is `nil`.

Show on GitHub

Manage VGSTextFields

getTextField(fieldName:)
Returns VGSTextField with VGSConfiguration.fieldName associated with VGCollect instance.
Declaration
Swift

@MainActor public func getTextField(fieldName: String) -> VGSTextField?
Show on GitHub


                    
                    
                    unsubscribeTextField(_:)

Unasubscribe VGSTextField from VGSCollect instance.

Declaration

Swift

@MainActor
public func unsubscribeTextField(_ textField: VGSTextField)

Parameters


                                textField

VGSTextField that should be unsubscribed.

Show on GitHub


                    
                    
                    unsubscribeTextFields(_:)

Unasubscribe VGSTextFields from VGSCollect instance.

Declaration

Swift

@MainActor
public func unsubscribeTextFields(_ textFields: [VGSTextField])

Parameters


                                textFields

an array of VGSTextFields that should be unsubscribed.

Show on GitHub

unsubscribeAllTextFields()
Unasubscribe all VGSTextFields from VGSCollect instance.
Declaration
Swift

@MainActor public func unsubscribeAllTextFields()
Show on GitHub

Manage Files

cleanFiles()
Detach files for associated VGSCollect instance.
Declaration
Swift

@MainActor public func cleanFiles()
Show on GitHub

Send data

sendData(path:method:routeId:extraData:requestOptions:completion:)
Send data from VGSTextFields to your organization vault.
- path: Inbound rout path for your organization vault.
- method: VGSCollectHTTPMethod, default is .post.
- routeId: id of VGS Proxy Route, default is nil.
- extraData: Any data you want to send together with data from VGSTextFields , default is nil.
- requestOptions: VGSCollectRequestOptions object, holds additional request options. Default options are .nestedJSON.
- completion: response completion block, returns VGSResponse.
Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.
Declaration
Swift

@MainActor public func sendData(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil, requestOptions: VGSCollectRequestOptions = VGSCollectRequestOptions(), completion block: @escaping (VGSResponse) -> Void)
Show on GitHub
sendFile(path:method:routeId:extraData:requestOptions:completion:)
Send file to your organization vault. Only send one file at a time.
- path: Inbound rout path for your organization vault.
- method: HTTPMethod, default is .post.
- routeId: id of VGS Proxy Route, default is nil.
- extraData: Any data you want to send together with data from VGSTextFields , default is nil.
- completion: response completion block, returns VGSResponse.
Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.
Declaration
Swift

@MainActor public func sendFile(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil, requestOptions: VGSCollectRequestOptions = VGSCollectRequestOptions(), completion block: @escaping (VGSResponse) -> Void)
Show on GitHub

Tokenization(Vault API) requests

tokenizeData(routeId:completion:)
Send tokenization request with data from VGSTextFields to Vaulr API v1.
- routeId: id of VGS Proxy Route, default is nil.
- completion: response completion block, returns VGSTokenizationResponse.
Note
Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.
Declaration
Swift

@MainActor public func tokenizeData(routeId: String? = nil, completion block: @escaping (VGSTokenizationResponse) -> Void)
Show on GitHub


                    
                    
                    createAliases(routeId:completion:)

Create aliases from VGSTextFields input with Vault API v2.

Note

Requires

Requires set in custom headers.

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createAliases(routeId: String? = nil, completion block: @escaping (VGSTokenizationResponse) -> Void)

Parameters

`routeId`	id of VGS Proxy Route, default is `nil`.
`completion`	response completion block, returns `VGSTokenizationResponse`.

Show on GitHub


                    
                    
                    createCard(token:extraData:completion:)

Send request with data from VGSTextFields to create card via CMP API(https://www.verygoodsecurity.com/docs/api/card-management#tag/card-management/POST/cards).

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createCard(token: String, extraData: [String : Any]? = nil, completion block: @escaping ((_ response: VGSResponse) -> Void))

Parameters

`token`	`JWT` access token.
`extraData`	`[String: Any]` additional data for create card request. Default is `nil`
`completion`	response completion block, returns `VGSResponse`.

Show on GitHub

VGSCollect + async


                    
                    
                    sendData(path:method:routeId:extraData:requestOptions:)

Asynchronous

Asynchronously send data from VGSTextFields to your organization vault.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func sendData(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil, requestOptions: VGSCollectRequestOptions = VGSCollectRequestOptions()) async -> VGSResponse

Parameters

`path`	Inbound rout path for your organization vault.
`method`	VGSCollectHTTPMethod, default is `.post`.
`routeId`	id of VGS Proxy Route, default is `nil`.
`extraData`	Any data you want to send together with data from VGSTextFields , default is `nil`.
`requestOptions`	`VGSCollectRequestOptions` object, holds additional request options. Default options are `.nestedJSON`.

Return Value

Show on GitHub


                    
                    
                    sendFile(path:method:routeId:extraData:)

Asynchronous

Asynchronously send file to your organization vault. Only send one file at a time.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func sendFile(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil) async -> VGSResponse

Parameters

`path`	Inbound rout path for your organization vault.
`method`	HTTPMethod, default is `.post`.
`routeId`	id of VGS Proxy Route, default is `nil`.
`extraData`	Any data you want to send together with data from VGSTextFields , default is `nil`.
`completion`	response completion block, returns `VGSResponse`.

Show on GitHub


                    
                    
                    createAliases(routeId:)

Asynchronous

Asynchronously send request with data from VGSTextFields to create aliases.

Note

Requires

Requires set in custom headers.

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createAliases(routeId: String? = nil) async -> VGSTokenizationResponse

Parameters

`routeId`	id of VGS Proxy Route, default is `nil`.
`completion`	response completion block, returns `VGSTokenizationResponse`.

Show on GitHub


                    
                    
                    tokenizeData(routeId:)

Asynchronous

Asynchronously send tokenization request with data from VGSTextFields.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func tokenizeData(routeId: String? = nil) async -> VGSTokenizationResponse

Parameters

`routeId`	id of VGS Proxy Route, default is `nil`.
`completion`	response completion block, returns `VGSTokenizationResponse`.

Show on GitHub


                    
                    
                    createCard(token:extraData:)

Asynchronous

Asynchronously send request with data from VGSTextFields to create card via CMP API.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createCard(token: String, extraData: [String : Any]? = nil) async -> VGSResponse

Parameters

`token`	`JWT` access token.
`extraData`	`[String: Any]` additional data for create card request. Default is `nil`
`completion`	response completion block, returns `VGSResponse`.

Show on GitHub

VGSCollect + Combine


                    
                    
                    sendDataPublisher(path:method:routeId:extraData:requestOptions:)

Send data from VGSTextFields to your organization vault using the Combine framework.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func sendDataPublisher(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil, requestOptions: VGSCollectRequestOptions = VGSCollectRequestOptions()) -> Future<VGSResponse, Never>

Parameters

`path`	Inbound rout path for your organization vault.
`method`	VGSCollectHTTPMethod, default is `.post`.
`routeId`	id of VGS Proxy Route, default is `nil`.
`extraData`	Any data you want to send together with data from VGSTextFields , default is `nil`.
`requestOptions`	`VGSCollectRequestOptions` object, holds additional request options. Default options are `.nestedJSON`.

Return Value

A Future publisher that emits a single VGSResponse.

Show on GitHub


                    
                    
                    sendFilePublisher(path:method:routeId:extraData:requestOptions:)

Send file to your organization vault using the Combine framework.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func sendFilePublisher(path: String, method: VGSCollectHTTPMethod = .post, routeId: String? = nil, extraData: [String : Any]? = nil, requestOptions: VGSCollectRequestOptions = VGSCollectRequestOptions()) -> Future<VGSResponse, Never>

Parameters

`path`	Inbound rout path for your organization vault.
`method`	VGSCollectHTTPMethod, default is `.post`.
`routeId`	id of VGS Proxy Route, default is `nil`.
`extraData`	Any data you want to send together with data from VGSTextFields , default is `nil`.
`requestOptions`	`VGSCollectRequestOptions` object, holds additional request options. Default options are `.nestedJSON`.

Return Value

A Future publisher that emits a single VGSResponse.

Show on GitHub


                    
                    
                    createAliasesPublisher(routeId:)

Send request with data from VGSTextFields to create aliases using the Combine framework.

Note

Requires

Requires set in custom headers.

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createAliasesPublisher(routeId: String? = nil) -> Future<VGSTokenizationResponse, Never>

Parameters


                                routeId

id of VGS Proxy Route, default is nil.

Return Value

A Future publisher that emits a single VGSTokenizationResponse.

Show on GitHub


                    
                    
                    tokenizeDataPublisher(routeId:)

Send tokenization request with data from VGSTextFields to your organization vault using the Combine framework.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func tokenizeDataPublisher(routeId: String? = nil) -> Future<VGSTokenizationResponse, Never>

Parameters


                                routeId

id of VGS Proxy Route, default is nil.

Return Value

A Future publisher that emits a single VGSTokenizationResponse.

Show on GitHub


                    
                    
                    createCardPublisher(token:extraData:)

Send request with data from VGSTextFields to create card via CMP API using the Combine framework.

Note

Errors can be returned in the NSURLErrorDomain and VGSCollectSDKErrorDomain.

Declaration

Swift

@MainActor
public func createCardPublisher(token: String, extraData: [String : Any]? = nil) -> Future<VGSResponse, Never>

Parameters

`token`	`JWT` access token.
`extraData`	`[String: Any]` additional data for create card request. Default is `nil`

Return Value

A Future publisher that emits a single VGSResponse.

Show on GitHub