Aller au contenu

Intégration en une fois

La passerelle de paiement crypto pour les bots Telegram et les services crypto.

Obtenez une clé API et un prompt d’intégration auprès de notre bot Telegram. Collez le prompt dans votre agent de code et commencez à encaisser des paiements crypto. Aucune documentation d’API à lire.

Connectez-vous en 3 étapes

  1. Ouvrez notre bot Telegram. En quelques secondes, vous obtenez votre clé API et un prompt d’intégration pour votre agent de code.

  2. Claude Code, Cursor ou tout autre agent de code lit notre documentation et écrit l’intégration : le lien de paiement, le webhook et la vérification de signature.

  3. Nous vérifions le paiement on-chain, bloquons les faux jetons, puis envoyons à votre serveur un webhook signé. Expédiez la commande.

Cryptomonnaies

Acceptez USDT, USDC, BTC, ETH, GRAM et 8 autres cryptomonnaies

13 cryptomonnaies sur 12 réseaux

  • AVAX
  • BNB
  • BTC
  • DOGE
  • ETH
  • GRAM
  • LTC
  • POL
  • SOL
  • TRX
  • USDC
  • USDT
  • XMR

Réseaux : Tron (TRC-20) · TON · Ethereum (ERC-20) · BNB Chain (BEP-20) · Solana · Polygon · Base · Avalanche C-Chain · Bitcoin · Litecoin · Dogecoin · Monero

Votre client paie depuis n’importe quel portefeuille

Vous lui envoyez le lien de paiement. Il règle le montant exact depuis n’importe quel portefeuille avant l’échéance, et votre serveur reçoit un webhook signé.

Comment mon client paie-t-il ?

Nous surveillons les blockchains. Vous expédiez.

Nous surveillons les 12 réseaux et envoyons à votre serveur un webhook signé dès qu’un paiement est confirmé.

Lire la documentation de l’API de paiement crypto

Telegram

Conçu pour les bots Telegram, les Mini Apps et les services crypto.

Une seule clé API sert pour les trois. Les règles de Telegram déterminent quelles cryptomonnaies s’affichent où, et la page de paiement les suit.

Bots Telegram

Les 13 cryptomonnaies pour des biens physiques, des services réels et des ventes sur votre propre site. Les biens numériques vendus dans Telegram restent sur Telegram Stars.

Mini Apps

Telegram n’autorise que les cryptomonnaies TON dans les Mini Apps ; la page de paiement affiche donc GRAM et USDT sur TON, sur votre propre domaine.

Services crypto et sites web

Acceptez l’USDT sur 8 réseaux, l’USDC sur 5, ainsi que BTC, ETH, GRAM et 8 autres cryptomonnaies, avec des liens de paiement, des webhooks signés et des retraits que vous approuvez, depuis une seule API.

Comment accepter des paiements crypto dans un bot Telegram

Un appel pour être payé. Un webhook pour expédier.

Créez un lien de paiement crypto en un seul appel d’API. Votre serveur est prévenu une seule fois, par un webhook signé, quand l’argent est vérifié on-chain. Aucun nœud à exploiter, aucun polling, aucun formulaire.

Voilà toute l’intégration

  1. Étape 1

    Obtenez votre clé API

    Ouvrez notre bot Telegram. En quelques secondes, vous obtenez votre clé API et un prompt d’intégration pour votre agent de code. Le mode test fonctionne tout de suite.

    Obtenir votre clé API

    Ravelo Bot

    bot

    /start

    Votre clé API de test est prête :

    rvk_test_8f3k…x9Kp

  2. Étape 2

    Un seul appel

    Créez un lien de paiement avec son propre montant et sa propre adresse. Envoyez-le dans un chat, un e-mail ou sur votre site.

    POST /v1/payment-intents
    POST /v1/payment-intents
    {
      "order_ref": "1042",
      "asset_id": "usdt-tron",
      "amount": "25000000"        // 25 USDT
    }
    
    201 Created
    {
      "status": "requires_payment",
      "instructions": { "address": "TQ7a…3fK" }
    }
    
  3. Étape 3

    Votre client paie

    Depuis n’importe quel portefeuille : le montant exact, avant l’échéance, avec un QR code.

    Commande n° 1042

    14:59

    25.00 USDT

    TQ7a…3fK · TRON (TRC-20)

    Payez avant 12:30

  4. Étape 4

    Un seul webhook

    Nous vérifions le paiement on-chain, bloquons les faux jetons, puis envoyons à votre serveur un webhook signé. Expédiez la commande.

    webhook
    POST https://your-bot.app/webhook
    ravelo-signature: verified
    
    {
      "type": "payment_intent.succeeded",
      "data": { "order_ref": "1042", … }
    }

    Vous expédiez la commande. C’est tout.

