recv Developer

IdempotentWeb3PaymentAPI

The ultimate REST API for automated cryptocurrency billing. Integrate real-time webhook notifications, unified multi-chain monitoring, and bulletproof idempotency into your SaaS, game, or automation backend.

Protokoll

API Capabilities & Architecture

recv fungiert als transparente Middleware. Transaktionen fließen direkt vom Kunden zum Händler und umgehen Zwischenkonten.

Unified Multi-Chain Gateway

Stop maintaining custom RPC nodes and fragile blockchain listeners. One standard REST API integration covers GRAM, USDT on TON, TRON, Base, and BSC.

Cryptographic Webhooks

Payment status changes can trigger POST webhooks to your server. Payloads use HMAC-SHA256 signatures and timestamps so your backend can verify authenticity and apply replay controls.

Native Idempotency

Never credit a user twice for the same blockchain transaction. Our core protocol enforces strict idempotency, protecting your database from duplicate processing during network congestion or micro-forks.

Testnet & Sandbox Mode

Develop and test your integration safely using our Sandbox environment. Generate mock invoices and simulate blockchain confirmations without risking real capital.

Anfragen/Monat50k
Team-Plätze3
Workspaces3
SupportStandard
Integration

Nahtloser Ablauf

Step 01

API-Key-Bereitstellung

live_-Keys generieren. Berechtigungen für eine sichere Backend-Integration verwalten.

1
Step 02

Webhook-Konfiguration

Richten Sie mit HMAC-SHA256 signierte Callbacks für sofortige Benachrichtigungen ein.

2
Step 03

Automatisierte Verarbeitung

Unsere Watcher verfolgen Transaktionen rund um die Uhr und bestätigen Zahlungen autonom.

3
Implementierung

In wenigen Minuten bereit für die Produktion.

Integrieren Sie unser Protokoll nahtlos in Ihren bestehenden Workflow.

// Rechnung über die recv-API erstellen
const res = await fetch("https://api.recv.money/v1/invoices", {
  method: "POST",
  headers: { "X-API-Key": "live_..." },
  body: JSON.stringify({
    title: "Bestellung #99",
    base_amount_usd: "29.00",
    payable_network: "TON"
  })
});
const inv = await res.json();
Architecture

Developer Technical Specifications

High-performance primitives for backend integration.

API Protocol
RESTful JSON over HTTPS
Authentication
Bearer Token (API Keys)
Webhook Security
HMAC-SHA256 Signatures
Rate Limits
Up to 50,000 requests per month
Security & Compliance

API Security & Reliability

Security is implemented at the transport and application layers. API credentials are stored as hashes. Failed webhook deliveries are queued for retries according to the active plan, and integrations must remain idempotent because deliveries can repeat.

Target Audience

Built for Automation Engineers

Engineered specifically for backend developers building the next generation of decentralized applications, SaaS billing engines, and automated digital fulfillment systems.

  • SaaS founders implementing automated recurring crypto billing without fiat processors.
  • Web3 game developers needing instant, reliable in-game currency top-ups via TON, Base, or BSC.
  • Discord and Telegram bot creators building paid, automated community access layers.
  • Digital goods distributors that need signed webhook-driven fulfillment.
FAQ

Frequently Asked Questions

When a customer initiates a transfer, our Watchers monitor the respective blockchain. Once the transaction reaches the required confirmations, recv fires a JSON payload via HTTP POST to your pre-configured endpoint with the invoice ID, amount, and TX hash.

recv uses redundant RPC access for supported networks. If a public node drops, we fail over to backup providers. During congestion, watchers maintain state and deliver the webhook when the payment is finalized on-chain.

Idempotency ensures that no matter how many times a specific API request or webhook is retried (due to network drops or client errors), the end result is the same. In crypto, this is vital to prevent 'double-spending' or granting a user a premium subscription twice for a single blockchain transaction.

recv API utilizes a smart-matching protocol rather than generating unique wallet addresses per invoice (which is expensive and difficult to sweep). We use mathematically unique decimal suffixes (e.g., 100.000123 USDT) or network-native memos (on TON) to map a single incoming transaction on your master wallet to a specific user invoice instantly.

Currently, we provide a heavily documented, language-agnostic RESTful API that can be consumed by any modern HTTP client (Axios, Fetch, Requests). Official SDKs for TypeScript/Node.js and Go are actively in development.

Every webhook includes an 'X-recv-Signature' header. You must use your secret Webhook Key to compute an HMAC-SHA256 hash of the raw request body. If your computed hash matches our header, the payload is authentic and untampered.

We do not hard-block your API if you hit a spike. You will receive an automated alert via email and Telegram as you approach the limit (80% and 100%). Overages may be billed at a nominal rate, or you can seamlessly upgrade to the Business plan.

Yes. Developer plan subscribers have access to prioritized email support and a dedicated developer community channel where our core engineers actively assist with architecture design and debugging.

DEVELOPER PLAN
Zugang

29 $

pro Monat

Unbegrenztes Volumen. Feste monatliche Gebühr.

0% TURNOVER FEESNON-CUSTODIALINSTANT PAYOUTS