Jednostka nieprzetwarzalna
Gdy żądanie płatności nie może zostać zrealizowane z powodu podania nieprawidłowych informacji lub naruszenia reguł biznesowych. Następujące problemy mogą zwrócić błąd UNPROCESSABLE_ENTITY.
Uwaga: Jeśli problem nie ustąpi lub masz dodatkowe pytania, możesz skontaktować się z paypal-techsupport.com.
DUPLICATE_INVOICE_ID Zwroty z interfejsów API Płatności w wersji 1 lub Zamówienia w wersji 2.
Przyczyna: System
PayPal wykrywa zduplikowany identyfikator faktury. Każda transakcja wymaga unikalnego invoice_id , aby zapobiec duplikowaniu transakcji. Zwykle dzieje się tak, gdy ten sam numer zamówienia jest używany do wielu transakcji.
Zagrożenie
: proces płatności zostaje zatrzymany, co uniemożliwia klientowi sfinalizowanie zakupu. Może to prowadzić do utraty sprzedaży.
Rozwiązanie
: dla każdej transakcji użyj innego numeru faktury. Jeśli musisz wielokrotnie używać tego samego identyfikatora faktury, skontaktuj się z pomocą techniczną firmy PayPal. Rozważ skonfigurowanie błyskawicznych powiadomień o płatnościach (BPP) lub elementów webhook, aby otrzymywać aktualizacje o transakcjach w czasie rzeczywistym.
ORDER_ALREADY_AUTHORIZED Zwroty z interfejsów API Płatności w wersji 2 lub Zamówienia w wersji 2.
Przyczyna
: Zamówienie zostało już autoryzowane za pośrednictwem poprzedniego żądania. Gdy zamówienie jest tworzone za pomocą intent="AUTHORIZE", dozwolona jest tylko jedna autoryzacja. Druga próba zostanie odrzucona. Może się tak zdarzyć, jeśli przypadkowo wysłałeś to samo żądanie dwa razy lub jeśli przegapiłeś, że pierwsze żądanie zakończyło się pomyślnie.
Wpływ
: Nie ma wpływu na pierwotną autoryzację. Tylko druga próba jest odrzucana. Nie można teraz autoryzować części kwoty, a pozostałą część zatwierdzić później.
Rozwiązanie
Autoryzuj pełną kwotę w jednym żądaniu, a następnie w razie potrzeby utwórz wiele ujęć. Utwórz wiele przechwyć, ustawiając final_capture="false" w żądaniach przechwytywania. Jest to przydatne w przypadku przesyłek podzielonych. Rozważ zintegrowanie elementów webhook PayPal, aby automatycznie otrzymywać aktualizacje o statusie zamówienia. Jeśli wywołania API trwają zbyt długo, skontaktuj się z pomocą techniczną firmy PayPal.
ORDER_ALREADY_CAPTURED Zwroty z API Orders v2.
Przyczyna
Zamówienie PayPal ma już status "zarejestrowane", co oznacza, że płatność została zrealizowana, a środki zostały przelane na Twoje konto. W tym zamówieniu nie można tworzyć nowych ujęć. Dzieje się tak, jeśli używasz parametru intent="SALE" , który zezwala tylko na jedno pobranie danych na zamówienie, lub jeśli system nie zarejestrował powodzenia pierwszej próby pobrania i spróbuje ponownie.
Wpływ
Jeśli zarejestrowano tylko część kwoty zamówienia, nie można zarejestrować pozostałej kwoty, chyba że utworzysz nowe zamówienie w systemie PayPal. Nie ma to wpływu na klienta, jeśli zamierzasz mieć tylko jedno przechwytywanie, ale Twój system może nie być zsynchronizowany z rekordami PayPal.
Rozwiązanie
Jeśli chcesz wykonać wiele pobrań, użyj intent="AUTHORIZE" zamiast intent="SALE". Spowoduje to utworzenie autoryzacji, a następnie umożliwienie wielokrotnego przechwytywania. Upewnij się, że parametr final_capture jest ustawiony na wartość false w autoryzowanej płatności API wywołaniu przechwytywania, aby umożliwić dodatkowe przechwytywania. Użyj unikalnego nvoice_id idla każdego przechwytywania. Śledź pomyślne odpowiedzi API, aby uniknąć zduplikowanych wywołań. Rozważ skorzystanie z elementów webhook PayPal, aby otrzymywać automatyczne aktualizacje o zmianach statusu płatności.
ORDER_NOT_APPROVED Zwroty z interfejsów API Płatności w wersji 1 lub Zamówienia w wersji 2.
Przyczyna
: Klient rozpoczął proces realizacji transakcji w systemie PayPal, ale go nie ukończył lub żądanie może zawierać wymagane informacje o płatności.
Zagrożenie
: płatność została odrzucona i nie została przetworzona, co powoduje opóźnienia w zakupach.
Rozwiązanie
Upewnij się, że klient jest przekierowywany do adresu URL "rel":"approve" podanego przez firmę PayPal podczas tworzenia zamówienia. Spowoduje to przejście do procesu realizacji transakcji w systemie PayPal w celu zatwierdzenia płatności. Upewnij się, że żądanie zawiera wszystkie wymagane informacje dotyczące płatności.
SHIPPING_ADDRESS_INVALID Zwroty z interfejsów API Płatności w wersji 1 lub Zamówienia w wersji 2.
Przyczyna
Klient mógł pominąć ważne pola adresu, takie jak ulica, miasto lub województwo. Format adresu może być niepoprawny lub system może nie wysyłać poprawnie pełnego adresu w żądaniu.
Zagrożenie
: płatność została odrzucona i nie została przetworzona, co powoduje opóźnienia w zakupach.
Rozwiązanie
: Dodaj walidację formularza, aby upewnić się, że wszystkie wymagane pola adresu zostały poprawnie wypełnione przed przesłaniem. Rozważ użycie narzędzi do sprawdzania poprawności adresów, aby upewnić się, że adresy mają prawidłowy format. Sprawdź swoje systemy, aby upewnić się, że wszystkie informacje adresowe są prawidłowo rejestrowane i uwzględniane w żądaniach.