Getting Started

Introduction

ExpressPayments.ai is a single API to accept payments, run subscriptions, send invoices, and grow internationally. This guide will get you to your first charge in under five minutes.

Every endpoint accepts and returns JSON. All requests are authenticated with a secret API key passed via HTTP basic auth. Test mode and live mode are isolated — keys, data, and webhooks are separate.

Install the SDK

terminal

npm install @expresspayments/node
# or
bun add @expresspayments/node

Make your first charge

Initialize the client with your secret key and create a charge for $24.00 USD on a test token:

charge.ts

import ExpressPayments from "@expresspayments/node";

const ep = new ExpressPayments(process.env.EP_SECRET_KEY!);

const charge = await ep.charges.create({
  amount: 2400,
  currency: "usd",
  source: "tok_visa",
  description: "Order ord_18c",
});

console.log(charge.id); // ch_3Pq8...

Next steps

Continue to the quickstart to wire up the full checkout flow, or jump to authentication to learn how API keys, webhook signatures, and Connect tokens work.