Entité non traitable
Lorsque votre demande de paiement ne peut pas être traitée en raison d’informations incorrectes ou d’un non-respect des règles métier. Les problèmes suivants peuvent générer une erreur UNPROCESSABLE_ENTITY.
Remarque : Si un problème persiste ou si vous avez d’autres questions, vous pouvez paypal-techsupport.com contacter.
DUPLICATE_INVOICE_ID Retours à partir des API Paiements v1 ou Commandes v2.
Parce que
PayPal détecte un numéro de facture en double. Chaque transaction doit invoice_id unique pour éviter les transactions en double. Cela se produit généralement lorsque le même numéro de commande est utilisé pour plusieurs transactions.
Impact
: le processus de paiement s’arrête, ce qui empêche votre client de finaliser son achat. Cela peut entraîner une perte de ventes.
Résolution Utilisez
un numéro de facture différent pour chaque transaction. Si vous devez utiliser le même numéro de facture à plusieurs reprises, contactez l’assistance PayPal. Envisagez de configurer des notifications instantanées de paiement (IPN) ou des webhooks pour obtenir des mises à jour en temps réel sur les transactions.
ORDER_ALREADY_AUTHORIZED Retours à partir des API Paiements v2 ou Commandes v2.
Cause
La commande a déjà été autorisée par le biais d’une demande précédente. Lorsqu’une commande est créée avec intent="AUTHORIZE », une seule autorisation est autorisée. Une deuxième tentative sera rejetée. Cela peut se produire si vous avez accidentellement envoyé deux fois la même demande ou si vous n’avez pas vu que la première demande a abouti.
Impact
Il n’y a aucun impact sur l’autorisation initiale. Seule la deuxième tentative est rejetée. Vous ne pouvez pas autoriser un montant partiel maintenant et autoriser le reste plus tard.
Résolution
Autorisez le montant total en une seule demande, puis créez plusieurs collectes selon vos besoins. Créez plusieurs captures en définissant final_capture="false » dans vos demandes de capture. Ceci est utile pour les envois fractionnés. Envisagez d’intégrer les webhooks PayPal pour recevoir automatiquement des mises à jour sur l’état des commandes. Si les appels d’API prennent trop de temps, contactez le support technique de PayPal.
ORDER_ALREADY_CAPTURED Retours des commandes v2 API.
Cause
La commande PayPal a déjà l’état « Collecté », ce qui signifie que le paiement a été effectué et que l’argent a été transféré sur votre compte. Aucune nouvelle capture ne peut être créée sur cette commande. Cela se produit si vous utilisez intent="SALE » qui n’autorise qu’une seule collecte par commande, ou si votre système n’a pas enregistré le succès de la première tentative de collecte et réessaie.
Impact
Si vous n’avez collecté qu’une partie du montant de la commande, vous ne pouvez pas collecter le montant restant, sauf si vous créez une nouvelle commande PayPal. Cela n’a aucun impact sur votre client si vous ne souhaitez effectuer qu’une seule collecte, mais votre système peut ne pas être synchronisé avec les registres de PayPal.
Résolution
Si vous voulez plusieurs captures, utilisez intent="AUTHORIZE » au lieu de intent="SALE ». Cela crée d’abord une autorisation, permettant plusieurs captures par la suite. Assurez-vous que le paramètre final_capture est défini sur false dans votre API de paiement autorisé de capture pour autoriser d’autres captures. Utilisez un invoice_id unique pour chaque capture. Gardez une trace des réponses d’API réussies pour éviter les appels en double. Envisagez d’utiliser les webhooks PayPal pour recevoir des mises à jour automatiques sur les changements d’état des paiements.
ORDER_NOT_APPROVED Retours à partir des API Paiements v1 ou Commandes v2.
Votre
client a commencé mais n’a pas terminé la procédure de paiement PayPal, ou il se peut que les informations de paiement requises soient manquantes dans la demande.
Impact
: le paiement est rejeté et n’est pas traité, ce qui entraîne des retards d’achat.
Résolution
Assurez-vous que votre client est redirigé vers l’URL 'rel' :'approve' fournie par PayPal lorsque vous passez une commande. Cela les amène au flux de paiement PayPal pour approuver le paiement. Assurez-vous que votre demande inclut toutes les informations de paiement requises.
SHIPPING_ADDRESS_INVALID Retours à partir des API Paiements v1 ou Commandes v2.
Votre
client a peut-être oublié des champs d’adresse importants tels que l’adresse postale, la ville ou l’État. Le format de l’adresse est peut-être incorrect ou votre système n’envoie pas correctement l’adresse complète indiquée dans la demande.
Impact
: le paiement est rejeté et n’est pas traité, ce qui entraîne des retards d’achat.
Validation du formulaire d’ajout de résolution
pour s’assurer que tous les champs d’adresse requis sont correctement remplis avant de l’envoyer. Envisagez d’utiliser des outils de validation d’adresse pour vous assurer que les adresses suivent le bon format. Vérifiez vos systèmes pour vous assurer que toutes les informations d’adresse sont correctement saisies et incluses dans vos demandes.