Przejdź do nawigacji

Transakcje i ponowne próby

Zobacz jako Markdown

Wypłata jest asynchroniczną operacją biznesową. Pomyślna odpowiedź HTTP oznacza, że ​​żądanie zostało obsłużone; nie ustala, czy środki dotarły w ramach łańcucha dostaw.

Zachowaj jeden identyfikator firmy

Wygeneruj i zapisz client_request_id przed wysłaniem wypłaty. Użyj go ponownie do ponownych prób tej samej zamierzonej operacji, w tym po ponownym uruchomieniu procesu. Zachowaj spójność pól transakcji; obecna implementacja odrzuca powtarzający się identyfikator ze sprzecznymi parametrami biznesowymi.

Nie polegaj wyłącznie na nagłówku Idempotency-Key. Dostarczony SDK może dodać ten nagłówek, ale bieżąca umowa deduplikacji wypłat opiera się na polu treści client_request_id.

Zrozumienie danych żądania

PoleOznaczający
chain_id, asset_idIdentyfikatory w uzgodnionym środowisku
to_address, amountMiejsce docelowe i dodatnia liczba dziesiętna reprezentowana jako ciąg znaków
client_request_idStabilny identyfikator żądania biznesowego
dest_memo_type, dest_memoSzczegóły notatki miejsca docelowego, jeśli wymaga tego sieć
client_authorizationAutoryzacja transakcji klienta dla wypłat inicjowanych kluczem API.
end_user_idOpcjonalny identyfikator użytkownika biznesowego w przepływie przedsiębiorstwa API.

W tej tabeli wyróżniono podstawowe pola, a nie kompletny schemat żądania. Potwierdź podgląd, potwierdzenie opłat i wymagania dotyczące opieki w porównaniu z wersją integracyjną. Unikaj binarnych kwot zmiennoprzecinkowych i nie kopiuj przykładowych numerów łańcuchów lub zasobów między środowiskami.

Śledź wynik

Podaj przykładyInterpretacja
pending_approval, pending_platform_reviewZatwierdzenie lub recenzja firmy nie została jeszcze zatwierdzona
approved, pending_signZatwierdzenie i podpisanie to oddzielne etapy
broadcasting, pending_chainTrwa nadawanie lub potwierdzanie łańcucha
broadcast_unverified, recoveringWynik jest nadal niepewny; nie twórz kolejnego przelewu
awaiting_reauthorizationW przypadku tego samego żądania może być wymagana nowa autoryzacja klienta
confirmedSystem zarejestrował potwierdzenie łańcucha

Lista ma charakter poglądowy i może ulegać zmianom. Zachowaj nieznane stany na potrzeby badania, zamiast przypisywać je do sukcesu lub porażki. Sama nieudana lub odrzucona wytwórnia nie jest wystarczającym dowodem na to, że nic nie zostało podpisane ani wyemitowane.

Odzyskaj siły po przekroczeniu limitu czasu

Zapytanie GET /api/v1/withdrawals/by-request przy użyciu oryginalnego parametru zapytania client_request_id. Kontynuuj odpytywanie lub uzgadnianie oryginalnej operacji, gdy jej wynik jest niepewny. Jeżeli wymagane jest odnowienie autoryzacji, użyj tego samego identyfikatora i uzgodnionej procedury odnowienia.

Anulowanie zależy od faktycznego etapu podpisywania umowy i kontroli serwera. Rozpocznij zastępczą działalność gospodarczą dopiero po ustaleniu, że oryginał nie został przeniesiony i nie można go przenieść. Otrzymuj wydarzenia przez webhooksi zachowaj zapytania API jako ścieżkę uzgadniania.