# Without User Interface

## Getting started

### Installation

#### Load D24 as a npm module

Install the D24.js from the npm public registry.

```bash
npm install @d24/sdk-minimal
```

or

#### Manually load the D24.js script

Add the D24.js module as a script in the of your app HTML

```markup
<script type="module" src="https://d24sdk.s3.amazonaws.com/releases/d24-minimal-1.0.19.es.js"></script>
```

### How to use

#### Instantiation

First of all, we must instantiate the SDK.

Keep in mind that the SDK can be instantiated only once, and it is a requirement to be able to use all its methods.

In order to instantiate the SDK we need to specify the public key and the environment.

* npm

```javascript

import SDK from '@d24/sdk-minimal';

new SDK('as1i2nxal12bvd', {environment: 'stg'});
```

* umd&#x20;

```javascript
new window.D24.SDK('as1i2nxal12bvd', {environment: 'stg'});
```

**constructor(publicKey, options)**

**Parameters**

<table><thead><tr><th width="213">Parameter</th><th width="176">Type</th><th>Description</th><th>Required</th><th>Possible values</th></tr></thead><tbody><tr><td>publicKey</td><td>string</td><td>Public key provided by us</td><td>true</td><td>-</td></tr><tr><td>options</td><td>object</td><td>Options</td><td>true</td><td>-</td></tr><tr><td>options.environment</td><td>string</td><td>Environment</td><td>true</td><td><code>stg</code>, <code>production</code></td></tr></tbody></table>

#### Tokenization a credit card

Once we instantiate the SDK, we can tokenize a card, said token will be used later to send it to the backend and generate the payment through an endpoint.

* npm

```javascript
import {generateToken} from '@d24/sdk-minimal';

const creditCard = {
    number: '4509953566233704',
    holder: 'Juan Perez',
    cvv: '123',
    expirationMonth: '11',
    expirationYear: '25',
}

const response = await generateToken({card: creditCard});
const token = response.token;
```

* umd

```javascript
const creditCard = {
  number: '4509953566233704',
  holder: 'Juan Perez',
  cvv: '123',
  expirationMonth: '11',
  expirationYear: '25',
}

const response = await window.D24.generateToken({card: creditCard});
const token = response.token;
```

## API

#### Possible errors

| Error                                                   | Explanation                                                                                                |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| SDK was already instantiate.                            | The SDK has already been instantiated and you are trying to instantiate it again                           |
| The environment \[config.environment] is not supported. | The environment you passed to the constructor is not valid, remember that it only accepts "test" or "prod" |

### generateToken({card}): Promise<{token: string}>

This method validates that the card data is correct and generates a token. Although it has validations that occur at the frontend level, it uses a D24 endpoint to be able to generate the token which executes additional validations.

To validate the data structure, the [joi](https://joi.dev/api/?v=17.9.1#errors) library is used, therefore the errors returned at the frontend level are generated with said library.

#### Parameters

<table><thead><tr><th width="234">Parameter</th><th>Type</th><th width="278">Description</th><th>Required</th><th>Example</th></tr></thead><tbody><tr><td>card</td><td>object</td><td>Credit card values</td><td>true</td><td>-</td></tr><tr><td>card.number</td><td>string</td><td>Credit card number</td><td>true</td><td>4509953566233704</td></tr><tr><td>card.holder</td><td>string</td><td>Credit card holder</td><td>true</td><td>Juan Perez</td></tr><tr><td>card.cvv</td><td>string</td><td>Credit card security code. Must be 3 digits, except for AMEX which are 4</td><td>true</td><td>123, 1234</td></tr><tr><td>card.expirationMonth</td><td>string</td><td>Credit card expiration month. Must be 2 digits</td><td>true</td><td>11</td></tr><tr><td>card.expirationYear</td><td>string</td><td>Credit card expiration year. Must be 2 digits</td><td>true</td><td>25</td></tr></tbody></table>

#### Possible errors

| Error                                                          | Explanation                                                            |
| -------------------------------------------------------------- | ---------------------------------------------------------------------- |
| You must instantiate D24CreditCardSDK before using SDK methods | You executed the method without having previously instantiated the SDK |

## Deposit Creation

To learn who to use the Cards SDK Without User Interface within the Deposit Creation, please visit de page below of our Knowledge Base :sunglasses:

{% content-ref url="/pages/2YOaKheDYzkTqbaiykan" %}
[Without User Interface](/knowledge-base/deposits-with-cards-sdk/without-user-interface.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.onekeypayments.com/deposits-tools/cards-sdk/without-user-interface.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.