MakeCrypto

Référence API

API de liens de paiement

Créez, répertoriez, inspectez, mettez en pause, archivez et envoyez des liens de paiement MakePay.

Itinéraires

Utilisez ces itinéraires pour créer et gérer les liens de paiement MakePay hébergés à partir de MakeCrypto.

MéthodeRoute
GET/api/partner/v1/companies

Auth

Session

Usage

Lister les entreprises de l'utilisateur

Renvoie les équipes disponibles pour les outils du portail de l'utilisateur MakeCrypto authentifié.

POST/api/partner/v1/onboarding/company

Auth

Secret d'onboarding partenaire

Usage

Créer un lien d'onboarding d'entreprise

Crée un brouillon d'onboarding prérempli par le partenaire et renvoie une URL de réclamation pour le marchand.

GET/api/partner/v1/makepay/payment-links

Auth

Clé API MakePay

Usage

Lister ou créer des liens de paiement

Lit les liens de paiement de l'entreprise associée à la clé API ou crée des liens de checkout MakePay hébergés.

POST/api/partner/v1/makepay/payment-links

Auth

Clé API MakePay ou public

Usage

Lister ou créer des liens de paiement

Lit les liens de paiement de l'entreprise associée à la clé API ou crée des liens de checkout MakePay hébergés.

POST/gateway/pay/{makepayKeyId}

Auth

Clé de formulaire publique

Usage

Soumettre un formulaire de paiement HTML

Reçoit les champs de formulaire du navigateur, crée un lien de paiement hébergé, puis redirige l'acheteur vers le checkout.

GET/api/partner/v1/makepay/payment-links/{uid}

Auth

Clé API MakePay

Usage

Lire ou mettre à jour un lien de paiement

Lit le détail d'un lien de paiement ou change son statut en active, paused ou archived.

PATCH/api/partner/v1/makepay/payment-links/{uid}

Auth

Clé API MakePay

Usage

Lire ou mettre à jour un lien de paiement

Lit le détail d'un lien de paiement ou change son statut en active, paused ou archived.

POST/api/partner/v1/makepay/payment-links/{uid}/send-request-email

Auth

Clé API MakePay

Usage

Envoyer une demande de paiement

Envoie ou renvoie le lien hébergé à l'e-mail du client.

GET/api/partner/v1/makepay/subscriptions

Auth

Clé API MakePay

Usage

Lister ou créer des abonnements

Renvoie les plans d'abonnement récurrents MakePay ou crée un abonnement et la première facture.

POST/api/partner/v1/makepay/subscriptions

Auth

Clé API MakePay

Usage

Lister ou créer des abonnements

Renvoie les plans d'abonnement récurrents MakePay ou crée un abonnement et la première facture.

GET/api/partner/v1/makepay/customers

Auth

Clé API MakePay

Usage

Lister ou mettre à jour les clients

Renvoie les profils clients MakePay ou crée/met à jour des clients par e-mail.

POST/api/partner/v1/makepay/customers

Auth

Clé API MakePay

Usage

Lister ou mettre à jour les clients

Renvoie les profils clients MakePay ou crée/met à jour des clients par e-mail.

POST/api/partner/v1/makepay/customers/{customerId}/portal

Auth

Clé API MakePay

Usage

Créer un lien de portail client

Génère à la demande une URL signée du portail client MakePay valable 24 heures.

GET/api/partner/v1/timezones

Auth

Public

Usage

Lister les fuseaux horaires

Renvoie les identifiants de fuseaux horaires IANA pris en charge.

GET/api/partner/v1/makepay/settings

Auth

Clé API MakePay

Usage

Lire ou mettre à jour les paramètres MakePay

Lit ou met à jour les paramètres de règlement, de redirection, de frais et de gestion des sous-paiements.

PUT/api/partner/v1/makepay/settings

Auth

Clé API MakePay

Usage

Lire ou mettre à jour les paramètres MakePay

Lit ou met à jour les paramètres de règlement, de redirection, de frais et de gestion des sous-paiements.

GET/api/partner/v1/makepay/destination-assets

Auth

Clé API MakePay

Usage

Lister les actifs de destination