Développeurs

Une API de paiement crypto, des SDK et des webhooks vérifiables.

Une API REST avec des SDK TypeScript et Python, une documentation de démarrage rapide et un mode test. Chaque webhook est signé, pour que votre serveur puisse prouver qu’il vient de nous. Les clés peuvent créer des paiements et préparer des retraits. Vous seul approuvez les sorties d’argent.

  • Des clés qui ne peuvent pas vider votre compte

    Les clés API peuvent créer des paiements et préparer des retraits. Aucune ne peut envoyer d’argent. Il faut votre approbation.

  • Relance sans risque

    Envoyez deux fois la même requête avec une clé d’idempotence et vous obtenez un seul paiement, pas deux.

  • Chaque appel est tracé

    Chaque appel API et MCP est journalisé : quelle clé, quel outil, quelle demande.

Lire la documentation de l’API de paiement crypto

Créer un lien de paiement

import { Ravelo } from "@ravelo/sdk";

const ravelo = new Ravelo({
  apiKey: process.env.RAVELO_TEST_KEY,
  baseUrl: process.env.RAVELO_API,
});

// 25 USDT on TRON, in base units (6 decimals)
const intent = await ravelo.paymentIntents.create({
  order_ref: "1042",
  asset_id: "usdt-tron",
  amount: "25000000",
});

console.log(intent.instructions.address); // send your buyer here

Vérifier un webhook

import { verifyWebhook } from "@ravelo/sdk";

// Verify the raw bytes exactly as they arrived
const event = await verifyWebhook(
  rawBody,
  req.headers["ravelo-signature"],
  process.env.RAVELO_WEBHOOK_SECRET,
); // throws if the body or signature was forged

if (event.type === "payment_intent.succeeded") {
  ship(event.data.order_ref);
}

Agents de code

Ou intégrez en un seul prompt.

Collez le prompt d’intégration de notre bot dans votre agent de code.

Claude Code, Cursor ou tout autre agent de code lit notre documentation et écrit l’intégration : le lien de paiement, le webhook et la vérification de signature. Connectez notre serveur MCP et votre assistant peut aussi créer des liens de paiement et vérifier les paiements. Il n’approuve jamais un retrait. C’est vous.

Ce que le bot vous envoie, prêt à coller dans votre agent de code :
Integrate Ravelo crypto payments
into this project.
API key (test): rvk_test_••••
1. Read the docs: https://ravelopay.app/llms.txt
2. Add a /buy command that creates a
   payment link with one API call.
3. Add a webhook that checks the
   signature and ships the order.
4. Run one test payment.

Sécurité

Nous vérifions chaque paiement, pour que vous n’expédiiez jamais contre de faux paiements.

Chaque commande a son propre lien de paiement et sa page de paiement : tarifée en crypto ou dans votre devise, avec le montant exact, un QR code et une échéance.

Faux jetons bloqués

Nous ne comptons que les jetons issus de contrats vérifiés. Un faux jeton ne marque jamais une commande comme payée.

Paiement insuffisant, tardif ou mauvaise cryptomonnaie

La commande indique exactement ce qui est arrivé et quand. Rien n’est prêt à expédier tant que le montant total n’est pas reçu.

Payé, puis prêt à expédier

Deux états distincts, pour que votre code n’expédie que lorsque l’argent est définitif. Une visite sur votre page de remerciement ne compte jamais.

Aucun nœud à exploiter

Nous surveillons les 12 réseaux. Votre serveur n’entend parler de nous que lorsqu’un paiement change d’état.

Retraits

Des retraits que vous approuvez

L’argent ne part que lorsque vous le décidez.

Retirez vers vos adresses enregistrées. Une nouvelle adresse attend 24 heures avant de pouvoir recevoir de l’argent. Votre backend ou votre assistant IA peut préparer un retrait ou un remboursement, mais rien ne bouge tant que vous ne l’avez pas approuvé avec votre empreinte, votre visage ou une clé de sécurité.

Tableau de bord

Chaque paiement, solde et retrait au même endroit.

