Trio Checkout SDK Example

This project demonstrates how to integrate the Trio Checkout SDK using:

A local Node.js backend (server.js)
A local frontend (index.html)
Python HTTP Server for frontend hosting

Requirements

Before starting, make sure you have installed:

Node.js (v18+ recommended)
npm
Python 3

Project Structure

local-example/
├── server.js
├── package.json
└── index.html

1. Install Backend Dependencies

Create a package.json file:

npm init -y

Install the required dependencies:

npm install express cors

2. Configure Credentials

Inside server.js, replace the following values:

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

With your Trio Sandbox credentials.

3. Run the Backend Server

Start the server using:

node server.js

You should see:

Servidor rodando na porta 3000

The backend will now be available at:

http://localhost:3000

4. Run the Frontend Locally

The frontend uses the browser SDK and must be served through an HTTP server. Open a new terminal in the project folder and run:

python3 -m http.server 8080

If python3 does not work, try:

python -m http.server 8080

The frontend will now be available at:

http://localhost:8080

5. Open the Application

Open your browser and access:

http://localhost:8080

How It Works

The frontend collects:
- Transaction type
- CPF
- Amount
The frontend sends a request to:

POST http://localhost:3000/create-session

The backend creates a Trio Checkout Session using the Trio API.
The backend returns the session_id.
The frontend initializes the Trio SDK:

Trio.create({
  environment: "sandbox",
  session: session_id
});

The checkout modal opens automatically.

Available Transaction Types

payin
payout

Sandbox Environment

This example uses the Trio Sandbox API:

https://api.sandbox.trio.com.br

Important Notes

Make sure port 3000 is available for the backend.
Make sure port 8080 is available for the frontend.
CORS is enabled in the backend for local development.
Never expose production credentials publicly.

Example Request Payload

{
  "type": "payin",
  "cpf": "12345678900",
  "amount": 15000
}

Amount must be sent in cents. Example:

150.00 BRL = 15000

Troubleshooting

Port already in use

Change the port in server.js:

const PORT = 3000;

And update the frontend request URL if necessary.

Python command not found

Install Python 3 or use:

python3 -m http.server 8080

CORS errors

Ensure the backend server is running before opening the frontend.

Support

For integration support, contact:

Download Example Project

You can download the complete local example project here: Download the ZIP file The ZIP package includes:

server.js
index.html
Local backend example
Frontend checkout example
SDK integration example

Getting started

Developers

Trio SDK

Webhooks

Local example

Trio Checkout SDK Example

Requirements

Project Structure

1. Install Backend Dependencies

2. Configure Credentials

3. Run the Backend Server

4. Run the Frontend Locally

5. Open the Application

How It Works

Available Transaction Types

Sandbox Environment

Important Notes

Example Request Payload

Troubleshooting

Port already in use

Python command not found

CORS errors

Support

Download Example Project

​Trio Checkout SDK Example

​Requirements

​Project Structure

​1. Install Backend Dependencies

​2. Configure Credentials

​3. Run the Backend Server

​4. Run the Frontend Locally

​5. Open the Application

​How It Works

​Available Transaction Types

​Sandbox Environment

​Important Notes

​Example Request Payload

​Troubleshooting

​Port already in use

​Python command not found

​CORS errors

​Support

​Download Example Project

Trio Checkout SDK Example

Requirements

Project Structure

1. Install Backend Dependencies

2. Configure Credentials

3. Run the Backend Server

4. Run the Frontend Locally

5. Open the Application

How It Works

Available Transaction Types

Sandbox Environment

Important Notes

Example Request Payload

Troubleshooting

Port already in use

Python command not found

CORS errors

Support

Download Example Project