Dokumentacja API

Linki płatnicze API

Twórz, wyświetlaj, sprawdzaj, wstrzymuj, archiwizuj i wysyłaj e-mailem linki do płatności MakePay.

Trasy

Użyj tych tras, aby utworzyć i zarządzać hostowanymi łączami płatniczymi MakePay z poziomu MakeCrypto.

MetodaTrasa
GET/api/partner/v1/companies

Autoryzacja

Sesja

Zastosowanie

Lista firm użytkownika

Zwraca zespoły dostępne dla narzędzi portalu zalogowanego użytkownika MakeCrypto.

POST/api/partner/v1/onboarding/company

Autoryzacja

Sekret onboardingu partnera

Zastosowanie

Utwórz link onboardingu firmy

Tworzy wstępnie wypełniony przez partnera szkic onboardingu i zwraca adres URL do przejęcia przez sprzedawcę.

GET/api/partner/v1/makepay/payment-links

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl lub utwórz linki płatnicze

Odczytuje linki płatnicze firmy przypisanej do klucza API albo tworzy hostowane linki checkout MakePay.

POST/api/partner/v1/makepay/payment-links

Autoryzacja

MakePay API key, OAuth, or public

Zastosowanie

Wyświetl lub utwórz linki płatnicze

Odczytuje linki płatnicze firmy przypisanej do klucza API albo tworzy hostowane linki checkout MakePay.

POSThttps://www.makepay.io/api/public/anonymous-payment-links

Autoryzacja

Publiczne

Zastosowanie

Create anonymous payment link

Public MakePay endpoint for one-time anonymous checkout links with explicit settlement priorities, branding, and optional webhooks.

POST/gateway/pay/{makepayKeyId}

Autoryzacja

Publiczny klucz formularza

Zastosowanie

Wyślij formularz płatności HTML

Przyjmuje pola formularza z przeglądarki, tworzy hostowany link płatniczy i przekierowuje kupującego do checkout.

GET/api/partner/v1/makepay/payment-links/{uid}

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Odczytaj lub zaktualizuj link płatniczy

Odczytuje szczegóły linku płatniczego albo zmienia jego status na active, paused lub archived.

PATCH/api/partner/v1/makepay/payment-links/{uid}

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Odczytaj lub zaktualizuj link płatniczy

Odczytuje szczegóły linku płatniczego albo zmienia jego status na active, paused lub archived.

POST/api/partner/v1/makepay/payment-links/{uid}/send-request-email

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyślij żądanie płatności

Wysyła lub ponownie wysyła hostowany link na adres e-mail klienta.

GET/api/partner/v1/makepay/subscriptions

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl lub utwórz subskrypcje

Zwraca cykliczne plany subskrypcji MakePay albo tworzy subskrypcję i pierwszą fakturę.

POST/api/partner/v1/makepay/subscriptions

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl lub utwórz subskrypcje

Zwraca cykliczne plany subskrypcji MakePay albo tworzy subskrypcję i pierwszą fakturę.

GET/api/partner/v1/makepay/customers

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl lub zaktualizuj klientów

Zwraca profile klientów MakePay albo tworzy/aktualizuje klientów po adresie e-mail.

POST/api/partner/v1/makepay/customers

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl lub zaktualizuj klientów

Zwraca profile klientów MakePay albo tworzy/aktualizuje klientów po adresie e-mail.

POST/api/partner/v1/makepay/customers/{customerId}/portal

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Utwórz link do portalu klienta

Generuje na żądanie podpisany adres URL portalu klienta MakePay ważny przez 24 godziny.

GET/api/partner/v1/timezones

Autoryzacja

Publiczne

Zastosowanie

Wyświetl strefy czasowe

Zwraca obsługiwane identyfikatory stref czasowych IANA.

GET/api/partner/v1/makepay/settings

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Odczytaj lub zaktualizuj ustawienia MakePay

Odczytuje lub aktualizuje ustawienia rozliczeń, przekierowań, opłat i obsługi niedopłat.

PUT/api/partner/v1/makepay/settings

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Odczytaj lub zaktualizuj ustawienia MakePay

Odczytuje lub aktualizuje ustawienia rozliczeń, przekierowań, opłat i obsługi niedopłat.

GET/api/partner/v1/makepay/destination-assets

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl aktywa docelowe

Zwraca obsługiwane aktywa rozliczeniowe i bieżące aktywo domyślne.

GET/api/partner/v1/makepay/webhook-requests

Autoryzacja

MakePay API key or OAuth

Zastosowanie

Wyświetl dostarczenia webhooków

Pokazuje próby dostarczenia webhooków płatności i subskrypcji wraz ze statusem ponowienia.

GET/api/partner/v1/makepay/webhook-subscriptions/current

Autoryzacja

grant-bound OAuth

Zastosowanie

Read current webhook subscription

Read the webhook subscription owned by the current OAuth grant without revealing its signing secret.

PUT/api/partner/v1/makepay/webhook-subscriptions/current

Autoryzacja

grant-bound OAuth

Zastosowanie

Create or update webhook subscription

Create, reactivate, update, or explicitly rotate the current OAuth grant's MakePay payment webhook subscription.

DELETE/api/partner/v1/makepay/webhook-subscriptions/current

Autoryzacja

grant-bound OAuth

Zastosowanie

Disable current webhook subscription

Disable the current OAuth grant's webhook subscription and erase its stored signing secret.

Utwórz link do płatności

