API-Referenz

API für Zahlungslinks

MakePay-Zahlungslinks erstellen, auflisten, prüfen, pausieren, archivieren und per E-Mail versenden.

Routen

Verwenden Sie diese Routen, um gehostete MakePay-Zahlungslinks von MakeCrypto aus zu erstellen und zu verwalten.

Methode	Route
GET	`/api/partner/v1/companies`
Authentifizierung Sitzung Verwendung Benutzerunternehmen auflisten Gibt die Teams zurück, die für die Portaltools des authentifizierten MakeCrypto-Benutzers verfügbar sind.
POST	`/api/partner/v1/onboarding/company`
Authentifizierung Partner-Onboarding-Secret Verwendung Onboarding-Link für Unternehmen erstellen Erstellt einen vom Partner vorausgefüllten Onboarding-Entwurf und gibt eine Claim-URL für den Händler zurück.
GET	`/api/partner/v1/makepay/payment-links`
Authentifizierung MakePay API-Schlüssel Verwendung Zahlungslinks auflisten oder erstellen Liest Zahlungslinks des Unternehmens, das zum API-Schlüssel gehört, oder erstellt gehostete MakePay-Checkout-Links.
POST	`/api/partner/v1/makepay/payment-links`
Authentifizierung MakePay API-Schlüssel oder öffentlich Verwendung Zahlungslinks auflisten oder erstellen Liest Zahlungslinks des Unternehmens, das zum API-Schlüssel gehört, oder erstellt gehostete MakePay-Checkout-Links.
POST	`/gateway/pay/{makepayKeyId}`
Authentifizierung Öffentlicher Formularschlüssel Verwendung HTML-Zahlungsformular senden Nimmt Formularfelder aus dem Browser an, erstellt einen gehosteten Zahlungslink und leitet den Käufer zum Checkout weiter.
GET	`/api/partner/v1/makepay/payment-links/{uid}`
Authentifizierung MakePay API-Schlüssel Verwendung Zahlungslink lesen oder aktualisieren Liest Details eines Zahlungslinks oder setzt seinen Status auf active, paused oder archived.
PATCH	`/api/partner/v1/makepay/payment-links/{uid}`
Authentifizierung MakePay API-Schlüssel Verwendung Zahlungslink lesen oder aktualisieren Liest Details eines Zahlungslinks oder setzt seinen Status auf active, paused oder archived.
POST	`/api/partner/v1/makepay/payment-links/{uid}/send-request-email`
Authentifizierung MakePay API-Schlüssel Verwendung Zahlungsanforderung senden Sendet den gehosteten Link oder sendet ihn erneut an die E-Mail-Adresse des Kunden.
GET	`/api/partner/v1/makepay/subscriptions`
Authentifizierung MakePay API-Schlüssel Verwendung Abonnements auflisten oder erstellen Gibt wiederkehrende MakePay-Abonnementpläne zurück oder erstellt ein Abonnement und die erste Rechnung.
POST	`/api/partner/v1/makepay/subscriptions`
Authentifizierung MakePay API-Schlüssel Verwendung Abonnements auflisten oder erstellen Gibt wiederkehrende MakePay-Abonnementpläne zurück oder erstellt ein Abonnement und die erste Rechnung.
GET	`/api/partner/v1/makepay/customers`
Authentifizierung MakePay API-Schlüssel Verwendung Kunden auflisten oder aktualisieren Gibt MakePay-Kundenprofile zurück oder erstellt/aktualisiert Kunden per E-Mail.
POST	`/api/partner/v1/makepay/customers`
Authentifizierung MakePay API-Schlüssel Verwendung Kunden auflisten oder aktualisieren Gibt MakePay-Kundenprofile zurück oder erstellt/aktualisiert Kunden per E-Mail.
POST	`/api/partner/v1/makepay/customers/{customerId}/portal`
Authentifizierung MakePay API-Schlüssel Verwendung Kundenportal-Link erstellen Generiert bei Bedarf eine signierte MakePay-Kundenportal-URL, die 24 Stunden gültig ist.
GET	`/api/partner/v1/timezones`
Authentifizierung Öffentlich Verwendung Zeitzonen auflisten Gibt unterstützte IANA-Zeitzonenkennungen zurück.
GET	`/api/partner/v1/makepay/settings`
Authentifizierung MakePay API-Schlüssel Verwendung MakePay-Einstellungen lesen oder aktualisieren Liest oder aktualisiert Einstellungen für Settlement, Weiterleitungen, Gebühren und Unterzahlungsbehandlung.
PUT	`/api/partner/v1/makepay/settings`
Authentifizierung MakePay API-Schlüssel Verwendung MakePay-Einstellungen lesen oder aktualisieren Liest oder aktualisiert Einstellungen für Settlement, Weiterleitungen, Gebühren und Unterzahlungsbehandlung.
GET	`/api/partner/v1/makepay/destination-assets`
Authentifizierung MakePay API-Schlüssel Verwendung Ziel-Assets auflisten Gibt unterstützte Settlement-Assets und das aktuelle Standard-Asset zurück.
GET	`/api/partner/v1/makepay/webhook-requests`
Authentifizierung MakePay API-Schlüssel Verwendung Webhook-Zustellungen auflisten Zeigt Zustellversuche für Payment- und Subscription-Webhooks sowie den Wiederholungsstatus.

