Notyfikowanie statusu do sklepu

Notyfikowanie statusu kredytu dla sklepu polega na wysłaniu odpowiedniego żądania z dokumentem JSON na adres wskazany przez pole notifyUrl zawarte w treści żądania JSON wysyłanego w czasie tworzenia nowego wniosku. Jest to adres pod który powinno zostać wysyłana żądanie aktualizacji statusu (notyfikacja statusu). Statusy wysyłane są asynchronicznie metodą PUT (jeśli serwer odpowie 405 Method Not Allowed podejmowana jest próba wysłania metodą POST) . Po wysłaniu notyfikacji Comfino oczekuje statusu odpowiedzi 200 OK. W przypadku zwrócenia innego statusu, żądanie jest ponawiane aż do momentu zwrócenia 200 OK. Mogą zdarzyć się przypadki, że Comfino wyśle kilka żądań. W tym przypadku na każde żądanie powinien być zwrócony w odpowiedzi status 200 OK.

Po odbiorze notyfikacji przychodzącej z serwera Comfino, należy poddać weryfikacji wartość sygnatury znajdującą się w nagłówku CR-Signature. Sprawdzanie podpisu powiadomień ma na celu zapewnić zaufaną komunikację pomiędzy sklepem, a Comfino.

Kroki jakie należy wykonać, aby sprawdzić podpis:

• Do api-key powinna zostać dołączona treść żądania JSON, która została odebrana.
• Generujemy hash funkcją sha3-256 z powyższego łańcucha tekstowego.
• Jeśli hash jest równy wartości w CR-Signature, to żądanie jest prawidłowe.

Struktura przekazanego dokumentu JSON:

{
    "status": "CREATED",
    "externalId": "{twój_identyfikator_zamówienia:string}",
    "changedAt": {znacznik czasu informujący kiedy nastąpiła zmiana statusu:int},
    "paymentMethod": {wybrana przez użytkownika metoda płatności:string},
    "productType": {typ produktu (np. INSTALLMENTS_ZERO_PERCENT): string|null}
}

Budowa nagłówka CR-Signature:

sha3-256(api-key + json-request-body)

Metody płatności

• COMFINO finansowanie ratalne COMFINO
• BLIK płatność mobilna BLIK
• CARD karta kredytowa/debetowa
• null finansowanie nie zostało jeszcze udzielone

Lista możliwych statusów i metod płatności:

Statusy wniosku i metody płatności