Deweloperzy

API dla zespołów płatniczych

Twórz faktury, przekierowuj klientów na checkout, odbieraj podpisane zdarzenia webhook i uzgadniaj statusy płatności we własnym systemie.

Pobierz klucz API Napisz do wsparcia

Uwierzytelnianie

Przekaż klucz w nagłówku. Wszystkie odpowiedzi są w formacie JSON. Bazowy URL: https://crynova.io/api/v1

Authorization: Bearer cryn_live_xxx
X-Api-Key: cryn_live_xxx

Utwórz fakturę

curl -X POST https://crynova.io/api/v1/invoices \
  -H "Authorization: Bearer cryn_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "149.00",
    "currency": "USDT_TRC20",
    "order_id": "ORD-1048",
    "description": "Order payment",
    "metadata": { "customer_id": "cus_9281" }
  }'

Możliwości API

Utwórz fakturę

Generuj żądania płatności z kwotą, walutą, ID zamówienia i metadanymi.

Sprawdzaj status

Odczytuj status faktury na potrzeby uzgodnień i wsparcia.

Zdarzenia webhook

Odbieraj invoice.paid, invoice.expired i aktualizacje potwierdzeń.

Punkty końcowe

Metoda	Punkt końcowy	Przeznaczenie
GET	/currencies	Lista dostępnych walut i sieci.
GET	/invoices	Lista faktur z filtrami.
POST	/invoices	Utwórz fakturę i otrzymaj adres + URL checkoutu.
GET	/invoices/{uuid}	Pełne szczegóły faktury.
GET	/invoices/{uuid}/status	Lekkie sprawdzenie statusu i potwierdzeń.
POST	/invoices/{uuid}/cancel	Anuluj nieopłaconą fakturę.

Odpowiedź

{
  "invoice_id": "7a4f...",
  "status": "pending",
  "currency": "USDT_TRC20",
  "amount": "149.00",
  "pay_address": "TR7x...",
  "checkout_url": "https://crynova.io/pay/7a4f...",
  "expires_at": "2026-06-07T12:30:00+00:00"
}

Webhook — zdarzenia i ładunek

X-Crynova-Event: invoice.paid
X-Crynova-Sig: sha256=...

{
  "event": "invoice.paid",
  "invoice_id": "7a4f...",
  "status": "paid",
  "amount": "149.00",
  "received": "149.00",
  "currency": "USDT_TRC20"
}

Zdarzenia

invoice.created Faktura utworzona.

invoice.waiting_confirmations Wykryto transakcję.

invoice.paid Opłacono w całości.

invoice.underpaid Otrzymano mniej niż należne.

invoice.expired Wygasła / anulowana.

Weryfikacja podpisu

Każdy webhook jest podpisany HMAC-SHA256. Zweryfikuj nagłówek X-Crynova-Sig.

$sig = 'sha256=' . hash_hmac(
    'sha256', $rawBody, $secret
);
if (! hash_equals($sig, $header)) {
    abort(401);
}

Gotowy do integracji?

Utwórz projekt, pobierz klucz API i przyjmij pierwszą płatność w kilka minut.

Pobierz klucz API Napisz do wsparcia