BTThreeDSecureInfo

Objective-C

@interface BTThreeDSecureInfo : NSObject

Swift

class BTThreeDSecureInfo : NSObject

Contains information about the 3D Secure status of a payment method

Show on GitHub

  • Create a BTThreeDSecureInfo object from JSON.

    Declaration

    Objective-C

    - (nonnull instancetype)initWithJSON:(nonnull BTJSON *)json;

    Swift

    init(json: BTJSON)
    Show on GitHub

  • Unique transaction identifier assigned by the Access Control Server (ACS) to identify a single transaction.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *acsTransactionID;

    Swift

    var acsTransactionID: String? { get }
    Show on GitHub

  • On authentication, the transaction status result identifier.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *authenticationTransactionStatus;

    Swift

    var authenticationTransactionStatus: String? { get }
    Show on GitHub

  • On authentication, provides additional information as to why the transaction status has the specific value.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *authenticationTransactionStatusReason;

    Swift

    var authenticationTransactionStatusReason: String? { get }
    Show on GitHub

  • Cardholder authentication verification value or “CAVV” is the main encrypted message issuers and card networks use to verify authentication has occured. Mastercard uses an “AVV” message which will also be returned in the cavv parameter.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *cavv;

    Swift

    var cavv: String? { get }
    Show on GitHub

  • Directory Server Transaction ID is an ID used by the card brand’s 3DS directory server.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *dsTransactionID;

    Swift

    var dsTransactionID: String? { get }
    Show on GitHub

  • The ecommerce indicator flag indicates the outcome of the 3DS authentication. Possible values are 00, 01, and 02 for Mastercard 05, 06, and 07 for all other cardbrands.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *eciFlag;

    Swift

    var eciFlag: String? { get }
    Show on GitHub

  • Indicates whether a card is enrolled in a 3D Secure program or not. Possible values: Y = Yes N = No U = Unavailable B = Bypass E = RequestFailure

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *enrolled;

    Swift

    var enrolled: String? { get }
    Show on GitHub

  • If the 3D Secure liability shift has occurred.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL liabilityShifted;

    Swift

    var liabilityShifted: Bool { get }
    Show on GitHub

  • If the 3D Secure liability shift is possible.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL liabilityShiftPossible;

    Swift

    var liabilityShiftPossible: Bool { get }
    Show on GitHub

  • On lookup, the transaction status result identifier.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *lookupTransactionStatus;

    Swift

    var lookupTransactionStatus: String? { get }
    Show on GitHub

  • On lookup, provides additional information as to why the transaction status has the specific value.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *lookupTransactionStatusReason;

    Swift

    var lookupTransactionStatusReason: String? { get }
    Show on GitHub

  • The Payer Authentication Response (PARes) Status, a transaction status result identifier. Possible Values:

    • Y – Successful Authentication
    • N – Failed Authentication
    • U – Unable to Complete Authentication
    • A – Successful Stand-In Attempts Transaction

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *paresStatus;

    Swift

    var paresStatus: String? { get }
    Show on GitHub

  • The 3D Secure status value.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *status;

    Swift

    var status: String? { get }
    Show on GitHub

  • Unique identifier assigned to the 3D Secure authentication performed for this transaction.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *threeDSecureAuthenticationID;

    Swift

    var threeDSecureAuthenticationID: String? { get }
    Show on GitHub

  • Unique transaction identifier assigned by the 3DS Server to identify a single transaction.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *threeDSecureServerTransactionID;

    Swift

    var threeDSecureServerTransactionID: String? { get }
    Show on GitHub

  • The 3DS version used in the authentication, example “1.0.2” or “2.1.0”.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *threeDSecureVersion;

    Swift

    var threeDSecureVersion: String? { get }
    Show on GitHub

  • Indicates if the 3D Secure lookup was performed.

    Declaration

    Objective-C

    @property (nonatomic, readonly) BOOL wasVerified;

    Swift

    var wasVerified: Bool { get }
    Show on GitHub
  • xid

    Transaction identifier resulting from 3D Secure authentication. Uniquely identifies the transaction and sometimes required in the authorization message. This field will no longer be used in 3DS 2 authentications.

    Declaration

    Objective-C

    @property (nonatomic, readonly, nullable) NSString *xid;

    Swift

    var xid: String? { get }
    Show on GitHub