B2B API · podpisane webhooki · techniczne potwierdzenia

Sprawdź podpis webhooka.
Odbierz techniczny receipt.

IntegrityPhase sprawdza podpis HMAC, znacznik czasu i odcisk kryptograficzny danych przesłanego webhooka, a następnie zwraca wynik czytelny dla oprogramowania. Udana kontrola daje techniczne potwierdzenie integralności — receipt. Nie potwierdza ono prawdziwości, legalności ani bezpieczeństwa finansowego zdarzenia.

webhook_integrity.v1POST /verify/webhook-integrityDostęp po onboardingu B2B
ŻĄDANIEwebhook_integrity.v1payload · timestamp · HMAC
RECEIPT verifiedrequest_id · artifact_hash

Jeden produkt, jedna publiczna operacja

Podpisany webhookŚwieżość timestampuFingerprint payloaduMaszynowo czytelny receipt
01

Zdefiniowany przepływ weryfikacji

Od podpisanego webhooka do ograniczonego technicznego receiptu.

01

Wyślij

Onboardowany agent wysyła dozwoloną metodę z payloadem, timestampem, identyfikatorami event/source i podpisem HMAC.

02

Sprawdź

Usługa stosuje politykę metody i wydania, porównuje podpis HMAC-SHA256, sprawdza świeżość timestampu oraz wylicza fingerprint i rozmiar payloadu.

03

Odbierz

Agent otrzymuje ustrukturyzowany status, identyfikatory i hashe do dalszej korelacji, odczytu artifactu i audytu.

02

Maszynowo czytelny receipt

Wystarczająco dużo danych do prześledzenia kontroli — bez nadmiernych obietnic.

Wydany receipt identyfikuje metodę, żądanie i techniczny artifact. Zapisuje status weryfikacji, wyniki właściwych kontroli, timestampy i fingerprinty. Surowa treść payloadu nie jest częścią publicznego receiptu.

„Techniczny receipt” oznacza artifact weryfikacyjny zwracany przez API. Nie jest potwierdzeniem płatności ani fakturą.

  • metoda, żądanie i status wyniku;
  • identyfikatory artifactu i proofu wraz z hashami;
  • wyniki kontroli podpisu i timestampu;
  • hash i rozmiar payloadu do korelacji;
  • jawne ograniczenia oraz referencje audytowe.
receipt-excerpt.jsonILUSTRACJA
{
  "schema_version": "canon.verify_webhook_integrity_response.v1",
  "request_id": "req_…",
  "status": "verified",
  "proof_released": true,
  "artifact": {
    "method_id": "webhook_integrity.v1",
    "artifact_id": "whi_…",
    "artifact_hash": "sha256:…",
    "evidence": {
      "signature_valid": true,
      "timestamp_valid": true,
      "payload_hash": "sha256:…"
    }
  }
}
03

Co rzeczywiście jest sprawdzane

Celowo mała powierzchnia weryfikacji.

IntegrityPhase raportuje wyłącznie kontrole wykonane przez skonfigurowaną metodę. Nie interpretuje biznesowego znaczenia payloadu.

METODA + POLITYKA

Dozwolona operacja

Metodą musi być webhook_integrity.v1, a skonfigurowana polityka musi zezwolić na wydanie technicznego artifactu.

HMAC + CZAS

Podpis i świeżość

Podpis HMAC-SHA256 jest porównywany z podpisem wyliczonym dla skonfigurowanego sekretu oraz przesłanego payloadu/timestampu. Timestamp musi być czytelny i mieścić się w skonfigurowanym oknie.

FINGERPRINT

Korelacja payloadu

Usługa wylicza kanoniczny hash i rozmiar payloadu, aby można było skorelować sprawdzone dane bez umieszczania surowej treści w receipcie.

04

Automatyczny onboarding B2B

Od rejestracji firmy do technicznego potwierdzenia.

Przygotowany agent korzysta z istniejącego upoważnienia firmy i portfela przez MCP IntegrityPhase, bez obowiązkowego interaktywnego konfiguratora. Przedsiębiorcy z 27 państw UE i obsługiwanych terytoriów VAT, w tym JDG. Każdy nabywca wymaga dostatecznych dowodów tożsamości, statusu podatkowego i upoważnienia. Nierozstrzygnięta kwalifikacja zatrzymuje płatność; konsumenci i użytek prywatny są wykluczeni.

