Démarrage rapide de l'API

Choisissez une équipe et une clé API

Créez une clé MakePay API à partir du portail MakeCrypto ou de l'onglet Test API lorsque vous êtes connecté. L'onglet Test API charge vos équipes, filtre les clés MakePay API, ouvre le modal de création de clé lorsque l'équipe sélectionnée n'a pas encore de clé MakePay et peut envoyer des demandes authentifiées avec l'ID de clé et le secret sélectionnés.

Socle URL

Tous les itinéraires API du partenaire MakeCrypto sont versionnés sous l'origine de production.

https://www.makecrypto.io/api/partner/v1

Pour le développement local, utilisez votre origine MakeCrypto locale avec la même structure de chemin.

Authentification

Les intégrations de serveur doivent envoyer un ID de clé MakePay API et un secret API à chaque demande. Le secret n'est renvoyé que lorsque la clé API est créée. Conservez-le donc dans un gestionnaire de secrets côté serveur et ne l'envoyez jamais aux navigateurs des clients.

Demande de première lecture

Commencez par une demande de lecture avant de créer des liens de paiement en direct. Une réponse réussie confirme que l'ID de clé, le secret, la portée du produit MakePay et l'entreprise détenue par la clé sont tous valides.

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"

Créer d'abord une demande

Créez des liens de paiement à partir de votre serveur lorsqu'une commande, une facture ou une session checkout est prête à être payée.

curl -X POST "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 "Content-Type: application/json" \
  -d '{
  "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"
    }
  }
}'

Liste de contrôle opérationnelle

• Créez la clé API avec le produit makepay.
• Configurez l'actif de destination par défaut de l'entreprise avant de créer des liens.
• Stockez le secret API en dehors du contrôle de code source et des bundles frontaux.
• Traitez les UID des liens de paiement comme des identifiants publics, mais conservez les ID de commande internes dans payload.orderId ou payload.metadata.
• Écoutez webhooks ou interrogez l'état du lien de paiement/de la session à partir du portail jusqu'à ce que votre flux backend webhook soit en ligne.