Référence

Référence de l'itinéraire

Intégration des partenaires OAuth

POST /api/partner/v1/onboarding/company peut inclure un objet oauth facultatif. MakeCrypto valide l'application OAuth, l'URI de redirection, les étendues et le défi PKCE avant de créer le lien d'intégration. Lorsque l'intégration du merchant est terminée, le MakeCrypto crée l'entreprise, accorde à l'application OAuth l'accès à cette entreprise et redirige vers le redirectUri enregistré avec une autorisation 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"
  }
}

L'application partenaire doit conserver le PKCE code_verifier correspondant et échanger le code renvoyé via POST /oauth/token.

Objet PaymentLink

PaymentLinkPayload

Objet client

Réponse du portail client

POST /api/partner/v1/makepay/customers/{customerId}/portal renvoie un portail signé URL pour le client stocké.

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

Le URL est valable 24 heures et utilise le payment_link_domain vérifié par l'entreprise lorsqu'il est disponible. Sinon, il revient à l'origine publique MakePay.

Générez des liens de portail à la demande lorsque le client ouvre la facturation. Les URL expirées, falsifiées ou inter-clients sont rejetées avant le chargement des données du portail.

Objet d'abonnement

Les abonnements sont transférés vers overdue lorsqu'un cycle non payé dépasse d'au moins 24 heures son horodatage dueAt. MakePay envoie un makepay.subscription.status_changed webhook signé chaque fois que l'état de l'abonnement change.

MakePayParamètres

Actif de destination

Valeurs d'état

• active : le lien peut être ouvert et payé.
• paused : le lien reste visible pour le merchant mais ne doit pas accepter de nouveaux départs de paiement.
• archived : le lien est masqué dans les vues actives et doit être traité comme fermé.

Valeurs de l'état de l'abonnement :

• active : l'abonnement collecte normalement les factures programmées.
• paused : les rappels et les modifications merchant/client ont mis l'abonnement en pause.
• overdue : au moins un cycle non rémunéré a dépassé sa date d'échéance de 24 heures ou plus.
• cancelled : l'abonnement est terminé et les cycles générés non payés sont annulés.

Forme d'erreur

Les erreurs renvoient JSON avec error et, le cas échéant, errorCode.

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