A Checkout Session is a short-lived object that creates a hosted checkout page for collecting payments on your behalf. Use it to accept payments quickly without building your own payment UI. You control what the customer is paying for, the amount, allowed payment methods, and where to return the customer after payment.

​
When to use Checkout Session

  • You want a fast, secure way to accept payments with minimal UI work
  • You need a hosted page that supports multiple payment methods out-of-the-box
  • You want Monime to handle payment state, redirection, and receipt UI

​
How it works

1

Create a Checkout Session (server)

Your server calls the API to create a session with amount, currency, and options.
2

Redirect customer

Redirect the customer to the hosted checkout URL returned in the session.
3

Customer pays

The customer completes payment on Monime’s secure page.
4

Webhook + Return URL

Receive payment status via webhook and/or redirect back to your site.

​
Quick start

Create Session API

Create a new checkout session from your backend

Retrieve Session

Look up a session to check its latest status

List Sessions

Browse sessions for reporting or debugging

​
Key session fields

​
Webhooks

We recommend handling payment lifecycle events using webhooks to ensure your system is updated even if the customer closes the browser before redirecting.

Webhook Overview

Learn how webhooks work on Monime

HMAC Verification

Verify webhook signatures securely

​
Environments: Test vs Live

Use Test mode for development and Live for production. Tokens, behavior, and prefixes differ between environments.
See API Basics → Environments and Standard Headers for details.

​
Next steps

Build with Next.js

End-to-end example using Next.js API routes

API Reference

Explore the Checkout Session object and full API