SDK Methods

LiteCheckout Constructor

Creates a new instance of the LiteCheckout class with the necessary configuration for secure payment processing. This constructor establishes the connection with Tonder’s services and configures the payment environment.

`LiteCheckout` Parameter Table

Parameter	Type	Description	Required
`apiKey`	`String`	Your Tonder API key for authentication.	Yes
`returnUrl`	`String`	URL where the checkout form is mounted (used for 3DS redirect completion).	No
`mode`	`String`	Operating environment mode. Options: ‘product’ or ‘stage’.	No

Here’s an example of how to initialize the LiteCheckout class:

const liteCheckout = new LiteCheckout({
  apiKey: "YOUR_API_KEY",
  returnUrl: "YOUR_RETURN_URL",
  mode: "stage"
});

configureCheckout(config)

Sets customer email and the secure token required for card management operations.

Parameter	Type	Description
config	Object	Configuration object with customer email and secure token

Here’s an example:

liteCheckout.configureCheckout({
  customer: {
    email: "example@email.com",
    secureToken: "e89eb18.." // Required for card management features
  }
});

payment(checkoutData)

Processes a payment transaction securely using the provided checkoutData collected from your custom UI.

Parameter	Type	Description
checkoutData	object	Customer, cart, and card information for the transaction

const response = await liteCheckout.payment({
  customer: { firstName: "Juan", email: "juan.hernandez@mail.com" },
  cart: { total: "399.00", items: [ /* ... */ ] },
  currency: "MXN",
  card: {
    card_number: "4111111111111111",
    cvv: "123",
    expiration_month: "12",
    expiration_year: "25",
    cardholder_name: "John Doe"
  }
});

getCustomerCards()

Retrieves a list of saved cards for the configured customer.

Parameter	Type	Description
None	-	This method takes no parameters

const cards = await liteCheckout.getCustomerCards();
console.log("Saved cards:", cards);

saveCustomerCard(cardData)

Securely tokenizes and saves new card details for the customer.

Parameter	Type	Description
cardData	Object	Card information to be saved

const response = await liteCheckout.saveCustomerCard({
  card_number: "4111111111111111",
  cvv: "123",
  expiration_month: "12",
  expiration_year: "25",
  cardholder_name: "John Doe"
});

removeCustomerCard(cardId)

Deletes a previously saved card using its unique ID.

Parameter	Type	Description
cardId	String	Unique identifier of the card to remove

await liteCheckout.removeCustomerCard("card_abc123");

verify3dsTransaction()

Verifies the status of a 3D Secure (3DS) transaction. This method should be called to handle the redirect return from a 3DS challenge.

Parameter	Type	Description
None	-	This method takes no parameters.

// The response status will be one of: ['Declined', 'Cancelled', 'Failed', 'Success', 'Pending', 'Authorized']
const response = await liteCheckout.verify3dsTransaction();
console.log("Verify 3ds response", response);

SDK Overview

Web SDKs

Mobile SDKs

Core Methods

Method Details

`LiteCheckout` Parameter Table

Next Steps

​Core Methods

​Method Details

​LiteCheckout Parameter Table

​Next Steps

Core Methods

Method Details

`LiteCheckout` Parameter Table

Next Steps