{"id":10455,"date":"2023-08-29T15:35:47","date_gmt":"2023-08-29T15:35:47","guid":{"rendered":"https:\/\/www.qly.docs.pay.sibs.com\/powiadomienia\/webhooks\/obsluga-powiadomien\/"},"modified":"2024-04-23T14:23:18","modified_gmt":"2024-04-23T14:23:18","slug":"obsluga-powiadomien","status":"publish","type":"page","link":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/sibs-gateway-dokumentacja\/powiadomienia\/webhooki\/obsluga-powiadomien\/","title":{"rendered":"Obs\u0142uga powiadomie\u0144"},"content":{"rendered":"\n

Webhook to interfejs API (FULL CODE), kt\u00f3ry dostarcza w czasie rzeczywistym informacje dotycz\u0105ce zmian w statusie p\u0142atno\u015bci transakcji.<\/p>\n\n

Sprzedawcy mog\u0105 otrzymywa\u0107 powiadomienia drog\u0105 elektroniczn\u0105<\/strong> lub za po\u015brednictwem punktu ko\u0144cowego<\/strong> (powiadomienie zmontowane dla zapytania o status – Checkout Status). Dla ka\u017cdej transakcji zostanie jednak wys\u0142ane tylko jedno powiadomienie.<\/p>\n\n

Powiadomienia s\u0105 wysy\u0142ane bezpo\u015brednio do punktu ko\u0144cowego (URL) skonfigurowanego przez sprzedawc\u0119. Parametryzacja tego punktu ko\u0144cowego musi by\u0107 wykonana w SIBS BackOffice.<\/p>\n\n

Za ka\u017cdym razem, gdy SIBS Gateway otrzyma aktualizacj\u0119 statusu p\u0142atno\u015bci transakcji, zostanie wys\u0142ane powiadomienie z nowym statusem p\u0142atno\u015bci transakcji.<\/mark> <\/p>\n\n

Ka\u017cdego dnia SIBS Gateway wysy\u0142a podsumowuj\u0105c\u0105 wiadomo\u015b\u0107 e-mail z najnowszymi nieudanymi powiadomieniami (wiadomo\u015b\u0107 e-mail musi by\u0107 zarejestrowana w SIBS BackOffice).<\/p>\n\n

Nie ma gwarancji co do kolejno\u015bci wiadomo\u015bci, zw\u0142aszcza je\u015bli r\u00f3\u017cnica czasu mi\u0119dzy powiadomieniami jest mniejsza ni\u017c czas potrzebny na ich przetworzenie lub z powodu jakichkolwiek problem\u00f3w komunikacyjnych lub systemowych. Gdy problemy zostan\u0105 rozwi\u0105zane, nowe powiadomienia b\u0119d\u0105 przychodzi\u0107 w czasie rzeczywistym, a stare b\u0119d\u0105 wysy\u0142ane ponownie. Je\u015bli nie otrzymano \u017cadnego powiadomienia, przed odrzuceniem jakiejkolwiek transakcji nale\u017cy skorzysta\u0107 z opcji „Status realizacji transakcji”.<\/p>\n\n

Powiadomienia s\u0105 wysy\u0142ane jako wywo\u0142ania zwrotne HTTPS (webhooks) do punktu ko\u0144cowego na serwerze. Upewnij si\u0119, \u017ce posiadasz wa\u017cny \u0142a\u0144cuch certyfikat\u00f3w SSL. Certyfikaty z podpisem w\u0142asnym nie s\u0105 wa\u017cne.<\/p>\n\n

Jak to dzia\u0142a?<\/h3>\n\n

Do otrzymywania powiadomie\u0144 potrzebny jest serwer, kt\u00f3ry posiada nast\u0119puj\u0105ce funkcje:<\/p>\n\n

    \n
  • Punkt ko\u0144cowy (Endpoint) zdolny do odbierania \u017c\u0105da\u0144 HTTP POST<\/mark>.<\/li>\n\n\n\n
  • Otwarty port TCP dla ruchu HTTPS (port 443 lub 80) z szyfrowaniem TLSv1.2.<\/li>\n<\/ul>\n\n

    W zale\u017cno\u015bci od sieci i wymaga\u0144 bezpiecze\u0144stwa mo\u017ce by\u0107 r\u00f3wnie\u017c konieczne umieszczenie naszej sieci na bia\u0142ej li\u015bcie zapory sieciowej. Aby upewni\u0107 si\u0119, \u017ce serwer poprawnie obs\u0142uguje powiadomienia, wymagamy potwierdzenia ka\u017cdego typu powiadomienia za pomoc\u0105 HTTP 200 i odpowiedzi zawieraj\u0105cej:<\/p>\n\n

    {\n      \"statusCode\"<\/mark>: \"200\"<\/mark>,\n      \"statusMsg\"<\/mark>: \"Success\"<\/mark>,\n      \"notificationID\"<\/mark>: \"2533e456-5e36-42c8-9eea-7961902f185e\"<\/mark>\n}<\/code><\/pre>\n\n
    Gdy serwer otrzyma powiadomienie, powinien:<\/p>\n\n
      \n
    • odszyfrowa\u0107 powiadomienie<\/li>\n\n\n\n
    • przechowa\u0107 powiadomienie w bazie danych<\/li>\n\n\n\n
    • potwierdzi\u0107 powiadomienie za pomoc\u0105 HTTP 200 OK, jak wyja\u015bniono wcze\u015bniej.<\/li>\n<\/ul>\n\n
      Deszyfrowanie<\/h3>\n\n
      Tre\u015b\u0107 powiadomienia jest szyfrowana w celu ochrony danych przed pr\u00f3bami oszustwa. Konwertuj\u0105c ci\u0105g znak\u00f3w czytelny dla cz\u0142owieka na format szesnastkowy, u\u017cywamy UTF-8.<\/p>\n\n
        \n
      • Algorytm szyfrowania: AES<\/li>\n\n\n\n
      • Tryb blokowy: GCM<\/li>\n\n\n\n
      • Wype\u0142nienie: None<\/li>\n\n\n\n
      • Wektor inicjalizacji: w nag\u0142\u00f3wku HTTP (X-Initialization-Vector)<\/li>\n\n\n\n
      • Znacznik uwierzytelniania : W nag\u0142\u00f3wku HTTP (X-Authentication-Tag)<\/li>\n\n\n\n
      • Format tre\u015bci: Base64<\/li>\n\n\n\n
      • Format wektora inicjalizacji: Base64<\/li>\n<\/ul>\n\n
        Przyk\u0142ad powiadomienia testowego:<\/strong><\/h5>\n\n
        Secret:<\/strong> O0Bur9uhZkS54NkwFhVyeutED6DhLbOQUBDt3i3W\/C4=\n<\/strong>X-Authentication-Tag: Ytw9bzOS1pXqizAKMGXVQ==\nContent-Type: text\/plain\nX-Initialization-Vector: Ldo3OyWNgRchSF3C<\/code><\/pre>\n\n
        Tre\u015b\u0107 przed odszyfrowaniem: <\/em><\/strong><\/h5>\n\n
        WgErmJOV6wg3BuRkrgZLUUnh57BYzhIzvBFdpadHRsc43UcjtZEevRGDIDu3YxocXMXe8O+xQpMRxwTJPv766IaNqUiUEjAIjZSMEYCZ0pBursUYB+9nB4eqNUiAS2MJ9sR+Cj2iBf6G6KXLfp9K6dK7c0UED5XrJwbovY8X8pMyxktFTEaflp0e76ZywsCQvtqEtqNz9uYEyqmAANbsBwbwyWpkCC8H1kZN2fV3CYetW1CTPmWdPp3C18Yfh826NN4XlKu1VmUmea70PyjmRKSsjPXpfrRX8udelVIK2WTFtnRxD4x588d1nlGY5D5DQmJ8KYZzfvjTmDXGAPiRIEGuXp8h6rBQXS8P\/m1llBtboGgQv4MmW3zvq0G6KFlYIcM=<\/code><\/pre>\n\n
        Tre\u015b\u0107 po odszyfrowaniu: <\/em><\/strong><\/h5>\n\n
        {\n  \"returnStatus\"<\/mark>: {\n    \"statusMsg\"<\/mark>: \"Success\"<\/mark>,\n    \"statusCode\"<\/mark>: \"000\"<\/mark>\n  },\n  \"paymentStatus\"<\/mark>: \"Success\"<\/mark>,\n  \"paymentMethod\"<\/mark>: \"CARD\"<\/mark>,\n  \"transactionID\"<\/mark>: \"WebhookTest\"<\/mark>,\n  \"amount\"<\/mark>: {\n    \"currency\"<\/mark>: \"EUR\"<\/mark>,\n    \"value\"<\/mark>: 10.0<\/mark>\n  },\n  \"merchant\"<\/mark>: {\n    \"terminalId\"<\/mark>: 1000000<\/mark>\n  },\n  \"paymentType\"<\/mark>: \"PURS\"<\/mark>,\n  \"notificationID\"<\/mark>: \"f153c248-e7be-4c12-8d88-6c9f1f3b83e4\"<\/mark>\n}<\/code><\/pre>\n\n
        Przyk\u0142ady<\/h5>\n\n
        Poni\u017cej znajduje si\u0119 kilka przyk\u0142ad\u00f3w pokazuj\u0105cych, jak odszyfrowa\u0107 powiadomienie webhook:<\/p>\n\n
        • C#<\/span><\/li>
        • Java<\/span><\/li>
        • PHP<\/span><\/li>
        • Python<\/span><\/li><\/ul><\/div>
          \n
          \n
          using<\/mark> System;\nusing<\/mark> System.Security.Cryptography;\nusing <\/mark>System.Text; public static class<\/mark> Program<\/mark> {public static void<\/mark> Main<\/mark>() {byte<\/mark>[] secret = System.Convert.FromBase64String(\"6fNDiYU0T0\/evFpmfycNai\/AqF24i+rT0OmuVw0\/sGQ=\"<\/mark>);byte<\/mark>[] ciphertext = System.Convert.FromBase64String(\"9bIjURJIcwoKvQr+ifOTH3HbMX+IqmsRqHuG\/I1GfbSX89JE5DcWh\/p8QROC5pRAuYZ7\"<\/mark>+\"ln7RSkHXJdZpVz1LFQ2859WsetvHHui7qYmfxATOO1j0AQuPdAD3FeRH0kR4s\/v3c2nV8\"<\/mark>+\"1DnUXFCnQER\/+VWrYdbu5vn8gm+diSE6CHvkK+ODy0ebVi5O6VBnWVjgBUG33VwWiAyIl\"<\/mark>+\"7Ik435V55WnZgynH3GfbVYoGwZ5UhYtn3yw2yruiLAKu6VTBvnh\/ZJP21cHCJSF6NPSd+8\"<\/mark>+\"1gzWFU\/+ECm3cf3uBbCkmKmL7HxRhRxhG0lMtX6ELZOXuw3eDJ1BTu+sSMkV\/5Xk+5XX48\"<\/mark>+\"XmP6CGZ7KmP7Q3Fw1kZmhn0unFyv0Gw8PjT1Ohny\/HMgNl16I=\"<\/mark>);byte<\/mark>[] nonce = System.Convert.FromBase64String(\"RYjpCMtUmK54T6Lk\"<\/mark>);byte<\/mark>[] tag = System.Convert.FromBase64String(\"FUajWHmZjP4A5qaa1G0kxw==\"<\/mark>);using<\/mark> (var<\/mark> aes = new<\/mark> AesGcm(secret))\n\n\t\t{var<\/mark> plaintextBytes = new<\/mark> byte<\/mark>[ciphertext.Length];\n\naes.Decrypt(nonce, ciphertext, tag, plaintextBytes);string<\/mark> decrypt = Encoding.UTF8.GetString(plaintextBytes);\n\n\t\t\tConsole.WriteLine(decrypt);\n\t\t}\n\t}\n}<\/code><\/pre>\n<\/div><\/div>\n\n\n\n
          \n
          import<\/mark> java.security.Security;\nimport<\/mark> java.util.Base64;import<\/mark> javax.crypto.Cipher;\nimport<\/mark> javax.crypto.spec.IvParameterSpec;\nimport<\/mark> javax.crypto.spec.SecretKeySpec;import<\/mark> com.google.common.base.Charsets;import<\/mark> org.apache.commons.lang3.ArrayUtils;\nimport <\/mark>org.bouncycastle.jce.provider.BouncyCastleProvider;\/\/ For Java and JVM-based languages, you might need to install unrestricted policy file for JVM,\n\/\/ which is provided by Sun. Please refer BouncyCastle FAQ if you get\n\/\/ java.lang.SecurityException: Unsupported keysize or algorithm parameters or\n\/\/ java.security.InvalidKeyException: Illegal key size.\n\n\/\/ If you cannot install unrestricted policy file for JVM because of some reason, you can try with reflection: See here.<\/mark>public class<\/mark> Test {public static void<\/mark> main<\/mark>(String[] args) {try<\/mark> {\n Security.addProvider(new<\/mark> BouncyCastleProvider<\/mark>());\/\/ Data from configuration<\/mark> String keyFromConfiguration<\/mark> = \"6fNDiYU0T0\/evFpmfycNai\/AqF24i+rT0OmuVw0\/sGQ=\"<\/mark>;\/\/<\/mark> Data from server<\/mark> String ivFromHttpHeader<\/mark> = \"RYjpCMtUmK54T6Lk\"<\/mark>;String authTagFromHttpHeader<\/mark> = \"FUajWHmZjP4A5qaa1G0kxw==\"<\/mark>;String<\/mark> httpBody<\/mark> = \"9bIjURJIcwoKvQr+ifOTH3HbMX+IqmsRqHuG\/I1GfbSX89JE5DcWh\/p8QROC5pRAuYZ7\"<\/mark>\n+\"ln7RSkHXJdZpVz1LFQ2859WsetvHHui7qYmfxATOO1j0AQuPdAD3FeRH0kR4s\/v3c2nV8\"<\/mark>\n+\"1DnUXFCnQER\/+VWrYdbu5vn8gm+diSE6CHvkK+ODy0ebVi5O6VBnWVjgBUG33VwWiAyIl\"<\/mark>\n+\"7Ik435V55WnZgynH3GfbVYoGwZ5UhYtn3yw2yruiLAKu6VTBvnh\/ZJP21cHCJSF6NPSd+8\"<\/mark>\n+\"1gzWFU\/+ECm3cf3uBbCkmKmL7HxRhRxhG0lMtX6ELZOXuw3eDJ1BTu+sSMkV\/5Xk+5XX48\"<\/mark>\n+\"XmP6CGZ7KmP7Q3Fw1kZmhn0unFyv0Gw8PjT1Ohny\/HMgNl16I=\"<\/mark>;\/\/ Convert data to process<\/mark> byte<\/mark>[] key = Base64.getDecoder().decode(keyFromConfiguration);byte<\/mark>[] iv = Base64.getDecoder().decode(ivFromHttpHeader);byte<\/mark>[] authTag = Base64.getDecoder().decode(authTagFromHttpHeader);byte<\/mark>[] encryptedText = Base64.getDecoder().decode(httpBody);\/\/ Unlike other programming language, We have to append auth tag at the end of\n \/\/ encrypted text in Java<\/mark> byte<\/mark>[] cipherText = ArrayUtils.addAll(encryptedText, authTag);\/\/ Prepare decryption<\/mark> SecretKeySpec keySpec<\/mark> = new<\/mark> SecretKeySpe<\/mark>c(key, 0<\/mark>, 32<\/mark>, \"AES\");Cipher cipher<\/mark> = Cipher.getInstance(\"AES\/GCM\/NoPadding\"<\/mark>);\n cipher.init(Cipher.DECRYPT_MODE, keySpec, new<\/mark> IvParameterSpec<\/mark>(iv));\n\/\/ Decrypt<\/mark> byte<\/mark>[] bytes = cipher.doFinal(cipherText);\n System.out.println(new<\/mark> String<\/mark>(bytes, Charsets.UTF_8));\n\n } catch<\/mark> (Exception e) {\n e.printStackTrace();\n }\n }\n}<\/code><\/pre>\n<\/div><\/div>\n\n\n\n
          \n
          function<\/mark> sodium_decrypt<\/mark>( $webhookSecret<\/mark>, $iv_from_http_header<\/mark>, $http_body<\/mark> , $auth_tag_from_http_header<\/mark> ){$key<\/mark> = mb_convert_encoding<\/mark>($webhookSecret<\/mark>, \"UTF-8\"<\/mark>, \"BASE64\"<\/mark>);$iv<\/mark> = mb_convert_encoding<\/mark>($iv_from_http_header<\/mark>, \"UTF-8\"<\/mark>, \"BASE64\"<\/mark>);$cipher_text<\/mark> = mb_convert_encoding<\/mark>($http_body<\/mark>, \"UTF-8\"<\/mark>, \"BASE64\"<\/mark>) . mb_convert_encoding<\/mark>($auth_tag_from_http_header<\/mark>, \"UTF-8\"<\/mark>, \"BASE64\"<\/mark>);$result<\/mark> = sodium_crypto_aead_aes256gcm_decrypt<\/mark>($cipher_text<\/mark>, \"\"<\/mark>, $iv<\/mark>, $key<\/mark>);return<\/mark> $result<\/mark>;\n\n}$webhookSecret<\/mark> = \"6fNDiYU0T0\/evFpmfycNai\/AqF24i+rT0OmuVw0\/sGQ=\"<\/mark>;\n$iv_from_http_header<\/mark> = \"RYjpCMtUmK54T6Lk\"<\/mark>;\n$auth_tag_from_http_header<\/mark> = \"FUajWHmZjP4A5qaa1G0kxw==\"<\/mark>;\n$http_body<\/mark> = \"9bIjURJIcwoKvQr+ifOTH3HbMX+IqmsRqHuG\/I1GfbSX89JE5DcWh\/p8QROC5pRAuYZ7\"<\/mark> .\n\"ln7RSkHXJdZpVz1LFQ2859WsetvHHui7qYmfxATOO1j0AQuPdAD3FeRH0kR4s\/v3c2nV8\"<\/mark> .\n\"1DnUXFCnQER\/+VWrYdbu5vn8gm+diSE6CHvkK+ODy0ebVi5O6VBnWVjgBUG33VwWiAyIl\"<\/mark> .\n\"7Ik435V55WnZgynH3GfbVYoGwZ5UhYtn3yw2yruiLAKu6VTBvnh\/ZJP21cHCJSF6NPSd+8\"<\/mark> .\n\"1gzWFU\/+ECm3cf3uBbCkmKmL7HxRhRxhG0lMtX6ELZOXuw3eDJ1BTu+sSMkV\/5Xk+5XX48\"<\/mark> .\n\"XmP6CGZ7KmP7Q3Fw1kZmhn0unFyv0Gw8PjT1Ohny\/HMgNl16I=\"<\/mark>;\/\/ Decrypt message<\/mark>\n$result<\/mark> = sodium_decrypt<\/mark>($webhookSecret<\/mark>, $iv_from_http_header<\/mark>, $http_body<\/mark> , $auth_tag_from_http_header<\/mark>);print<\/mark>($result<\/mark>);<\/code><\/pre>\n<\/div><\/div>\n\n\n\n
          \n
          import<\/mark> base64\nfrom<\/mark> Cryptodome.Cipher import<\/mark> AES def<\/mark> decrypt_AES_GCM<\/mark>(encryptedMsg, authTag, secretKey, iv):\n iv = base64.b64decode(iv)\n encryptedMsg = base64.b64decode(encryptedMsg)\n secretKey = base64.b64decode(secretKey)\n authTag = base64.b64decode(authTag)\n aesCipher = AES.new(secretKey, AES.MODE_GCM, iv)\n plaintext = aesCipher.decrypt_and_verify(encryptedMsg, authTag)return<\/mark> plaintext\n\n example = {\"encoded\"<\/mark> : \"9bIjURJIcwoKvQr+ifOTH3HbMX+IqmsRqHuG\/I1GfbSX89JE5DcWh\/p8QROC5pRAuYZ7\"<\/mark> \\\n\"ln7RSkHXJdZpVz1LFQ2859WsetvHHui7qYmfxATOO1j0AQuPdAD3FeRH0kR4s\/v3c2nV8\"<\/mark> \\\n\"1DnUXFCnQER\/+VWrYdbu5vn8gm+diSE6CHvkK+ODy0ebVi5O6VBnWVjgBUG33VwWiAyIl\"<\/mark> \\\n\"7Ik435V55WnZgynH3GfbVYoGwZ5UhYtn3yw2yruiLAKu6VTBvnh\/ZJP21cHCJSF6NPSd+8\"<\/mark> \\\n\"1gzWFU\/+ECm3cf3uBbCkmKmL7HxRhRxhG0lMtX6ELZOXuw3eDJ1BTu+sSMkV\/5Xk+5XX48\"<\/mark>\n\"XmP6CGZ7KmP7Q3Fw1kZmhn0unFyv0Gw8PjT1Ohny\/HMgNl16I=\"<\/mark>,\"iv\"<\/mark> : \"RYjpCMtUmK54T6Lk\"<\/mark>,\"tag\"<\/mark> : \"FUajWHmZjP4A5qaa1G0kxw==\"<\/mark>,\"secret\"<\/mark> : \"6fNDiYU0T0\/evFpmfycNai\/AqF24i+rT0OmuVw0\/sGQ=\"<\/mark>}\n\n\nresult = decrypt_AES_GCM(example['encoded'<\/mark>], example['tag'<\/mark>], example['secret'<\/mark>], example['iv'])\nprint<\/mark>(result)<\/code><\/pre>\n<\/div><\/div>\n<\/div><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
          Webhook to interfejs API (FULL CODE), kt\u00f3ry dostarcza w czasie rzeczywistym informacje dotycz\u0105ce zmian w statusie p\u0142atno\u015bci transakcji. Sprzedawcy mog\u0105 otrzymywa\u0107 powiadomienia drog\u0105 elektroniczn\u0105 lub za po\u015brednictwem punktu ko\u0144cowego (powiadomienie zmontowane dla zapytania o status – Checkout Status). Dla ka\u017cdej transakcji zostanie jednak wys\u0142ane tylko jedno powiadomienie. Powiadomienia s\u0105 wysy\u0142ane bezpo\u015brednio do punktu ko\u0144cowego (URL) […]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":10428,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_eb_attr":"","footnotes":""},"class_list":["post-10455","page","type-page","status-publish","hentry","has-post-title","has-post-date","has-post-category","has-post-tag","has-post-comment","has-post-author",""],"acf":[],"builder_content":"","_links":{"self":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10455","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/comments?post=10455"}],"version-history":[{"count":2,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10455\/revisions"}],"predecessor-version":[{"id":10685,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10455\/revisions\/10685"}],"up":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10428"}],"wp:attachment":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/media?parent=10455"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}