Przejdź do głównej treści
Wyszukiwanie zamówienia według ID zamówienia. Ten punkt końcowy obsługuje dwa tryby odczytu: dostęp anonimowy zwraca tylko minimalne pola wymagane przez stronę płatności; właściciel zamówienia z Account Token otrzymuje pełne szczegóły.

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:
Odpowiedź anonimowa zawiera tylko 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

Właściciel zamówienia otrzyma pełne szczegóły Order, w tym 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.

Powiązane interfejsy API