PRZEDSIĘBIORCY UE · 27 PAŃSTW
  1. 01

    Poznaj API

    Odczytaj GET /.well-known/canon.json: format żądania, warunki kwalifikacji, bieżącą dostępność i warunki płatności.

  2. 02

    Zarejestruj firmę

    Prześlij dane firmy i VAT, podpisaną deklarację agenta oraz podpis portfela przez POST /onboarding/b2b. Zaakceptuj dokładne wersje Regulaminu, Polityki prywatności i ramowej DPA.

  3. 03

    Zleć weryfikację

    Po włączeniu płatnego dostępu prześlij podpisany webhook do POST /verify/webhook-integrity i jawnie autoryzuj wymaganą płatność. Sam onboarding nie upoważnia do wydawania środków.

  4. 04

    Odczytaj wynik

    Obsłuż wynik verified, failed lub inconclusive według własnych zasad. Identyfikatory i odciski danych w receipcie pozwalają powiązać techniczne dowody kontroli.

Bieżącą dostępność sprzedaży pokazuje panel statusu. Ta strona informacyjna nie rejestruje firmy, nie zapisuje akceptacji i nie uruchamia płatności. Zobacz trzy aktualne dokumenty w wersji 1.7.0. API sprawdza podpisaną deklarację i kontrolę nad kluczem; opiera się na deklarowanym umocowaniu, bez niezależnego potwierdzenia prawa do reprezentowania firmy.

05

Jawne granice produktu

Techniczny receipt nie jest certyfikatem prawdy.

IntegrityPhase przedstawia to, co skonfigurowane kontrole zaobserwowały dla przesłanych bajtów i metadanych w określonym czasie. Za źródło, zdarzenie biznesowe i dalszą decyzję odpowiada klient.

Poprawny podpis może powiązać bajty ze skonfigurowanym sekretem. Nie dowodzi, że przedstawione zdarzenie wystąpiło ani że jego treść jest poprawna.

01

Brak gwarancji prawdziwości zdarzenia, deklaracji w payloadzie lub oświadczenia źródła.

02

Brak statusu kwalifikowanej usługi zaufania i domniemań prawnych właściwych takiej usłudze.

03

Brak gwarancji bezpieczeństwa finansowego, finalności płatności, wypłacalności lub wyniku biznesowego.

04

Brak rekomendacji prawnej, podatkowej, finansowej, inwestycyjnej, medycznej lub operacyjnej.

05

Brak custody środków klienta, kluczy portfela/prywatnych lub sekretów autoryzujących transakcję i brak udziału w bazowej transakcji klienta.

06

Zakres kontroli określa opublikowany kontrakt metody; receipt nie jest pełnym audytem bezpieczeństwa integracji.

06

Zasady operacyjne

Mała powierzchnia. Jasny ślad. Fail closed.

MINIMALIZACJA

Receipt, nie archiwum payloadu

Publiczny wynik preferuje identyfikatory, timestampy i fingerprinty kryptograficzne zamiast surowej treści klienta.

IDENTYFIKOWALNOŚĆ

Powiązane rekordy techniczne

Referencje request, proof, artifact, ledger i audit mogą być skorelowane bez zamiany wyniku technicznego w roszczenie prawne.

FAIL-CLOSED

Brak warunku zatrzymuje wydanie

Brak dostępu, polityki, podpisu, timestampu lub warunku wydania daje wynik blocked, failed albo inconclusive — nie sukces.

07

Wsparcie integracji

Pytania o integrację?

Skontaktuj się w sprawie API, prywatności lub bezpieczeństwa. Rejestracja firmy i akceptacja dokumentów odbywają się przez automatyczny onboarding API.

dostępność: zobacz aktualny status
Prywatność[email protected]PRIVACY
Wsparcie[email protected]TECHNICAL
BezpieczeństwoOdpowiedzialne zgłoszenieSECURITY.TXT

Nie wysyłaj e-mailem payloadów, kluczy API, kluczy portfela, podpisów płatniczych ani innych sekretów.