API Documentation

Integrate payment processing and wallet management into your application

Quick Start

Base URL

https://api.totopay.net

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API Endpoints

GET/api/v1/wallets

Get list of all wallets

curl -X GET "https://api.totopay.net/api/v1/wallets" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/v1/wallets

Create a new wallet

curl -X POST "https://api.totopay.net/api/v1/wallets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "currency": "BTC",
    "label": "My Bitcoin Wallet"
  }'

GET/api/v1/transactions

Get transaction history

curl -X GET "https://api.totopay.net/api/v1/transactions?limit=10&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/v1/transfers

Create a new transfer

curl -X POST "https://api.totopay.net/api/v1/transfers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_id": "wallet_123",
    "amount": "0.5",
    "currency": "BTC",
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"
  }'

GET/api/v1/rates

Get current exchange rates

curl -X GET "https://api.totopay.net/api/v1/rates?from=BTC&to=USD" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/api/v1/payments

Create a new payment request

curl -X POST "https://api.totopay.net/api/v1/payments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "currency": "USDT",
    "description": "Payment for services",
    "expires_in": 30,
    "webhook_url": "https://your-site.com/webhook"
  }'

GET/api/v1/payments/{payment_id}

Get payment request status

curl -X GET "https://api.totopay.net/api/v1/payments/pay_123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

All API responses follow a consistent JSON format:

{
  "success": true,
  "data": {
    "id": "wallet_123",
    "currency": "BTC",
    "balance": "1.23456789",
    "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Rate Limits

API requests are limited to 1000 requests per minute per API key. If you exceed this limit, you'll receive a 429 Too Many Requests response.

Need Help?

If you need assistance with the API, please visit our Helpdesk or check out the API Keys section in Settings.