---
title: "TinaVerify Developers"
description: "Build payment verification into your product with the TinaVerify Developer Platform."
canonical_url: "https://0.0.0.0:8080/docs"
markdown_url: "https://0.0.0.0:8080/docs.md"
last_updated: "2026-08-24"
x_farming_labs_generated_preamble: true
---

# TinaVerify Developers
URL: /docs
LLM index: /llms.txt
Description: Build payment verification into your product with the TinaVerify Developer Platform.

# TinaVerify Developer Platform

TinaVerify exposes a versioned **Developer API** so partners can verify bank receipts, list transactions, and receive webhook events — without touching our internal business logic.

Base URL:

```text
https://<your-host>/developer-api/v1
```

## Two surfaces

| Surface | Who uses it | Auth |
| --- | --- | --- |
| **Developer Portal** | Humans in the dashboard UI | Portal JWT from `/developer-api/v1/auth/*` |
| **Public API** | Your servers & SDKs | API keys (`sk_test_…` / `sk_live_…`) |

The [Developer Portal](/docs/portal) is where you register, buy verification packs, create keys, configure webhooks, and test calls. The Public API is what your backend calls in production.

## Quick path

1. [Get started](/docs/getting-started) — create a portal account and get a sandbox key
2. [Portal](/docs/portal) — walk the dashboard (keys, billing, playground)
3. [Authentication](/docs/authentication) — portal JWT vs API keys
4. [Subscription](/docs/subscription) — sandbox limits and paid credit packs
5. [Verifications](/docs/verifications) — submit a receipt image
6. [Webhooks](/docs/webhooks) — receive signed event callbacks

## Design principles

- **Separate developer identity** — portal accounts are not TinaVerify app users
- **Hashed API keys** — only digests are stored server-side
- **Sandbox & production** — `sk_test_` and `sk_live_` environments
- **Credit packs** — production verifications consume purchased credits (Chapa)
- **Sandbox rate window** — env-configured test quota (e.g. 20 verifications / 10 minutes)
- **Consistent errors** — `{ success: false, error: { code, message, request_id } }`

<Callout type="info">
Interactive OpenAPI is available on the API server at <code>/docs</code>. This site is the narrative guide for the Developer Platform and portal.
</Callout>

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).