Skip to main content

​
Overview

This page explains how to prepare your environment and obtain credentials to start building with Forebit Payments API.

​
Prerequisites

  • Business ID and API key from Payments → Settings → Developer
  • Webhook signing secret (Developer → Webhooks)
  • A server capable of receiving webhooks (public URL for production)

​
Base URL

https://prod-payments-api.forebit.io

​
Environment variables

# Payments
FOREBIT_PAYMENTS_API_KEY=your_payments_api_key
FOREBIT_PAYMENTS_BASE_URL=https://prod-payments-api.forebit.io

# Webhooks
FOREBIT_WEBHOOK_SECRET=whsec_...

​
First request

Create a test payment to verify your setup: 
curl -X POST https://prod-payments-api.forebit.io/v1/businesses/{businessId}/payments \
  -H "Authorization: Bearer $FOREBIT_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "USD",
    "amount": 1.00
  }'
A successful response returns the payment id and checkout url: 
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "url": "https://pay.forebit.io/payment/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "message": null,
  "errors": null
}

​
Webhooks

Verify webhooks with Svix using the raw request body. Required headers: svix-id, svix-timestamp, svix-signature. See: Svix — Verifying Payloads

​
Next steps

Integration Guide

Webhooks

Payments API

Guide for AI Agents

Paste into Claude, Cursor, or Codex to build your integration faster