BTThreeDSecureClient

@objcMembers
public class BTThreeDSecureClient : NSObject
Show on GitHub

Initializer

  • Initialize a new BTThreeDSecureClient instance.

    Declaration

    Swift

    @objc(initWithAuthorization:)
public init(authorization: String)

    Parameters

    authorization

    A valid client token or tokenization key used to authorize API calls.
    Show on GitHub

Public Methods

  • Starts the 3DS flow using a BTThreeDSecureRequest.

    Declaration

    Swift

    public func start(_ request: BTThreeDSecureRequest, completion: @escaping (BTThreeDSecureResult?, Error?) -> Void)

    Parameters

    request

    A BTThreeDSecureRequest request.
    completion

    This completion will be invoked exactly once when the 3DS flow is complete or an error occurs.
    Show on GitHub

  • Creates a stringified JSON object containing the information necessary to perform a lookup.

    Declaration

    Swift

    @objc(prepareLookup:completion:)
public func prepareLookup(
    _ request: BTThreeDSecureRequest,
    completion: @escaping (String?, Error?) -> Void
)

    Parameters

    request

    The BTThreeDSecureRequest object where prepareLookup was called.
    completion

    This completion will be invoked exactly once with the client payload string or an error.
    Show on GitHub
  • prepareLookup(_:) Asynchronous

    Creates a stringified JSON object containing the information necessary to perform a lookup.

    Throws

    An Error describing the failure

    Declaration

    Swift

    public func prepareLookup(_ request: BTThreeDSecureRequest) async throws -> String

    Parameters

    request

    The BTThreeDSecureRequest object where prepareLookup was called.

    Return Value

    On success, you will receive a client payload string

    Show on GitHub

  • Initialize a challenge from a server side lookup call.

    Note

    Majority of 3DS integrations do not need to use this method. Only for server-side 3DS integrations.

    Declaration

    Swift

    @objc(initializeChallengeWithLookupResponse:request:completion:)
public func initializeChallenge(
    lookupResponse: String,
    request: BTThreeDSecureRequest,
    completion: @escaping (BTThreeDSecureResult?, Error?) -> Void
)

    Parameters

    lookupResponse

    The JSON string returned by the server side lookup.
    request

    The BTThreeDSecureRequest object where prepareLookup was called.
    completion

    This completion will be invoked exactly once when the payment flow is complete or an error occurs.
    Show on GitHub

  • Initialize a challenge from a server side lookup call.

    Throws

    An Error describing the failure

    Declaration

    Swift

    public func initializeChallenge(
    lookupResponse: String,
    request: BTThreeDSecureRequest
) async throws -> BTThreeDSecureResult

    Parameters

    lookupResponse

    The JSON string returned by the server side lookup.
    request

    The BTThreeDSecureRequest object where prepareLookup was called.

    Return Value

    On success, you will receive an instance of BTThreeDSecureResult

    Show on GitHub