1.2.256 • Published 7 months ago

@trustpayments/3ds-sdk-js v1.2.256

Weekly downloads
-
License
-
Repository
-
Last release
7 months ago

3DS SDK JS

Warning!

This package is for internal purposes only.

Config

  • challengeDisplayMode - POPUP | INLINE. Default: POPUP

  • challengeDisplayInlineTargetElementId - string. Default: undefined.Must be the existing DOM Element when using challengeDisplayMode = INLINE.

  • loggingLevel - ERROR | ALL. Default: ERROR

  • translations - {cancel: string; }. Default: { cancel: 'X' }

  • processingScreenMode - OVERLAY | ATTACH_TO_ELEMENT. Default: OVERLAY ATTACH_TO_ELEMENT requires additional property processingScreenWrapperElementId

  • processingScreenWrapperElementId - string. Default: undefinedMust be the existing DOM Element when using processingScreenMode = ATTACH_TO_ELEMENT.

  • threeDSMethodTimeout - number. Default: 10000 (milliseconds)Timeout after which 3DS Method will be resolved with UNCOMPLETED result. The value is validated against the range of 1-10000 milliseconds.

API

init$()

Initializes the library and returns the Observable with the config.

init$(config: ConfigInterface): Observable<ConfigInterface | never>;

Default values for config are: challengeDisplayMode = ChallengeDisplayMode.POPUP loggingLevel: LoggingLevel.ERROR

interface ConfigInterface {
  challengeDisplayMode?: ChallengeDisplayMode;
  challengeDisplayInlineTargetElementId?: string;
  loggingLevel?: LoggingLevel;
}

enum ChallengeDisplayMode {
  POPUP = 'POPUP',
  INLINE = 'INLINE',
}

enum LoggingLevel {
  ERROR = 'ERROR',
  ALL = 'ALL',
}

run3DSMethod$()

Runs 3DS method and returns the result.

run3DSMethod$(transactionId: string, notificationURL: string, methodURL: string): Observable<MethodURLResultInterface | never>;
interface MethodURLResultInterface {
  status: ResultActionCode;
  description: string;
  transactionId: string;
}

enum ResultActionCode {
  SUCCESS = 'SUCCESS',
  FAILURE = 'FAILURE',
  ERROR = 'ERROR',
  NOACTION = 'NOACTION',
  CANCELLED = 'CANCELLED',
  COMPLETED = 'COMPLETED',
}

Possible ResultActionCode values are: SUCCESS, FAILURE, ERROR, and UNCOMPLETED. UNCOMPLETED timeout can be set via config property threeDSMethodTimeout. Default values is 10 seconds.

doChallenge$()

Initializes the challenge process. This method handles both versions 1.0.0 and 2.1.0 | 2.2.0. For version 1.0.0, termURL and merchantData parameters are required.

doChallenge$(
  version: ThreeDSecureVersion,
  threedpayload: string,
  challengeURL: string,
  termURL?: string,
  merchantData?: string,
): Observable<ChallengeResultInterface | never>;
export interface ChallengeResultInterface {
  status: ResultActionCode; // ResultActionCode is shared between challenge and method URL
  description: string;
  transactionId?: string;
  data?: string;
}

Possible ResultActionCode values are: SUCCESS, FAILURE, ERROR, CANCELLED, and COMPLETED.

getBrowserData()

  • getBrowserData() returns an object with the following interface:
interface BrowserDataInterface {
  browserJavaEnabled: boolean;
  browserJavascriptEnabled: boolean;
  browserLanguage: string;
  browserScreenWidth: number;
  browserScreenHeight: number;
  browserColorDepth: number;
  browserUserAgent: string;
  browserTZ: number; // in minutes
}

showProcessingScreen()

  • showProcessingScreen(cardType: CardType) displays processing screen with predefined mode property processingScreenMode and optional processingScreenWrapperElementId.
export enum CardType {
  MASTER_CARD = 'MASTERCARD',
  VISA = 'VISA',
};

hideProcessingScreen()

  • hideProcessingScreen() hides processing screen.
