Entità non elaborabile

Quando la richiesta di pagamento non può essere completata a causa di informazioni errate o violazioni delle regole aziendali. I problemi seguenti potrebbero restituire un errore UNPROCESSABLE_ENTITY.

Nota: Se il problema persiste o se hai altre domande, puoi contattare paypal-techsupport.com.

DUPLICATE_INVOICE_ID Resi dalle API Pagamenti v1 o Ordini v2.

Causa:
PayPal rileva un ID fattura duplicato. Ogni transazione necessita di un invoice_id univoco per evitare transazioni duplicate. Ciò si verifica in genere quando lo stesso numero d'ordine viene utilizzato per più transazioni.

Impatto
Il processo di pagamento si interrompe impedendo al cliente di completare l'acquisto. Questo può portare a una perdita di vendite.

Risoluzione
Utilizza un numero di fattura diverso per ogni transazione. Se devi utilizzare ripetutamente lo stesso n. fattura, contatta l'assistenza PayPal. Prendi in considerazione la possibilità di configurare notifiche immediate di pagamento (IPN) o webhook per ricevere aggiornamenti in tempo reale sulle transazioni.

ORDER_ALREADY_AUTHORIZED Resi dalle API Pagamenti v2 o Ordini v2.

Causa:
l'ordine è già stato autorizzato tramite una richiesta precedente. Quando viene creato un ordine con intent="AUTHORIZE", è consentita una sola autorizzazione. Un secondo tentativo verrà rifiutato. Questo problema può verificarsi se hai accidentalmente inviato la stessa richiesta due volte o se non hai visto che la prima richiesta è andata a buon fine.

Impatto
: non vi è alcun impatto sull'autorizzazione originale. Solo il secondo tentativo viene rifiutato. Non puoi autorizzare un importo parziale ora e autorizzare il resto in un secondo momento.

Risoluzione
Autorizza l'intero importo in un'unica richiesta, quindi crea più acquisizioni in base alle esigenze. Crea più acquisizioni impostando final_capture="false" nelle tue richieste di acquisizione. Questa opzione è utile per le spedizioni frazionate. Prendi in considerazione l'integrazione dei webhook PayPal per ricevere automaticamente aggiornamenti sullo stato dell'ordine. Se le chiamate API richiedono troppo tempo, contatta l'assistenza tecnica di PayPal.

ORDER_ALREADY_CAPTURED Restituisce dall'API Orders v2.

Causa:
l'ordine PayPal è già in stato "acquisito", il che significa che il pagamento è stato completato e il denaro è stato trasferito sul tuo conto. Non è possibile creare nuove acquisizioni per questo ordine. Questo accade se si utilizza intent="SALE" che consente una sola acquisizione per ordine o se il sistema non ha registrato l'esito positivo del primo tentativo di acquisizione e riprova.

Impatto
: se hai acquisito solo una parte dell'importo dell'ordine, non puoi riscuotere l'importo rimanente a meno che tu non crei un nuovo ordine PayPal. Non c'è alcun impatto per il cliente se intendevi avere solo un'acquisizione, ma il tuo sistema potrebbe non essere sincronizzato con i record di PayPal.

Risoluzione
Se si desidera eseguire più acquisizioni, utilizzare intent="AUTHORIZE" anziché intent="SALE". In questo modo viene creata prima un'autorizzazione, che consente più acquisizioni in seguito. Assicurati che il parametro final_capture sia impostato su false nella chiamata API di pagamento autorizzato per l'acquisizione per consentire ulteriori acquisizioni. Usa un nvoice_id iunivoco per ogni acquisizione. Tieni traccia delle risposte API riuscite per evitare chiamate duplicate. Prendi in considerazione l'utilizzo dei webhook PayPal per ricevere aggiornamenti automatici sulle modifiche allo stato del pagamento.

ORDER_NOT_APPROVED Restituisce dalle API Pagamenti v1 o Ordini v2.

Causa:
Il cliente ha avviato la procedura di pagamento con PayPal ma non l'ha completata, oppure nella richiesta potrebbero mancare i dati di pagamento obbligatori.

Impatto:
il pagamento viene rifiutato e non elaborato, causando ritardi nell'acquisto.

Risoluzione
Assicurati che il cliente venga reindirizzato all'URL "rel":"approve" fornito da PayPal quando crei un ordine. In questo modo accede alla procedura di pagamento di PayPal per approvare il pagamento. Assicurati che la tua richiesta includa tutti i dati di pagamento richiesti.

SHIPPING_ADDRESS_INVALID Restituisce dalle API Pagamenti v1 o Ordini v2.

Causa:
il cliente potrebbe aver perso campi importanti dell'indirizzo, come l'indirizzo, la città o lo stato. Il formato dell'indirizzo potrebbe non essere corretto o il sistema potrebbe non inviare correttamente l'indirizzo completo nella richiesta.

Impatto:
il pagamento viene rifiutato e non elaborato, causando ritardi nell'acquisto.

Soluzione
: aggiungi la convalida del modulo per assicurarti che tutti i campi obbligatori dell'indirizzo siano compilati correttamente prima dell'invio. Prendere in considerazione l'utilizzo di strumenti di convalida degli indirizzi per assicurarsi che gli indirizzi seguano il formato corretto. Controlla i tuoi sistemi per assicurarti che tutte le informazioni sull'indirizzo vengano acquisite correttamente e incluse nelle tue richieste.