Notyfikacja statusu zamówienia

ComfinoPay 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, ComfinoPay ponawia próbę metodą POST). ComfinoPay oczekuje odpowiedzi 200 OK — przy każdym innym kodzie żądanie jest powtarzane aż do otrzymania 200 OK. ComfinoPay 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 ComfinoPay.

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 ComfinoPay.

Statusy wniosku i metody płatności