Build with TFarms

Connect your app to payouts, marketplaces, treasury tools, and developer APIs—then test safely in Sandbox before going live.

STEP 1

STEP 1 — Create Your Developer Account

Create your account, verify your identity, and turn on multi-factor authentication before you connect to TFarms APIs.

Have these ready:
Full name
Work email and password
Multi-factor authentication device

STEP 2

Create Your API Key

Your API key authenticates requests from your app. Create a separate key for each environment and give it only the permissions it needs.

Use your key to access:
• Payouts and transfers
• Marketplace orders
• Treasury routing
• Intelligence and reporting APIs

Generate API Key

After generation, you'll see:

Key ID

Permissions

Environment (Sandbox/Production)

Status

STEP 3

Configure Webhooks

Register a secure endpoint to receive payout and marketplace events. Store the signing secret safely and return a fast 2xx response so TFarms can confirm delivery.

Endpoint URL

Secret Key

Retry Policy

STEP 4

Choose Your Environment

Sandbox

Test payouts, treasury routing, and marketplace orders safely with test data.

Production

Go live when your integration is tested, secured, and ready for real transactions.

STEP 5

Test Your First Payout

Amount to send

Currency

Payment rail (ACH, XRP, USDC, or bank transfer)

Recipient name

Recipient account

Success Console

✓ Payout ID

✓ Rail used

✓ Settlement window

✓ Webhook event delivered

STEP 6

Marketplace Integration and Treasury Configuration

Developers can:

Connect your marketplace flow to:
Create listings and orders
Capture payments securely
Issue refunds and track status
Receive real-time webhook updates

Marketplace Integration

Developers configure:

Configure how funds move through your platform:
Set liquidity pools and routing rules
Define settlement windows and limits
Track balances, fees, and reconciliation
Monitor treasury events with webhooks

STEP 7

Treasury Configuration

View SDK Documentation

Choose your language, install the package, and initialize the SDK with your Sandbox API key. Keep secret keys on your server and test your integration before switching to Production.

Install the TFarms SDK

STEP 8

STEP 9

Verify Webhook Signatures

Verify every webhook before processing the event. Check the signature, timestamp, and replay protection, then accept only valid requests. Never log or expose the signing secret.

Webhook Payload

{ "event": "payout.completed", "id": "po_..." }

Signature Header

t=1700000000,v1=5257a869e7ec...

✓ HMAC signature
✓ Timestamp check
✓ Replay protection

Invalid checks: return an error and stop processing.

STEP 10

Developer Checklist

Before going live:
☐ Developer account verified
☐ API key created with least-privilege permissions
☐ Webhook endpoint registered and signature checks enabled
☐ Sandbox payout completed successfully
☐ Marketplace and treasury flows tested
☐ Production keys stored securely and monitoring enabled

STEP 11

Access Your Developer Console

Your integration is ready for ongoing testing and management. Use the console to create keys, monitor events, test payouts, and manage your marketplace and treasury settings.

API Keys & Permissions

Webhooks & Events

Logs & Monitoring

Payout Playground

Marketplace Playground

Treasury Playground

Developer Tools

Project Settings