INTÉGRATIONS

API de paiement en crypto. Un seul point de terminaison pour être payé en crypto.

Créez des liens de paiement, recevez des événements de webhook et réglez les fonds vers n'importe quelle adresse de portefeuille avec une seule REST API. Fonctionne avec n'importe quel langage ou framework. Les 30 premiers paiements gratuits.

CE QUE VOUS OBTENEZ

Conçu pour les marchands qui veulent de la simplicité.

REST API

REST API JSON standard. Créez des paiements, vérifiez le statut et gérez votre compte de manière programmatique depuis n'importe quel langage ou framework.

Webhooks

Recevez des notifications d'événements en temps réel lorsque les paiements sont confirmés, terminés ou échouent. Logique de nouvelle tentative configurable pour les livraisons manquées.

Plusieurs modes de frais

Choisissez comment les frais sont gérés par paiement : déduire du Gas Tank, déduire du montant du paiement, ou répercuter les frais sur le payeur.

Prise en charge des smart contracts

Intégration native des smart contracts pour les flux de paiement sur la chaîne. Documentation complète de l'architecture technique disponible.

FONCTIONNEMENT

Trois étapes vers votre premier paiement.

  1. 1

    Obtenez votre clé API

    Créez un compte gratuit sur app.makapay.io et générez une clé API depuis votre tableau de bord sous Clés API.

  2. 2

    Créez un paiement

    Envoyez un POST à /api/payments avec votre adresse de portefeuille de marchand, le réseau, le token, le montant et l'ID de commande. Recevez un lien de paiement et un QR code dans la réponse.

  3. 3

    Recevez des événements de webhook

    Configurez une URL de webhook pour recevoir les événements payment.completed. Votre système se met à jour automatiquement lorsque les fonds sont confirmés sur la chaîne.

Commencez à coder

De zéro à votre premier paiement en une seule requête

Créez un lien de paiement, récupérez une URL et recevez un webhook dès que les fonds sont réglés on-chain. Compatible avec n'importe quel langage ou framework.

Créer un paiement

cURL
curl -X POST https://app.makapay.io/api/payments \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
    "chainId": "137",
    "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
    "amount": "100.00",
    "orderId": "order-12345",
    "description": "Premium subscription"
  }'

Réponse

Vous obtenez une URL de paiement hébergée. Redirigez-y votre client ou affichez-la sous forme de QR code.

JSON
{
  "url": "https://app.makapay.io/pay/01234567-89ab-cdef-0123-456789abcdef"
}

Gérer le webhook

Pointez une URL de webhook vers votre serveur et MakaPay envoie un événement payment.completed dès que le paiement est réglé.

payment.completed
{
  "event": "payment.completed",
  "paymentId": "01234567-89ab-cdef-0123-456789abcdef",
  "orderId": "order-12345",
  "merchant": "0x742d35Cc6634C0532925a3b844Bc9e7595f8fE00",
  "amount": "100.00",
  "token": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
  "chainId": 137,
  "status": "completed",
  "transactionHash": "0x...",
  "timestamp": 1704067200000
}

Vérifier la signature

Chaque webhook est signé. Vérifiez l'en-tête X-Signature avant de faire confiance au contenu.

verify-webhook.js
const crypto = require("crypto");

function verifyWebhook(rawBody, signature, signingKey) {
  const expected = crypto
    .createHash("sha256")
    .update(rawBody + signingKey)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected, "hex"),
    Buffer.from(signature, "hex"),
  );
}

FAQ

Quelle est l'URL de base de l'API ?

L'URL de base de l'API MakaPay est https://app.makapay.io/api. Authentifiez-vous à l'aide de l'en-tête x-api-key avec votre clé API du tableau de bord.

Quelles blockchains l'API prend-elle en charge ?

L'API prend en charge MakaChain, Ethereum, Polygon (MATIC) et BNB Chain. Les transactions sur MakaChain n'ont aucun frais de gas. Les autres réseaux entraînent des coûts de gas variables.

Puis-je créer des paiements pour plusieurs adresses de portefeuille différentes ?

Oui. Chaque demande de paiement inclut un champ d'adresse de portefeuille de marchand. Vous pouvez spécifier différentes adresses de destination par paiement, ce qui est utile pour les configurations de marketplace et multi-vendeurs.

Quels événements de webhook sont disponibles ?

MakaPay envoie des événements pour les changements de statut de paiement, notamment payment.completed, payment.failed et payment.expired. Vous pouvez configurer votre URL de webhook et sélectionner les événements depuis le tableau de bord.

Acceptez votre premier paiement en crypto en 10 minutes.

Créez votre compte, alimentez votre Gas Tank et partagez votre premier lien de paiement. Aucuns frais mensuels. Aucuns frais de configuration. Les fonds arrivent directement dans votre portefeuille.