3DS 网络

[叹息] 这个SDK已经贬值了.

我们的新SDK可以在 https://github.com/Basis-Theory/web-teads 互联网档案馆的存檔,存档日期2013-12-22

更多信息请查看我们的文献网站. https://developers.basistheory.com/docs/sdks/web/3ds (中文(简体) )

概览

3DS-Web SDK是一个JavaScript/TypeScript库,旨在简化网络应用程序中3DS(3D Security)认证程序的实施. 它为处理3DS进程的会话创建和质疑步骤提供了简化的界面.

3DS-Web SDK主要暴露出两种方法: createSession 财务报告和审定财务报表 startChallenge这些方法有助于启动和处理3DS会议和挑战.

方法

createSession

createSession({ pan }: Create3dsSessionRequest): Promise<Create3dsSessionResponse>

这种方法启动一个3DS会话,用提供的 PAN(Prime Account Number)向服务器提出请求. 它返回一个解析 Creat3dsSessionResponse 对象的保证,其中包含会话细节 .

startChallenge

startChallenge(options: ThreeDSChallengeRequest): Promise<void>

这种方法通过向ACS(Access Control Server)提出附带必要参数的请求开始3DS挑战. 它处理挑战过程并回报一个承诺.

用法实例

创建 3DS 会话

import { BasisTheory3ds } from '3ds-web';

const apiKey = 'your_api_key';
const { createSession } = BasisTheory3ds(apiKey);

const session = await createSession({
  pan: '<BASIS_THEORY_TOKEN_ID>',
});

开始挑战

import { BasisTheory3ds } from '3ds-web';

const apiKey = 'your_api_key';
const { startChallenge } = BasisTheory3ds(apiKey);

await startChallenge({
  sessionId: 'session_id',
  acsTransactionId: 'acs_transaction_id',
  acsChallengeUrl: 'acs_challenge_url',
  threeDSVersion: '2.2.0',
  windowSize: '05', // Optional, defaults to 'THREE'
});

配置选项

挑战请求

challengeContainerOptions 允许您自定义 id 3DS 挑战容器的属性,这样您就可以使用 CSS 设定目标并应用样式。 它可以使3DS挑战界面在您的应用的布局中精确定位.

const { startChallenge } = BasisTheory3ds(apiKey, {
  challengeConfigurationOptions: {
    id: 'customId',
  },
});