Referenz

Routenreferenz

Partner-Onboarding OAuth

POST /api/partner/v1/onboarding/company kann optional einen oauth enthalten Objekt. MakeCrypto validiert die OAuth-App, den Umleitungs-URI, die Bereiche und PKCE Herausforderung, bevor Sie den Onboarding-Link erstellen. Wenn der Händler fertig ist Beim Onboarding erstellt MakeCrypto das Unternehmen und gewährt der OAuth-App Zugriff darauf Unternehmen und leitet mit einer Autorisierung zum registrierten redirectUri weiter code.

{
  "idempotencyKey": "merchant_123",
  "company": {
    "name": "Acme Markets",
    "website": "https://acme.example"
  },
  "oauth": {
    "clientId": "mco_app_example",
    "redirectUri": "https://apps.makecrypto.io/oauth/callback",
    "scope": "company:read makepay:payment-links:write makepay:settings:read",
    "state": "merchant_123",
    "codeChallenge": "PKCE_S256_CODE_CHALLENGE",
    "codeChallengeMethod": "S256"
  }
}

Die Partner-App sollte das passende PKCE code_verifier behalten und austauschen zurückgegebener Code über POST /oauth/token.

PaymentLink-Objekt

PaymentLinkPayload

Kundenobjekt

Antwort des Kundenportals

POST /api/partner/v1/makepay/customers/{customerId}/portal gibt eine signierte Portal-URL für den hinterlegten Kunden zurück.

{
  "ok": true,
  "companyId": "acct_123",
  "customer": {
    "id": "b834dd77-69b8-41a9-a4b6-95bc9dd14c2d",
    "uid": "cus_01hzy4k6p4w9y2x7e2z7n8a2xm",
    "email": "buyer@example.com",
    "name": "Ada Lovelace",
    "clientId": "client_1042",
    "metadata": {
      "source": "api"
    },
    "createdAt": "2026-04-20T10:00:00.000Z",
    "updatedAt": "2026-04-20T10:00:00.000Z",
    "urls": {
      "customerPortal": "https://makepay.io/billing?company=acct_123&customer=cus_01hzy4k6p4w9y2x7e2z7n8a2xm&expires=1776765600&signature=8d1f..."
    }
  },
  "expiresAt": "2026-04-21T10:00:00.000Z"
}

Die URL ist 24 Stunden lang gültig und verwendet die verifizierte URL des Unternehmens payment_link_domain, sofern verfügbar. Andernfalls wird auf MakePay zurückgegriffen öffentliche Herkunft.

Generieren Sie bei Bedarf Portal-Links, wenn der Kunde die Abrechnung öffnet. Abgelaufen, Manipulierte oder kundenübergreifende URLs werden abgelehnt, bevor Portaldaten geladen werden.

Abonnementobjekt

Abonnements werden auf overdue verschoben, wenn ein unbezahlter Zyklus mindestens 24 Stunden zurückliegt sein dueAt-Zeitstempel. MakePay sendet eine signierte makepay.subscription.status_changed-Webhook bei jedem Abonnementstatus Änderungen.

MakePaySettings

ZielAsset

Statuswerte

• active: Der Link kann geöffnet und bezahlt werden.
• paused: Der Link bleibt für den Händler sichtbar, sollte aber keine neuen Zahlungsstarts akzeptieren.
• archived: Der Link ist in aktiven Ansichten verborgen und sollte als geschlossen behandelt werden.

Abonnementstatuswerte:

• active: Das Abonnement erfasst geplante Rechnungen normal.
• paused: Erinnerungen und Händler-/Kundenänderungen haben das Abonnement pausiert.
• overdue: Mindestens ein unbezahlter Zyklus liegt 24 Stunden oder mehr über dem Fälligkeitsdatum.
• cancelled: Das Abonnement wird beendet und unbezahlte generierte Zyklen werden storniert.

Fehlerform

Fehler geben JSON mit error und, sofern verfügbar, errorCode zurück.

{
  "errorCode": "invalid_destination_asset",
  "error": "payload.asset ETH.USDT-... is not available for supported settlement routes."
}