Build with TabEdge
Accept payments using TabEdge hosted checkout. Create sessions from your server, redirect customers securely, and verify payment status through the API.
Manage API KeysIntegration Quickstart
1. Prepare your Business
Complete Business onboarding and payment readiness requirements in your TabEdge dashboard.
2. Generate an API Key
Open API Keys in your dashboard, select the Business, and generate a key for its environment. Store the secret securely on your server.
3. Configure Redirect Domains
Open Developer Settings and add the domains used by your success and cancellation URLs.
4. Create a Checkout Session
Send a server-side POST request with the payment amount, currency, description, and redirect URLs.
5. Redirect the Customer
Use the checkoutUrl returned by TabEdge to send the customer to the hosted checkout page.
6. Verify Payment
Retrieve the checkout status from your backend. Do not treat a browser redirect alone as proof of payment.
Create Your First Checkout
This example creates a USD 25.00 checkout session. Run it only from your backend and replace the placeholders with your own values.
curl -X POST https://www.tabedge.com/api/platform/v1/checkout-sessions \
-H "Authorization: Bearer tb_sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"amountCents": 2500,
"currency": "usd",
"description": "Order #1001",
"successUrl": "https://merchant.example/success",
"cancelUrl": "https://merchant.example/cancel",
"merchantReference": "ORDER-1001"
}'Successful Response — HTTP 200
{
"checkoutId": "CHECKOUT_ID",
"checkoutUrl": "https://www.tabedge.com/checkout/CHECKOUT_ID"
}Important Security Requirements
Keep secret API keys on your server. Configure allowed redirect domains before creating checkout sessions. Always verify payment status server-side before fulfilling an order.