Documentation — Denaro Pay API

§I

Overview
API basics

API overview.

The Denaro Pay API is a REST API with JSON request and response bodies. All endpoints require HTTPS. Authentication uses JWT bearer tokens obtained from the auth endpoints.

Base URLhttps://api.denaropay.com/v1

ProtocolHTTPS only · TLS 1.3

AuthenticationJWT Bearer token

Request formatJSON — Content-Type: application/json

Response formatJSON

Rate limiting100 requests per minute per token

Token expiry15 minutes (access) · 30 days (refresh)

API versionv1 — stable

§II

Authentication
JWT tokens

Authentication.

Obtain a JWT access token by posting credentials to /auth/login. Include the token in the Authorization header for all subsequent requests. Refresh tokens using /auth/refresh before expiry.

curl — Login and obtain tokenbash
# Step 1: Login and obtain JWT token
curl -X POST https://api.denaropay.com/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your-password",
    "biometric_token": "optional-biometric-session-token"
  }'

# Response
{
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "expires_in": 900
}

# Step 2: Use token in subsequent requests
curl -X GET https://api.denaropay.com/v1/wallet/balance \
  -H "Authorization: Bearer eyJhbGci..."

Python — SDK examplepython
import requests

# Authenticate
resp = requests.post(
    "https://api.denaropay.com/v1/auth/login",
    json={"email": "user@example.com", "password": "..."}
)
token = resp.json()["access_token"]
headers = {"Authorization": f"Bearer {token}"}

# Get wallet balance
balance = requests.get(
    "https://api.denaropay.com/v1/wallet/balance",
    headers=headers
).json()

# Send USDC transfer
transfer = requests.post(
    "https://api.denaropay.com/v1/transfer/send",
    headers=headers,
    json={
        "to_address": "0xA7F2...B319",
        "amount_usdc": "100.00",
        "biometric_token": "session-token"
    }
).json()