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

# Introduction

> A practical guide to signed NGN deposits, recipients, withdrawals, simulations, and webhooks.

THE START

The Bullring Partner API is built for server-to-server integrations. Every partner request is signed with an RSA private key, replay-protected, and scoped to the store integration that owns the key.

This guide assumes an NGN integration and uses:

* `X-Key-Id` to identify the registered public key
* `X-Timestamp` to bound replay
* `X-Idempotency-Id` to make writes safe to retry
* `X-Digital-Signature` to prove possession of the private key

**Start with this sequence.** Read Authentication, then Signing, then the NGN Deposits and Recipients pages. Use Simulation only in sandbox.

## What you will build

1. Sign a request from your backend.
2. Create or retrieve an NGN deposit account.
3. Register an NGN recipient.
4. Submit and track an NGN withdrawal.
5. Verify Bullring's signed outbound webhook.

## Base URLs

```text theme={null}
Sandbox:    https://sandbox-api.bullring.finance
Production: https://api.bullring.finance
```

Production URLs and credentials are issued separately. Never use a private key from one environment in another.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.