Without User Interface

Learn how to use our SDK in Javascript to allow integrations with our Deposits APIs

Getting started

Installation

Load D24 as a npm module

Install the D24.js from the npm public registry.

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

<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


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

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

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

constructor(publicKey, options)

Parameters

Parameter
Type
Description
Required
Possible values

publicKey

string

Public key provided by D24

true

-

options

object

Options

true

-

options.environment

string

Environment

true

stg, production

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

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

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 library is used, therefore the errors returned at the frontend level are generated with said library.

Parameters

Parameter
Type
Description
Required
Example

card

object

Credit card values

true

-

card.number

string

Credit card number

true

4509953566233704

card.holder

string

Credit card holder

true

Juan Perez

card.cvv

string

Credit card security code. Must be 3 digits, except for AMEX which are 4

true

123, 1234

card.expirationMonth

string

Credit card expiration month. Must be 2 digits

true

11

card.expirationYear

string

Credit card expiration year. Must be 2 digits

true

25

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 😎

Without User Interface

Last updated