> ## Documentation Index
> Fetch the complete documentation index at: https://developer.forebit.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Development

> Set up your environment and start integrating Forebit APIs

## 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

```text theme={null}
https://prod-payments-api.forebit.io
```

## Environment variables

```bash theme={null}
# 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:

```bash theme={null}
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`:

```json theme={null}
{
  "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](https://docs.svix.com/receiving/verifying-payloads/how)

## Next steps

<CardGroup cols={2}>
  <Card title="Integration Guide" icon="rocket" href="/payments/integration" />

  <Card title="Webhooks" icon="bolt" href="/payments/webhooks" />

  <Card title="Payments API" icon="book" href="/payments/introduction" />

  <Card title="Guide for AI Agents" icon="robot" href="/llms-full">
    Paste into Claude, Cursor, or Codex to build your integration faster
  </Card>
</CardGroup>