API-Schnellstart

Wählen Sie ein Team und einen API-Schlüssel

Erstellen Sie einen MakePay-API-Schlüssel über das MakeCrypto-Portal oder über die Registerkarte „API-Tests“, wenn Sie angemeldet sind. Die Registerkarte „API-Tests“ lädt Ihre Teams, filtert MakePay-API-Schlüssel, öffnet das Schlüsselerstellungsmodal, wenn das ausgewählte Team noch keinen MakePay-Schlüssel hat, und kann authentifizierte Anfragen mit der ausgewählten Schlüssel-ID und dem ausgewählten Geheimnis senden.

Basis-URL

Alle MakeCrypto-Partner-API-Routen werden unter dem Produktionsursprung versioniert.

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

Verwenden Sie für die lokale Entwicklung Ihren lokalen MakeCrypto-Ursprung mit derselben Pfadstruktur.

Authentifizierung

Serverintegrationen sollten bei jeder Anfrage eine MakePay-API-Schlüssel-ID und ein API-Geheimnis senden. Das Geheimnis wird nur zurückgegeben, wenn der API-Schlüssel erstellt wird. Bewahren Sie es daher in einem serverseitigen Geheimnis-Manager auf und senden Sie es niemals an Kundenbrowser.

Erste Leseanfrage

Beginnen Sie mit einer Leseanfrage, bevor Sie Live-Zahlungslinks erstellen. Eine erfolgreiche Antwort bestätigt, dass die Schlüssel-ID, das Geheimnis, der Produktumfang MakePay und das Unternehmen, dem der Schlüssel gehört, alle gültig sind.

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"

Erste Erstellungsanfrage

Erstellen Sie Zahlungslinks von Ihrem Server, wenn eine Bestellung, Rechnung oder Checkout-Sitzung zur Zahlung bereit ist.

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"
    }
  }
}'

Checkliste für den Betrieb

• Erstellen Sie den API-Schlüssel mit dem Produkt makepay.
• Konfigurieren Sie das Standardziel-Asset des Unternehmens, bevor Sie Links erstellen.
• Speichern Sie das API-Geheimnis außerhalb der Quellcodeverwaltung und der Frontend-Bundles.
• Behandeln Sie Zahlungslink-UIDs als öffentliche Kennungen, behalten Sie jedoch interne Bestell-IDs in payload.orderId oder payload.metadata bei.
• Warten Sie auf Webhooks oder fragen Sie den Zahlungslink-/Sitzungsstatus vom Portal ab, bis Ihr Back-End-Webhook-Flow aktiv ist.