Przegląd interfejsu API
/orders/{id} oraz /orders/{id}/ są obecnie dostępne. ID zamówienia jest częścią linku płatności i należy traktować je jako wrażliwy nieprzezroczysty identyfikator; nie należy go publicznie rozpowszechniać.
Zapytanie anonimowe
Strona płatności może odczytywać dane bezpośrednio po utracie stanu logowania:id, description, price, state, pay_way, pay_url, expired_at, created_at. Nie zwraca konta, Application, Package, wewnętrznych identyfikatorów płatności ani metadata.
Zapytanie uwierzytelnione
application / applications, package / packages, bank_details, invoice_automation oraz pola modelu. Jeśli użytkownik jest uwierzytelniony, ale nie jest właścicielem zamówienia, zwracany jest 403; z wyjątkiem superadministratorów.
Kluczowe pola
Pełna odpowiedź może zawierać dodatkowe pola zależne od metody płatności; klient powinien odczytywać je w razie potrzeby i zawsze unikać rejestrowania wrażliwych metadata z pełnej odpowiedzi.
Obsługa błędów
404: ID zamówienia nie istnieje.403: Użytkownik jest zalogowany, ale nie jest właścicielem zamówienia.- Anonimowe żądania nie zwracają
401; otrzymują jedynie minimalną publiczną projekcję.
Korekta faktury i ponowne wnioskowanie
Za pomocąGET /api/v1/orders/{order_id}/invoice/ można odczytać bieżącą fakturę zamówienia. Po automatycznym przesłaniu korekty faktura nadal ma status Issued, a red_state wskazuje postęp korekty; pomyślne przesłanie nie oznacza ukończenia korekty. Podczas oczekiwania na potwierdzenie, wystawiania faktury korygującej lub archiwizacji zamówienie nie może ponownie wnioskować o fakturę.
Gdy administrator wnioskuje o korektę z powodu błędnych danych fakturowych, takich jak nazwa nabywcy lub numer podatkowy, powodem korekty jest „błąd wystawienia faktury”; automatyczna korekta wywołana zwrotem zamówienia nadal używa „zakończenie usługi”.
Po pomyślnym wystawieniu i zarchiwizowaniu faktury korygującej pierwotna faktura staje się Voided i dopiero wtedy zamówienie może ponownie wnioskować o fakturę. Pierwotną fakturę można zobaczyć w historii faktur. Gdy korekta nie powiedzie się lub wynik wymaga weryfikacji, obsługą zajmuje się dział finansowy, a ograniczenie wystawiania faktur dla zamówienia nie zostanie zniesione przedwcześnie. Faktury wystawione ręcznie muszą najpierw zostać unieważnione lub skorygowane w systemie podatkowym lub fakturowym, a następnie potwierdzone przez dział finansowy na platformie.

