Transakcje i ponowne próby
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
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
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.