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

7 months ago

1.2.256

7 months ago

1.2.251

7 months ago

1.2.253

7 months ago

1.2.252

7 months ago

1.2.244

7 months ago

1.2.246

7 months ago

1.2.245

7 months ago

1.2.248

7 months ago

1.2.247

7 months ago

1.2.249

7 months ago

1.2.239

7 months ago

1.2.243

7 months ago

1.2.240

7 months ago

1.2.242

7 months ago

1.2.241

7 months ago

1.2.235

7 months ago

1.2.237

7 months ago

1.2.236

7 months ago

1.2.238

7 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

8 months ago

1.2.229

8 months ago

1.2.222

8 months ago

1.2.221

8 months ago

1.2.224

8 months ago

1.2.223

8 months ago

1.2.226

8 months ago

1.2.225

8 months ago

1.2.228

8 months ago

1.2.227

8 months ago

1.2.220

8 months ago

1.2.219

8 months ago

1.2.217

8 months ago

1.2.218

8 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

8 months ago

1.2.207

9 months ago

1.2.209

9 months ago

1.2.202

9 months ago

1.2.201

9 months ago

1.2.204

9 months ago

1.2.203

9 months ago

1.2.205

9 months ago

1.2.199

9 months ago

1.2.198

9 months ago

1.2.192

9 months ago

1.2.194

9 months ago

1.2.193

9 months ago

1.2.196

9 months ago

1.2.195

9 months ago

1.2.197

9 months ago

1.2.189

9 months ago

1.2.188

9 months ago

1.2.187

9 months ago

1.2.191

9 months ago

1.2.190

9 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

9 months ago

1.2.184

9 months ago

1.2.186

9 months ago

1.2.169

10 months ago

1.2.168

10 months ago

1.2.170

10 months ago

1.2.172

10 months ago

1.2.171

10 months ago

1.2.174

10 months ago

1.2.173

10 months ago

1.2.167

10 months ago

1.2.166

10 months ago

1.2.165

10 months ago

1.2.164

10 months ago

1.2.158

10 months ago

1.2.157

10 months ago

1.2.159

10 months ago

1.2.161

10 months ago

1.2.160

10 months ago

1.2.162

10 months ago

1.2.147

11 months ago

1.2.148

11 months ago

1.2.155

10 months ago

1.2.152

10 months ago

1.2.151

11 months ago

1.2.154

10 months ago

1.2.153

10 months ago

1.2.145

11 months ago

1.2.144

11 months ago

1.2.146

11 months ago

1.2.117

11 months ago

1.2.138

11 months ago

1.2.137

12 months 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

3 years ago

1.2.56

3 years ago

1.2.57

3 years ago

1.2.55

3 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