Notyfikacja statusu zamówienia

Comfino wysyła żądanie z dokumentem JSON na adres notifyUrl podany podczas tworzenia wniosku. Statusy wysyłane są asynchronicznie metodą PUT (jeśli serwer odpowie 405 Method Not Allowed, Comfino ponawia próbę metodą POST). Comfino oczekuje odpowiedzi 200 OK — przy każdym innym kodzie żądanie jest powtarzane aż do otrzymania 200 OK. Comfino może wysłać kilka żądań; na każde sklep powinien odpowiedzieć 200 OK.

Po odebraniu notyfikacji należy zweryfikować sygnaturę z nagłówka CR-Signature, aby potwierdzić, że żądanie pochodzi od Comfino.

Weryfikacja podpisu CR-Signature

1. Połącz api-key z treścią odebranego żądania JSON.
2. Wygeneruj hash funkcją sha3-256 z powstałego łańcucha tekstowego.
3. Porównaj hash z wartością nagłówka CR-Signature — równość oznacza prawidłowe żądanie.

Budowa nagłówka CR-Signature:

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

Struktura dokumentu JSON żądania

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

Metody płatności

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

Kody odpowiedzi serwera

Sklep powinien odpowiadać wyłącznie kodem 200 OK. Każdy inny kod spowoduje ponowne wysłanie notyfikacji przez Comfino.

Statusy wniosku i metody płatności