1.2.255

8 months ago

1.2.256

7 months ago

1.2.251

8 months ago

1.2.253

8 months ago

1.2.252

8 months ago

1.2.244

8 months ago

1.2.246

8 months ago

1.2.245

8 months ago

1.2.248

8 months ago

1.2.247

8 months ago

1.2.249

8 months ago

1.2.239

8 months ago

1.2.243

8 months ago

1.2.240

8 months ago

1.2.242

8 months ago

1.2.241

8 months ago

1.2.235

8 months ago

1.2.237

8 months ago

1.2.236

8 months ago

1.2.238

8 months ago

1.2.233

8 months ago

1.2.232

8 months ago

1.2.234

8 months ago

1.2.231

8 months ago

1.2.230

9 months ago

1.2.229

9 months ago

1.2.222

9 months ago

1.2.221

9 months ago

1.2.224

9 months ago

1.2.223

9 months ago

1.2.226

9 months ago

1.2.225

9 months ago

1.2.228

9 months ago

1.2.227

9 months ago

1.2.220

9 months ago

1.2.219

9 months ago

1.2.217

9 months ago

1.2.218

9 months ago

1.2.210

9 months ago

1.2.213

9 months ago

1.2.212

9 months ago

1.2.215

9 months ago

1.2.214

9 months ago

1.2.216

9 months ago

1.2.207

9 months ago

1.2.209

9 months ago

1.2.202

10 months ago

1.2.201

10 months ago

1.2.204

10 months ago

1.2.203

10 months ago

1.2.205

10 months ago

1.2.199

10 months ago

1.2.198

10 months ago

1.2.192

10 months ago

1.2.194

10 months ago

1.2.193

10 months ago

1.2.196

10 months ago

1.2.195

10 months ago

1.2.197

10 months ago

1.2.189

10 months ago

1.2.188

10 months ago

1.2.187

10 months ago

1.2.191

10 months ago

1.2.190

10 months ago

1.2.178

10 months ago

1.2.179

10 months ago

1.2.175

10 months ago

1.2.181

10 months ago

1.2.180

10 months ago

1.2.182

10 months ago

1.2.185

10 months ago

1.2.184

10 months ago

1.2.186

10 months ago

1.2.169

11 months ago

1.2.168

11 months ago

1.2.170

11 months ago

1.2.172

11 months ago

1.2.171

11 months ago

1.2.174

10 months ago

1.2.173

10 months ago

1.2.167

11 months ago

1.2.166

11 months ago

1.2.165

11 months ago

1.2.164

11 months ago

1.2.158

11 months ago

1.2.157

11 months ago

1.2.159

11 months ago

1.2.161

11 months ago

1.2.160

11 months ago

1.2.162

11 months ago

1.2.147

11 months ago

1.2.148

11 months ago

1.2.155

11 months ago

1.2.152

11 months ago

1.2.151

11 months ago

1.2.154

11 months ago

1.2.153

11 months ago

1.2.145

11 months ago

1.2.144

11 months ago

1.2.146

11 months ago

1.2.117

12 months ago

1.2.138

1 year ago

1.2.137

1 year ago

1.2.133

1 year ago

1.2.135

1 year ago

1.2.130

1 year ago

1.2.129

1 year ago

1.2.128

1 year ago

1.2.127

1 year ago

1.2.126

1 year ago

1.2.120

2 years ago

0.0.0

2 years ago

1.2.106

2 years ago

1.2.112

2 years ago

1.2.114

2 years ago

1.2.116

2 years ago

1.2.115

2 years ago

1.2.118

2 years ago

1.2.108

2 years ago

1.2.119

2 years ago

1.2.104

2 years ago

1.2.97

3 years ago

1.2.100

3 years ago

1.2.103

3 years ago

1.2.102

3 years ago

1.0.0-dev

3 years ago

1.2.89

3 years ago

1.2.88

3 years ago

1.2.93

3 years ago

1.2.90

3 years ago

1.2.91

3 years ago

1.2.94

3 years ago

1.2.85

