Dokumentacja API

Szybki start API

Utwórz klucz MakePay API i wyślij swoje pierwsze żądanie serwera.

Wybierz zespół i klucz API

Utwórz klucz MakePay API z portalu MakeCrypto lub z zakładki Testy API po zalogowaniu. Zakładka Testy API ładuje Twoje zespoły, filtruje klucze MakePay API, otwiera modal tworzenia klucza, gdy wybrany zespół nie ma jeszcze klucza MakePay, i może wysyłać uwierzytelnione żądania z wybranym identyfikatorem klucza oraz sekretem.

Bazowy adres URL

Wszystkie trasy API partnera MakeCrypto są wersjonowane zgodnie z pochodzeniem produkcyjnym.

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

Do rozwoju lokalnego użyj lokalnego źródła MakeCrypto z tą samą strukturą ścieżki.

Uwierzytelnianie

Integracje serwerów powinny przy każdym żądaniu wysyłać identyfikator klucza MakePay API i klucz tajny API. Sekret jest zwracany dopiero po utworzeniu klucza API, dlatego przechowuj go w menedżerze kluczy tajnych po stronie serwera i nigdy nie wysyłaj go do przeglądarek klientów.

Nagłówek	Wartość	Uwagi
`x-makecrypto-key-id`	ID klucza MakePay API	Zaczyna się od `mk_makepay_` dla płatniczych API MakePay.
`x-makecrypto-key-secret`	Jednorazowy sekret API	Wyświetlany tylko podczas tworzenia klucza. Przechowuj go w serwerowym menedżerze sekretów.

Pierwsze żądanie odczytu

Zacznij od żądania odczytu, zanim utworzysz aktywne linki płatnicze. Pomyślna odpowiedź potwierdza, że identyfikator klucza, sekret, zakres produktu MakePay i firma będąca właścicielem klucza są prawidłowe.

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"

Pierwsze żądanie utworzenia

Utwórz linki płatnicze na swoim serwerze, gdy zamówienie, faktura lub sesja checkout będzie gotowa do płatności.

curl

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

Operacyjna lista kontrolna

Utwórz klucz API za pomocą produktu makepay.
Przed utworzeniem linków skonfiguruj domyślny zasób docelowy firmy.
Przechowuj klucz tajny API poza pakietami kontroli źródła i frontendu.
Traktuj identyfikatory UID linków płatniczych jako identyfikatory publiczne, ale wewnętrzne identyfikatory zamówień przechowuj w payload.orderId lub payload.metadata.
Nasłuchuj webhooks lub sonduj stan łącza płatniczego/sesji z portalu do momentu uruchomienia przepływu webhook zaplecza.