Erstellen Sie einen Zahlungslink

Die Erstellungsroute fügt einen MakePay-Zahlungslink ein, löst Händler-Branding- und Abrechnungsvorgaben auf, fügt Laufzeitabrechnungsfelder ein und gibt die öffentliche Checkout-URL zurück.

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

Eine No-Code- oder Low-Code-Browser-Checkout-Schaltfläche finden Sie unter Form submit payment. Es akzeptiert ein einfaches HTML POST erstellt die gleiche Art von gehostetem Zahlungslink und leitet den Käufer weiter zur Kasse MakePay.

Erforderliche Einrichtung

Das Unternehmen muss über ein Standardziel-Asset MakePay verfügen. Wenn die Abrechnung nicht konfiguriert ist, gibt die Route 409 mit errorCode: "onboarding_required" zurück.

Betrags- und Vermögensfelder

Verwenden Sie payload.amount für den kundenorientierten Betrag. Übergeben Sie entweder payload.asset für ein genaues Ziel-Asset oder payload.currency, wenn das Standardziel-Asset des Unternehmens die Kette auflösen kann. Wenn eine Währung in mehreren Ketten aktiviert ist und kein passender Firmenstandard vorhanden ist, übergeben Sie payload.asset explizit.

Ablauf

payload.expirationTime akzeptiert 15m, 1h, 12h, 24h, 72h oder never. Die API speichert den aufgelösten Zeitstempel expires_at im Zahlungslink.

Antwort erstellen

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

Zahlungslinks auflisten

Verwenden Sie die Listenroute für Backoffice-Abstimmungen, Dashboards und Rauchtests.

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"

Einzelheiten zum Zahlungslink abrufen

Verwenden Sie die Detailroute, wenn Sie bereits über eine Zahlungslink-UID verfügen und den normalisierten Link, die öffentliche Checkout-URL, die letzte Zahlungssitzung und Zeitleistenereignisse benötigen.

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"

Pausieren oder archivieren Sie einen Zahlungslink

Verwenden Sie die Statusroute, um die Bezahlung eines Links zu verhindern oder ihn vor aktiven Vorgängen auszublenden.

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 muss active, paused oder archived sein.

Senden Sie eine Zahlungsanforderung per E-Mail

MakeCrypto kann den gehosteten Link direkt an die Kunden-E-Mail in der Zahlungslink-Payload oder an eine außer Kraft gesetzte E-Mail im Anfragetext senden.

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

Es können nur aktive Zahlungslinks per E-Mail verschickt werden. Abgeschlossene Zahlungslinks können nicht erneut gesendet werden.