3 years ago

1.2.83

3 years ago

1.2.80

3 years ago

1.2.60

3 years ago

1.2.63

3 years ago

1.2.64

3 years ago

1.2.62

3 years ago

1.2.67

3 years ago

1.2.68

3 years ago

1.2.66

3 years ago

1.2.70

3 years ago

1.2.71

3 years ago

1.2.73

3 years ago

1.2.59

3 years ago

1.2.45

4 years ago

1.2.44

4 years ago

1.2.51

4 years ago

1.2.56

3 years ago

1.2.57

3 years ago

1.2.55

4 years ago

1.2.42

4 years ago

1.2.43

4 years ago

1.2.41

4 years ago

1.2.40

4 years ago

1.2.35

4 years ago

1.2.36

4 years ago

1.2.37

4 years ago

1.2.27

4 years ago

1.2.26

4 years ago

1.2.29

4 years ago

1.2.31

4 years ago

1.2.2

4 years ago

1.2.10

4 years ago

1.2.16

4 years ago

1.2.18

4 years ago

1.2.23

4 years ago

1.2.22

4 years ago

1.2.25

4 years ago

1.1.29

4 years ago

1.1.28

4 years ago

1.1.30

4 years ago

1.1.31

4 years ago

1.1.16

4 years ago

1.1.19

4 years ago

1.1.17

4 years ago

1.1.23

4 years ago

1.1.22

4 years ago

1.1.21

4 years ago

1.1.20

4 years ago

1.1.27

4 years ago

1.1.26

4 years ago

1.1.25

4 years ago

1.1.24

4 years ago

1.1.11

4 years ago

1.1.10

4 years ago

1.1.14

4 years ago

1.1.5

4 years ago

1.1.4

4 years ago

1.0.180

4 years ago

1.0.176

4 years ago

1.0.177

4 years ago

1.0.174

4 years ago

1.0.179

4 years ago

1.0.170

4 years ago

1.1.0

4 years ago

1.0.166

4 years ago

1.0.164

4 years ago

1.0.154

4 years ago

1.0.151

4 years ago

1.0.145

4 years ago

1.0.141

4 years ago

1.0.139

4 years ago

1.0.136

4 years ago

1.0.135

4 years ago

1.0.134

4 years ago

1.0.133

4 years ago

1.0.131

4 years ago

1.0.130

4 years ago

1.0.129

4 years ago

1.0.127

4 years ago

1.0.121

4 years ago

1.0.119

4 years ago

1.0.115

4 years ago

1.0.107

4 years ago

1.0.108

4 years ago

1.0.105

4 years ago

1.0.103

4 years ago

1.0.102

4 years ago

1.0.104

4 years ago

1.0.100

4 years ago

1.0.90

4 years ago

1.0.88

4 years ago

1.0.89

4 years ago

1.0.84

4 years ago

1.0.83

4 years ago

1.0.86

4 years ago

1.0.81

4 years ago

1.0.73

4 years ago

1.0.72

4 years ago

1.0.77

4 years ago

1.0.79

4 years ago

1.0.78

4 years ago

1.0.61

4 years ago

1.0.60

4 years ago

1.0.56

4 years ago

1.0.48

4 years ago

1.0.46

4 years ago

1.0.51

4 years ago

1.0.50

4 years ago

1.0.53

4 years ago

1.0.52

4 years ago

1.0.39

4 years ago

1.0.38

4 years ago

1.0.37

4 years ago

1.0.36

4 years ago

1.0.35

4 years ago

1.0.34

4 years ago

1.0.28

4 years ago

1.0.33

4 years ago

1.0.32

4 years ago

1.0.31

4 years ago

1.0.30

4 years ago

1.0.26

4 years ago

1.0.25

4 years ago

1.0.24

4 years ago

1.0.23

4 years ago

1.0.19

4 years ago

1.0.22

4 years ago

1.0.18

4 years ago

1.0.17

4 years ago

1.0.16

4 years ago

1.0.15

4 years ago

1.0.14

4 years ago

1.0.13

4 years ago