1.2.256 • Published 4 months ago

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

Weekly downloads
-
License
-
Repository
-
Last release
4 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

4 months ago

1.2.256

4 months ago

1.2.251

4 months ago

1.2.253

4 months ago

1.2.252

4 months ago

1.2.244

4 months ago

1.2.246

4 months ago

1.2.245

4 months ago

1.2.248

4 months ago

1.2.247

4 months ago

1.2.249

4 months ago

1.2.239

5 months ago

1.2.243

4 months ago

1.2.240

5 months ago

1.2.242

4 months ago

1.2.241

4 months ago

1.2.235

5 months ago

1.2.237

5 months ago

1.2.236

5 months ago

1.2.238

5 months ago

1.2.233

5 months ago

1.2.232

5 months ago

1.2.234

5 months ago

1.2.231

5 months ago

1.2.230

5 months ago

1.2.229

5 months ago

1.2.222

5 months ago

1.2.221

6 months ago

1.2.224

5 months ago

1.2.223

5 months ago

1.2.226

5 months ago

1.2.225

5 months ago

1.2.228

5 months ago

1.2.227

5 months ago

1.2.220

6 months ago

1.2.219

6 months ago

1.2.217

6 months ago

1.2.218

6 months ago

1.2.210

6 months ago

1.2.213

6 months ago

1.2.212

6 months ago

1.2.215

6 months ago

1.2.214

6 months ago

1.2.216

6 months ago

1.2.207

6 months ago

1.2.209

6 months ago

1.2.202

6 months ago

1.2.201

6 months ago

1.2.204

6 months ago

1.2.203

6 months ago

1.2.205

6 months ago

1.2.199

6 months ago

1.2.198

6 months ago

1.2.192

6 months ago

1.2.194

6 months ago

1.2.193

6 months ago

1.2.196

6 months ago

1.2.195

6 months ago

1.2.197

6 months ago

1.2.189

7 months ago

1.2.188

7 months ago

1.2.187

7 months ago

1.2.191

7 months ago

1.2.190

7 months ago

1.2.178

7 months ago

1.2.179

7 months ago

1.2.175

7 months ago

1.2.181

7 months ago

1.2.180

7 months ago

1.2.182

7 months ago

1.2.185

7 months ago

1.2.184

7 months ago

1.2.186

7 months ago

1.2.169

7 months ago

1.2.168

7 months ago

1.2.170

7 months ago

1.2.172

7 months ago

1.2.171

7 months ago

1.2.174

7 months ago

1.2.173

7 months ago

1.2.167

7 months ago

1.2.166

7 months ago

1.2.165

7 months ago

1.2.164

7 months ago

1.2.158

8 months ago

1.2.157

8 months ago

1.2.159

8 months ago

1.2.161

7 months ago

1.2.160

8 months ago

1.2.162

7 months ago

1.2.147

8 months ago

1.2.148

8 months ago

1.2.155

8 months ago

1.2.152

8 months ago

1.2.151

8 months ago

1.2.154

8 months ago

1.2.153

8 months ago

1.2.145

8 months ago

1.2.144

8 months ago

1.2.146

8 months ago

1.2.117

8 months ago

1.2.138

9 months ago

1.2.137

9 months ago

1.2.133

11 months ago

1.2.135

10 months ago

1.2.130

11 months ago

1.2.129

11 months ago

1.2.128

11 months ago

1.2.127

1 year ago

1.2.126

1 year ago

1.2.120

1 year 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

2 years ago

1.2.100

2 years ago

1.2.103

2 years ago

1.2.102

2 years ago

1.0.0-dev

2 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

3 years ago

1.2.44

3 years ago

1.2.51

3 years ago

1.2.56

3 years ago

1.2.57

3 years ago

1.2.55

3 years ago

1.2.42

3 years ago

1.2.43

3 years ago

1.2.41

3 years ago

1.2.40

3 years ago

1.2.35

3 years ago

1.2.36

3 years ago

1.2.37

3 years ago

1.2.27

3 years ago

1.2.26

3 years ago

1.2.29

3 years ago

1.2.31

3 years ago

1.2.2

3 years ago

1.2.10

3 years ago

1.2.16

3 years ago

1.2.18

3 years ago

1.2.23

3 years ago

1.2.22

3 years ago

1.2.25

3 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