@basis-theory/basis-theory-js
v4.14.0
Published
[![Version](https://img.shields.io/npm/v/@basis-theory/basis-theory-js.svg)](https://www.npmjs.org/package/@basis-theory/basis-theory-js) [![Downloads](https://img.shields.io/npm/dm/@basis-theory/basis-theory-js.svg)](https://www.npmjs.org/package/@basis-
Downloads
104,123
Maintainers
Keywords
Readme
Basis Theory JS SDK (aka BasisTheory.js)
The Basis Theory JS SDK
Installation
Using Node Package Manager
npm install --save @basis-theory/basis-theory-js
Using Yarn
yarn add @basis-theory/basis-theory-js
Documentation
For a complete list of endpoints and examples, please refer to our API docs
Usage
Initialization
import { BasisTheory } from '@basis-theory/basis-theory-js';
const bt = await new BasisTheory().init('<API Key>'); // replace with your application key
Per-request configuration
All of the service methods accept an optional RequestOptions
object. This is used if you want to set a per-request BT-TRACE-ID
, BT-API-KEY
and/or BT-IDEMPOTENCY-KEY
.
import { v4 as uuid } from 'uuid';
await bt.applications.list(
{},
{
apiKey: '<Management API Key>',
correlationId: 'aa5d3379-6385-4ef4-9fdb-ca1341572153',
idempotencyKey: 'bb5d3379-6385-4ef4-9fdb-ca1341572154',
}
);
await bt.tokens.create(
{
type: "token",
data: "Sensitive Value",
},
{
apiKey: '<API Key>',
correlationId: 'aa5d3379-6385-4ef4-9fdb-ca1341572153',
idempotencyKey: 'bb5d3379-6385-4ef4-9fdb-ca1341572154',
}
);
Setting a custom API Url
You can set a custom API Url to be used across all clients when creating a new SDK instance.
import { BasisTheory } from '@basis-theory/basis-theory-js';
const bt = await new BasisTheory().init('<API Key>', {
apiBaseUrl: 'https://api.somedomain.com',
}); // replace with your application key and api base URL.
Elements
Please, refer to the Elements Documentation on how to use it.
Development
The provided scripts with the SDK will check for all dependencies, start docker, build the solution, and run all tests.
Dependencies
- Docker
- Docker Compose
- NodeJS > 10.12.0
- Yarn
Build the SDK and run Tests
Run the following command from the root of the project:
make verify