Funkcja tworzenia trasy wstawia łącze płatnicze MakePay, rozwiązuje domyślne ustawienia marki sprzedawcy i rozliczeń, wstawia pola rozliczeniowe w czasie wykonywania i zwraca publiczny adres URL checkout.

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",
    "feePaidBy": "merchant",
    "skipQuoteAcceptance": true,
    "lineItems": [
      {
        "id": "plan",
        "name": "Starter package",
        "unitAmount": "119.99",
        "quantity": 1
      }
    ],
    "extraCharges": [
      {
        "id": "shipping",
        "name": "Shipping",
        "kind": "shipping",
        "unitAmount": "10.00",
        "quantity": 1
      }
    ],
    "optionalItems": [
      {
        "id": "priority_setup",
        "name": "Priority setup",
        "unitAmount": "19.99",
        "quantity": 1,
        "adjustableQuantity": {
          "enabled": true,
          "minimum": 1,
          "maximum": 3
        }
      }
    ],
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "invoicePdfUrl": "https://merchant.example/invoices/1042.pdf",
    "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"
    }
  }
}

Informacje na temat przycisku przeglądarki bez kodu lub o niskim kodzie checkout można znaleźć w artykule Formularz przesyłania płatności. Akceptuje zwykły kod HTML POST tworzy ten sam rodzaj hostowanego łącza płatniczego i przekierowuje kupującego do MakePay checkout.

Wymagana konfiguracja

Firma musi mieć domyślny zasób docelowy MakePay. Jeśli rozliczenie nie jest skonfigurowane, trasa zwraca 409 z errorCode: "onboarding_required".

Pola kwoty i zasobu

W przypadku kwoty przeznaczonej dla klienta użyj payload.amount. Przekaż payload.asset dla dokładnego zasobu docelowego lub payload.currency, gdy domyślny zasób docelowy firmy może rozwiązać łańcuch. Jeśli waluta jest włączona w wielu łańcuchach i nie istnieje żadna domyślna waluta pasująca do firmy, jawnie przekaż payload.asset.

Wygaśnięcie

payload.expirationTime akceptuje 15m, 1h, 12h, 24h, 72h lub never. API przechowuje rozwiązany znacznik czasu expires_at na łączu płatniczym.

Utwórz odpowiedź

json
{
  "ok": true,
  "companyId": "8d15bb78-d0f8-45ef-88d7-2a1f1f79644b",
  "paymentRequestEmailSent": false,
  "paymentRequestEmailError": null,
  "paymentLink": {
    "id": "3a85f64-5717-4562-b3fc-2c963f66afa6",
    "uid": "01hzy4k6p4w9y2x7e2z7n8a2xm",
    "donation_slug": null,
    "link_type": "one_time",
    "source": "api",
    "status": "active",
    "amount": "129.99",
    "fiatAmount": "129.99",
    "fiatCurrency": "USD",
    "currency": "USDT",
    "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
    "title": "Website order #1042",
    "label": "Website order #1042",
    "description": "Checkout for order #1042",
    "orderId": "order_1042",
    "customerEmail": "buyer@example.com",
    "clientId": null,
    "metadata": {
      "source": "api"
    },
    "payload": {
      "title": "Website order #1042",
      "description": "Checkout for order #1042",
      "amount": "129.99",
      "fiatCurrency": "USD",
      "currency": "USDT",
      "asset": "ETH.USDT-0xdac17f958d2ee523a2206206994597c13d831ec7",
      "runtimeMode": "merchant_target_net_v2",
      "billingVersion": "v2",
      "merchantName": "Merchant Co",
      "merchantPaymentLinkTheme": "system",
      "customerEmail": "buyer@example.com",
      "orderId": "order_1042",
      "skipQuoteAcceptance": true,
      "metadata": {
        "source": "api"
      }
    },
    "latestSession": null,
    "timelineEvents": [],
    "publicUrl": "https://makepay.io/payment/01hzy4k6p4w9y2x7e2z7n8a2xm",
    "created_at": "2026-04-19T00:00:00.000Z",
    "updated_at": "2026-04-19T00:00:00.000Z",
    "expires_at": "2026-04-19T12:00:00.000Z",
    "dashboardUrl": "https://www.makecrypto.io/home/makepay/payment-links?orderUid=01hzy4k6p4w9y2x7e2z7n8a2xm"
  }
}

Lista linków płatniczych

Użyj trasy listy do uzgadniania zaplecza, pulpitów nawigacyjnych i testów dymnych.

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"

Uzyskaj szczegóły linku do płatności

Użyj trasy szczegółowej, jeśli masz już identyfikator UID łącza płatniczego i potrzebujesz znormalizowanego łącza, publicznego adresu URL checkout, ostatniej sesji płatności i zdarzeń na osi czasu.

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"

Wstrzymaj lub zarchiwizuj link do płatności

Użyj trasy statusu, aby zatrzymać opłacanie linku lub ukryć go przed aktywnymi operacjami.

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 "Idempotency-Key: order_1042_update_v1" \
  -H "Content-Type: application/json" \
  -d '{"status":"paused"}'

status musi być active, paused lub archived.

Wyślij prośbę o płatność e-mailem

MakeCrypto może wysłać hostowany link bezpośrednio na adres e-mail klienta w ładunku linku do płatności lub na zastępczą wiadomość e-mail w treści żądania.

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

Wysyłać e-mailem można wyłącznie aktywne linki do płatności. Wypełnionych linków do płatności nie można wysłać ponownie.

Potrzebujesz pomocy z konfiguracją partnerską?

Otwórz widok szczegółów linku płatniczego w MakeCrypto, aby skopiować wygenerowane fragmenty dla prawdziwego identyfikatora płatności, albo wróć do portalu, aby zarządzać ustawieniami sprzedawcy.

Otwórz portal