Paybytoken developer docs

Stablecoin checkout,
built into your product.

Create the order once. Present it through hosted, embedded, or custom checkout. Fulfill only after a verified event.

Hosted + embedded + customUSDC + USDTServer-verified events

checkout.tsServer

import Paybytoken from '@paybytoken/node'

const paybytoken = new Paybytoken(process.env.PAYBYTOKEN_SECRET_KEY!)

const session = await paybytoken.checkoutSessions.create({
  currency: 'usd',
  line_items: order.items,
  ui_mode: 'embedded',
  allowed_origin: 'https://shop.example.com',
})

● Browser-scoped session created201

One session, three surfaces

Choose who owns the checkout UI.

Move between Paybytoken-hosted, embedded, and fully custom experiences without changing your order model or payment lifecycle.

01Fastest launch

Hosted checkout

Create a Checkout Session on your server and redirect to a secure, responsive Paybytoken page.

Start with hosted

02Native experience

Embedded checkout

Mount the same stablecoin payment flow inside your product with the browser or React SDK.

Build embedded

03Full UI ownership

Custom checkout

Use a server-created session while you design token selection and transfer instructions in your own interface.

Own the interface

One payment lifecycle

Change the surface, not the architecture.

Every checkout starts server-side and finishes with the same verifiable event, whichever customer experience you choose.

01
Your server
Create
Resolve the order and create one short-lived session.
02
Your checkout
Present
Open hosted, mount embedded, or render your custom UI.
03
Payment rail
Monitor
Paybytoken watches the network and updates payment state.
04
Your webhook
Fulfill
Verify the signed event and fulfill the order exactly once.

Understand session states Implement signed webhooks

Secure by design

Keep the payment boundary clear.

Your secret key and authoritative order stay on the server. The browser receives only a short-lived credential scoped to one Checkout Session and one exact merchant origin.

Read the security model →