The JavaScript SDK helps you to communicate with the Worldline Connect Client API. Its primary features are:
- handling of all the details concerning the encryption of the payment details,
- convenient JavaScript wrapper around the API calls and responses,
- localization of various labels and messages,
- user-friendly formatting (masking) of payment data such as card numbers and expiry dates,
- validation of input
- check to determine to which payment provider a card number is associated.
See the Worldline Global Collect Developer Hub for more information on how to use the SDK.
Minimal browser versions:
- Chrome 69+
- Chrome mobile 87+
- Safari 13.1+
- Safari mobile 14+
- MS Edge 90+
- MS Edge mobile 103+
- Firefox 78+
- Opera 85+
- Samsung mobile 7.4+
⚠ Please note that all examples have been moved to their own repository.
Install this SDK using your preferred node package manager npm, yarn, pnpm or Bun.
npm install connect-sdk-client-jsThe SDK can be used AS UMD, CJS or ESM module.
The SDK is available under global namespace connectsdk and can be used in the following way:
app.js
const sessionDetails = {
/* ... */
};
// We can access the SDK via the global namespace `window.connectsdk`
const session = new window.connectsdk.Session(sessionDetails);index.html
<!doctype html>
<html lang="en">
<head>
<title>Example UMD</title>
<script
defer
src="./node_modules/connect-sdk-client-js/dist/connect-sdk-client-js.umd.js"
></script>
<script defer src="./app.js"></script>
</head>
</html>import { Session, type SessionDetails } from 'connect-sdk-client-js';
const sessionDetails: SessionDetails = {
/* ... */
};
const session = new Session(sessionDetails);const { Session } = require('connect-sdk-client-js');
/**
* @type {import('connect-sdk-client-js').SessionDetails}
*/
const sessionDetails = {
/* ... */
};
const session = new Session(sessionDetails);This repository uses microbundle to build the SDK. You can build the sdk by running the following commands:
npm run buildThe result of the build will have been written to the dist folder. This folder will contain the following files:
/dist/types- Directory containing all type declaration file. Theindex.d.tsis set as main file for the exported package, seepackage.json:typesproperty./dist/connect-sdk-client-js.js- The compiled TypeScript as ESM module. This file will be when using ESM, seepackage.json:moduleproperty./dist/connect-sdk-client-js.umd.js- The compiled TypeScript as UMD module. This file can be used when you want to use the library as UMD, seepackage.json:unpkgproperty./dist/connect-sdk-client-js.cjs- The compiled TypeScript as CommonJS module. This file can be used when you want to use the library as CommonJS, seepackage.json:mainproperty.
This library contains unit- and integration tests written with Vitest.
By default Vitest starts in watch mode when starting locally and run mode when running in CI (when environment var CI is set), see documentation.
| Command | Description |
|---|---|
npm run test |
Run unit tests |
npm run test:integration |
Run integration tests |