Créez des liens de paiement via l’API, ou construisez votre propre page de paiement dessus. Chaque paiement arrive dans un seul tableau de bord, suivi de payé à retiré.

  • Le statut de chaque paiement

    Payé, prêt à expédier et retiré, avec chaque transfert reçu.

  • Relevés CSV

    Exportez paiements et retraits en CSV pour votre comptable.

  • Rôles d’équipe

    Invitez un cofondateur ou un développeur. Chacun ne voit et ne fait que ce que son rôle autorise.

  • Soldes par cryptomonnaie

    Disponible, en attente et retenu, toujours affichés séparément. Vous savez toujours ce que vous pouvez retirer.

  • Remboursements totaux ou partiels

    Remboursez tout ou partie d’une commande vers une adresse vérifiée. Les remboursements ne peuvent jamais dépasser ce que l’acheteur a payé.

  • Clés de test et de production

    Développez en mode test, puis passez à votre clé de production. Les paiements de test ne déplacent jamais de fonds réels.

Tarifs

Tarif : 3 % par paiement, sans frais d’installation ni abonnement

Quand vous êtes payé

3 % par paiement

Prélevés sur chaque paiement confirmé. Aucuns frais fixes en plus, donc les petites ventes restent bon marché : une vente de 5 $ coûte 15¢.

Obtenir votre clé API
  • Le client paie 100 USDT, vous recevez 97 USDT
  • Aucuns frais d’installation, aucun abonnement mensuel
  • Le mode test est gratuit
  • Coût du réseau affiché avant chaque retrait

FAQ

FAQ de la passerelle de paiement crypto

Ce que les développeurs demandent avant de nous brancher. Il manque quelque chose ? Posez-nous la question sur Telegram.

  • Obtenez votre clé API auprès de notre bot Telegram en quelques secondes, avec un prompt d’intégration pour votre agent de code. Un seul appel d’API crée votre premier lien de paiement en mode test. Les paiements réels démarrent dès l’activation de votre compte.

  • Des instructions prêtes à l’emploi pour votre agent de code, comme Claude Code ou Cursor. Le bot les envoie avec votre clé API. Collez-les, et l’agent ajoute à votre projet un lien de paiement et un webhook vérifié. Il ne reste qu’à lancer un paiement de test.

  • USDT sur Tron (TRC-20), TON, Ethereum (ERC-20), BNB Chain (BEP-20), Solana (SPL), Polygon, Base et Avalanche C-Chain. USDC sur Ethereum (ERC-20), Solana (SPL), Polygon, Base et Avalanche C-Chain. ETH sur Ethereum et Base. Ainsi que BTC, GRAM, SOL, TRX, BNB, POL, AVAX, LTC, DOGE et XMR, chacun sur son propre réseau. GRAM est la cryptomonnaie native de TON, anciennement appelée Toncoin.

  • Vous lui envoyez le lien de paiement. Il règle le montant exact depuis n’importe quel portefeuille avant l’échéance, et votre serveur reçoit un webhook signé.

  • Oui, dans le respect des règles de Telegram : les 13 cryptomonnaies dans les bots classiques pour des biens physiques, des services réels et votre propre site, et GRAM et USDT sur TON dans les Mini Apps.

  • Uniquement pour les biens et services numériques vendus dans Telegram : Telegram exige les Stars pour ceux-ci. Pour les biens physiques, les services réels et les ventes sur votre propre site, vous pouvez encaisser en crypto avec Ravelo.

  • Nous le vérifions on-chain et par rapport aux contrats de cryptomonnaies vérifiés avant de le comptabiliser. Un faux jeton ne marque jamais une commande comme payée.

  • Non. Nous surveillons les 12 réseaux et envoyons à votre serveur un webhook signé dès qu’un paiement est confirmé.

  • Non. Il peut créer des liens de paiement et préparer un remboursement ou un retrait. Vous seul l’approuvez, avec une passkey.

  • 3 % de chaque paiement confirmé. Aucuns frais d’installation ni d’abonnement mensuel. Les coûts de réseau s’affichent avant que votre client paie et avant que vous approuviez un retrait.

  • Oui, celles que vous fixez : par retrait, par jour et par mois. Une nouvelle adresse de retrait attend 24 heures avant de pouvoir recevoir de l’argent, afin qu’un identifiant volé ne puisse pas vider votre solde.

Commencez à accepter des paiements crypto dès aujourd’hui.

Ouvrez le bot : vous obtenez votre clé API et un prompt d’intégration. Collez le prompt dans votre agent de code, ou faites vous-même un appel d’API. Nous surveillons la blockchain.