Rapprochement des virements PayPal

Le processus de rapprochement consiste à vérifier les paiements reçus et traités et à les associer aux commandes PayPal correspondantes. Ne sont concernés que les clients qui reçoivent leurs fonds via PayPal plutôt que par l’intermédiaire de Stripe. Stripe rapproche automatiquement les transactions PayPal avant le virement, alors que cela n’est pas possible si les transactions sont créditées en dehors de la plateforme Stripe. Lorsque des transactions sont réglées en dehors de la plateforme Stripe, vous utiliserez les rapports PayPal disponibles sur votre compte PayPal ou avec le protocole sFTP pour le rapprochement.

Stripe propose deux manières de prendre en charge le rapprochement des transactions PayPal :

• (Recommandé) Utiliser le champ reference. Il s’agit de l’option à privilégier si vous avez un ID de commande ou de facture généré par votre entreprise, que vous pouvez insérer dans le champ de référence. Une fois le paiement effectué et traité, my_order_id apparaît sous la forme Invoice ID dans le rapport des règlements PayPal.
• Utiliser le transaction_id de l’objet Charge. Lorsque le paiement est traité, paypal_capture_id apparaît comme Transaction ID dans le rapport des règlements PayPal. Cette option n’est recommandée que si votre entreprise ne génère pas d’ID de commande.

Utiliser le paramètre Référence

Utilisez le champ reference pour renseigner la référence que vous avez attribuée à la commande d’un paiement PayPal (par exemple, l’ID de commande PayPal). Cette référence est visible à la fois par le client et dans le rapport des règlements de votre compte Paypal. Pour rapprocher des fonds à l’aide du champ reference, vous pouvez l’inclure dans le paramètre payment_method_options au moment de créer le PaymentIntent. Utilisez le champ reference pour associer des paiements effectués par l’intermédiaire de Stripe aux transactions correspondantes dans le rapport des règlements PayPal. Toutes les transactions ultérieures dérivées d’une transaction Payment initiale, telles que les remboursements et les contestations de paiement, seront également associées à cette reference.

L’exemple de code suivant illustre comment créer un PaymentIntent avec le paramètre reference défini dans payment_method_options :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_options[paypal][reference]"=my_order_id

Une fois le paiement effectué et traité, l’ID de la facture affiche my_order_id dans le rapport des règlements PayPal.

Utiliser l’ID de transaction de l’objet Charge

Le champ transaction_id contient l’ID utilisé par PayPal pour identifier la transaction. Pour rapprocher les fonds à l’aide du transaction_id, récupérez le transaction_id depuis le champ payment_method_details, lui-même contenu dans l’objet Charge. Le transaction_id est uniquement présent si le paiement a été débité. Il est utilisé pour rapprocher les paiements effectués par l’intermédiaire de Stripe et les transactions correspondantes figurant dans le rapport des règlements PayPal.

Par exemple, voici comment récupérer le transaction_id depuis l’objet Charge :

{
  "amount": 1099,
  "amount_captured": 1099,
  "payment_method_details": {
    "paypal": {
      "transaction_id": "paypal_capture_id",
      "payer_id": "ZA889USQQDD37",
      "payer_email": "jenny@example.com",
      "payer_name": "Jenny Rosen"
    },
    "type": "paypal"
  },
  "balance_transaction": "txn_3MrOPxGsnWT9WMaQ19vg30v3",
  "billing_details": {
    "address": {
      "city": "Co. Kerry",
      "country": "IE",
      "line1": "Skellig Michael",
      "line2": "Great Skellig",
      "postal_code": "12345",

Une fois le paiement traité, le Transaction ID affiche paypal_capture_id dans le rapport des règlements PayPal.

Accéder à vos rapports PayPal

Vous pouvez télécharger votre rapport des règlements PayPal et d’autres rapports à partir de paypal.com, ou vous pouvez activer les rapports sFTP en contactant PayPal.

Le rapport des règlements fournit une vue de bout en bout de toutes les transactions affectant le solde sur une période de 24 heures. Ce rapport est utilisé pour rapprocher les événements de transfert de fonds d’un compte PayPal avec les fonds transférés vers un compte bancaire associé.

Pour accéder au rapport des règlements :

1. Connectez-vous à votre compte professionnel PayPal.
2. Sous Activité, sélectionnez Tous les rapports.
3. Sélectionnez Transactions > Settlement.

En savoir plus sur les rapports PayPal et la manière de les télécharger.