Getting Started Guides API Reference Bag Documentation

Introduction Quickstart Authentication & API Keys Environments: Sandbox vs. Production Core Concepts

Create a Payment Link Build a Custom Checkout Handle Webhooks Securely Accept Payments on Multiple Chains Calculate Tax Before Checkout Test Payments End-to-End Go Live Checklist Set Up Agentic Payments (X402)

Complete KYB Verification Supported Countries & Restrictions Understand Tax Handling Request a Payout Understand FIRA & Cross-Border Settlement

TypeScript SDK Python (REST Examples)Other Languages

Error Codes Rate Limits

Guides

Go Live Checklist

Everything to verify before switching from sandbox to production.

Go Live Checklist

This page is under construction. Check back soon, or reach out to us if you need help with this topic now.

When you're ready to accept real payments, you'll need to:

Complete KYB verification
Generate a live API key (bag_live_sk_*)
Switch your network values from testnet to mainnet
Verify your webhook endpoint is production-ready
Test with a small real payment

See Environments for details on the sandbox-to-production transition.

Test Payments End-to-End

Walk through a full payment in the sandbox using testnet USDC.

Set Up Agentic Payments (X402)

Paywall any API endpoint using the X402 protocol for machine-to-machine payments.

On this page

Go Live Checklist