Renvoie les actifs de règlement pris en charge et l'actif par défaut actuel.

GET/api/partner/v1/makepay/webhook-requests

Auth

Clé API MakePay

Usage

Lister les livraisons de webhook

Affiche les tentatives de livraison des webhooks de paiement et d'abonnement, ainsi que leur état de nouvelle tentative.

Créer un lien de paiement

L'itinéraire de création insère un lien de paiement MakePay, résout les défauts de marque et de règlement merchant, injecte des champs de facturation d'exécution et renvoie le checkout public URL.

POST /api/partner/v1/makepay/payment-links
json
{
  "status": "active",
  "sendPaymentRequestEmail": false,
  "payload": {
    "title": "Website order #1042",
    "description": "Checkout for order #1042",
    "amount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "returnUrl": "https://merchant.example/orders/1042",
    "successUrl": "https://merchant.example/orders/1042/success",
    "failureUrl": "https://merchant.example/orders/1042/failure",
    "expirationTime": "12h",
    "metadata": {
      "cartId": "cart_7M2V",
      "source": "api"
    }
  }
}

Pour un bouton checkout de navigateur sans code ou low-code, voir Formulaire de paiement. Il accepte un simple HTML POST, crée le même type de lien de paiement hébergé et redirige l'acheteur vers MakePay checkout.

Configuration requise

L'entreprise doit disposer d'un actif de destination par défaut MakePay. Si le règlement n'est pas configuré, la route renvoie 409 avec errorCode: "onboarding_required".

Champs Montant et Actif

Utilisez payload.amount pour le montant destiné au client. Transmettez soit payload.asset pour un actif de destination exact, soit payload.currency lorsque l'actif de destination par défaut de l'entreprise peut résoudre la chaîne. Si une devise est activée sur plusieurs chaînes et qu’aucune valeur par défaut de société correspondante n’existe, transmettez explicitement payload.asset.

Expiration

payload.expirationTime accepte 15m, 1h, 12h, 24h, 72h ou never. Le API stocke l'horodatage expires_at résolu sur le lien de paiement.

Créer une réponse

json
{
  "ok": true,
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "status": "active",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "orderId": "order_1042",
      "customerEmail": "buyer@example.com",
      "returnUrl": "https://merchant.example/orders/1042",
      "successUrl": "https://merchant.example/orders/1042/success",
      "failureUrl": "https://merchant.example/orders/1042/failure",
      "expirationTime": "12h",
      "metadata": {
        "cartId": "cart_7M2V",
        "source": "api"
      },
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system"
    }
  }
}

Liste des liens de paiement

Utilisez la route de liste pour la réconciliation du back-office, les tableaux de bord et les tests de fumée.

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

Obtenir les détails du lien de paiement

Utilisez l'itinéraire détaillé lorsque vous disposez déjà d'un lien de paiement UID et que vous avez besoin du lien normalisé, du checkout public URL, de la dernière session de paiement et des événements de la chronologie.

curl
curl "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Accept: application/json"

Suspendre ou archiver un lien de paiement

Utilisez la route de statut pour empêcher le paiement d'un lien ou pour le masquer des opérations actives.

curl
curl -X PATCH "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status doit être active, paused ou archived.

Envoyer un email de demande de paiement

MakeCrypto peut envoyer le lien hébergé directement à l'adresse e-mail du client sur la charge utile du lien de paiement, ou à un e-mail de remplacement dans le corps de la demande.

curl
curl -X POST "https://www.makecrypto.io/api/partner/v1/makepay/payment-links/PAYMENT_LINK_UID/send-request-email" \
  -H "x-makecrypto-key-id: MAKEPAY_API_KEY_ID" \
  -H "x-makecrypto-key-secret: MAKEPAY_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"email":"buyer@example.com"}'

Seuls les liens de paiement actifs peuvent être envoyés par e-mail. Les liens de paiement complétés ne peuvent pas être renvoyés.

Besoin d'aide pour la configuration partenaire ?

Ouvrez la vue des détails du lien de paiement dans MakeCrypto pour copier les extraits générés pour un UID de paiement réel, ou revenez au portail pour gérer les paramètres du marchand.

Ouvrir le portail