Visualisation d'une page Webjax
Créer des procédures de paiements Paypal
Cette page est propulsée par 
Cette page présente une traduction française de la page de documentation Paypal API présentant la méthode autorisant les procédures de paiements dits de "masse" soit une procédure de paiements groupés tels qu'on peut en trouver sur AuctionAds par exemple.
La version originale de ce document est accessible en cliquant ici.
00 :: Mass Payment, paiements de masse
« Mass Payment » vous permet de transmettre automatiquement des sommes d'argent à un ou plusieurs destinataires. Avec « Mass Payment », c'est l'expéditeur qui supporte les frais de transactions, pas le destinataire.
Les frais de transactions pour les paiements « Mass Payment » est de 2% par paiement effectué avec un maximum fixé à 1$ par paiement.
Il existe deux façons d'utiliser l'outil « Mass Payment » :
-
Vous pouvez soumettre votre procédure « Mass Payment » directement depuis votre compte « Premier » ou « Business » en uploadant un fichier contenant les informations à utiliser pour effectuer les paiements.
-
Vous pouvez effectuer votre procédure « Mass Payment » de façon programmatique en utilisant la « MassPay API »
Le contenu présenté vous permet d'implémenter « Mass Payment » de façon programmatique.
01 :: Communiquer avec l'API « Mass Payment »
L'API « Mass Payment » vous permet d'envoyer des paiements à plus de 250 destinataires en une seule requête/appel. Le montant de chaque paiement peut être précisé mais tous les paiements présents au sein d'un même appel doivent être exprimés dans la même devise.
Vous pouvez choisir de préciser l'identité des destinataires à l'aide de leur adresse email ou de leur identifiant de compte Paypal.
L'API Paypal qui reçoit les requêtes de « Mass Payment » retourne une réponse indiquant le status « successfull » ou « failure » du ou des remboursements.
Dans le cas ou l'API Paypal retourne une réponse « successfull », Paypal procède au paiement précisé et, si vous avez l'option « IPN » (Instant Payment Notifications ou Notifications de paiements en temps réel) activée, Paypal envoit une confirmation de paiement à la « Notify URL » précisée dans les informations de votre profil Paypal.
Si vous n'avez l'option « IPN » activée vous pouvez constater l'effectivité des paiements à travers l'interface web de votre compte Paypal.
L'API « Mass Payment » est accessible à la fois en NVP et via SOAP.
02 :: Recevoir et traiter les Notifications de paiements de l'API « Mass Pay »
Si vous possédez l'option « IPN » activée sur votre compte Paypal, Paypal vous enverra deux « IPN » pour chaque transaction effectuée durant le traitement de la requête « Mass Payment ».
Les « IPN » seront postées à l'url « Notify URL » précisée dans votre profil Paypal.
Paypal transmet en premier le « Processed IPN ». Cet « IPN » est transmis lorsque les fonds nécessaires pour effectuer le paiement ont été « sortis » du compte du payeur.
Paypal transmet ensuite le « Completed IPN ». Si tous les destinataires de paiements sont habilités à recevoir des paiements, Paypal transmet de le « Completed IPN » quelques secondes après le « Processed IPN ». Si un ou plusieurs destinataires ne peuvent recevoir le paiement qui leur est destiné, le « Completed IPN » est transmis lorsque l'ensemble des destinataires sont habilités à recevoir le paiement.
Si après 30 jours, l'ensemble des destinataires n'est toujours pas prête à recevoir les paiements, le « Completed IPN » est tranmis avec les précisions sur les paiements qui n'ont pu être effectués et la l'argent « non réclamé par les destinataires » est replacé sur le compte Paypal du payeur.
Les frais de transactions payés à cette occasion par le payeur ne sont pas reversés par Paypal au payeur.
!!! :: un destinataire est habilité à recevoir un paiement « Mass Payment » à partir du moment ou son compte Paypal justifie d'une adresse email vérifiée.
Vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour plus de détails sur les « IPN » ou Notifications de paiements en temps réel.
Vous pouvez aussi consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn.html pour obtenir des détails sur les variables transmises via « IPN »
02.a :: « Processed IPN »
Paypal transmet les « Processed IPN » lorsque les fonds ont été débités du compte du payeur.
Pour chaque paiement effectué, Paypal génère et retourne un identifiant unique « Transaction ID » dans la variable « masspay_txn_id ».
Pour chaque paiement, Paypal retourne également la valeur « unique_id ». Ce paramètre « unique ID » dans la procédure « Mass Payment » provient de votre système d'informations/vérifications et est optionelle.
Paypal génère également un statut de transaction qui peut être « Completed », « Failed », « Reversed » ou « Unclaimed ».
Pour plus d'informations sur ces valeurs vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html .
Est présenté ci après un exemple de « Processed IPN ». Nous pouvons noter d'une manière globale que dans ce « Processed IPN », le « payment_status » est « Processed » et « status_2 » est « Unclaimed » en raison du fait que l'utilisateur visé par le paiement « 2 » n'a pas encore configuré son compte Paypal.
payer_id=HZU8ZEBYHLEZQ&
payment_date=09%3A01%3A16+Dec+21%2C+2006+PST&
payment_gross_1=25.99&
payment_gross_2=9.99&
payment_status=Processed&
receiver_email_1=fred@unknowncompany.com&
receiver_email_2=john@fictionalcompany.com&
charset=windows-1252&
mc_currency_1=USD&
masspay_txn_id_1=5W531651W5136225N&
mc_currency_2=USD&
masspay_txn_id_2=8P09425963946233T&
first_name=Robert&
unique_id_1=12345&
notify_version=2.1&
unique_id_2=45678&
payer_status=verified&
verify_sign=AB5URHwIzIbcANTQUdSveiWRw8-WACTmrKK-dops2Tb6KKAQnpUJyF.l
&payer_email=robert@hisowncompany.com&
payer_business_name=His+Own+Company&
last_name=Moore&
status_1=Completed&
status_2=Unclaimed&
txn_type=masspay&
mc_gross_1=25.99&
mc_gross_2=9.99&
payment_fee_1=0.52&
residence_country=US&
payment_fee_2=0.20&
test_ipn=1&
mc_fee_1=0.52&
mc_fee_2=0.20
!!! :: il est important de noter que les sauts de ligne (\n) ont été ajoutés afin de faciliter la lecture des paramètres et valeurs.
Vous pouvez consulter l'url suivante https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour plus de détails sur les variables IPN.
02.b :: « Completed IPN »
Paypal transmet le « Completed IPN » lorsque tous les destinataires ont pu recevoir leur paiement ou lorsque 30 jours ont passés depuis la procédure « Mass Payment ».
L'extrait de « Completed IPN » présenté ci après inclut les paramètres suivants : « txn_type » à « masspay », « payment_status » à « Completed » et « status_2 » désormais à « Completed » (ndr : voir extrait de « Processed PIN » ci avant) en raison du fait que l'utilisateur a configuré/fait vérifié son compte Paypal.
payer_id=HZU8ZEBYHLEZQ&
payment_date=09%3A01%3A23+Dec+21%2C+2006+PST&
payment_gross_1=25.99&
payment_gross_2=9.99&
payment_status=Completed&
receiver_email_1=fred@unknowncompany.com&
receiver_email_2=john@fictionalcompany.com&charset=windows-1252&
mc_currency_1=USD&
masspay_txn_id_1=5W531651W5136225N&
mc_currency_2=USD&
masspay_txn_id_2=8P09425963946233T&
first_name=Robert&
unique_id_1=12345&
notify_version=2.1&
unique_id_2=45678&
payer_status=verified&
verify_sign=AgHNi5eT0bHgt8xiwqeAG7bDTOsvAkW2ba1G3x3K7ayAOd.bmkafCd-f&
payer_email=robert@hisowncompany.com&
payer_business_name=His+Own+Company&
last_name=Moore&
status_1=Completed&
status_2=Completed&
txn_type=masspay&
mc_gross_1=25.99&
mc_gross_2=9.99&
payment_fee_1=0.52&
residence_country=US&
payment_fee_2=0.20&
test_ipn=1&
mc_fee_1=0.52&
mc_fee_2=0.20
!!! :: les sauts de ligne ont été ajoutés pour améliorer la visibilité de chacun des paramètres.
Vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour obtenir la liste des variables IPN.
03 :: « Mass Payment API » pour SOAP
Vous pouvez consulter les urls https://www.paypal.com/en_US/pdf/PP_APIReference.pdf ou https://www.paypal.com/en_US/ebook/PP_APIReference/index.html pour plus d'informations sur l'utilisation de l'API « Mass Payment » via SOAP à l'aide du SDK Paypal adapté.
Les différents SDK disponibles sont listés ci après : Java, ASP.net and classic ASP, PHP.
04 :: « Mass Payment API » via NVP
Est présenté ci après un exemple d'appel à l'API « Mass Payment » avec deux destinataires précisés par leurs adresses emails.
USER=fictionaluser.unknowncompany.com&
PWD=apiPassword&
SIGNATURE=AFcFxV21C7fd0v3bYYYRCpSSRl31ACInnLACIHV5EdPnjIVOlb1a6kn9&
VERSION=2.3&
METHOD=MassPay&
RECEIVERTYPE=EmailAddress&
L_EMAIL0=fred@unknowncompany.com&
L_AMT0=25.99&
L_EMAIL1=john@fictionalcompany.com&
L_AMT1=9.99&
CURRENCYCODE=USD
!!! :: les retours chariots ont été ajoutés pour améliorer la lisibilité de l'extrait d'url NVP présenté ci avant.
Vous pouvez consulter les urls suivantes https://www.paypal.com/en_US/pdf/PP_NVPAPI_DeveloperGuide.pdf et https://www.paypal.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/index.html pour plus d'informations sur l'API « Mass Payment » utilisée via interface NVP.
Cette page présente une traduction française de la page de documentation Paypal API présentant la méthode autorisant les procédures de paiements dits de "masse" soit une procédure de paiements groupés tels qu'on peut en trouver sur AuctionAds par exemple.
La version originale de ce document est accessible en cliquant ici.
00 :: Mass Payment, paiements de masse
« Mass Payment » vous permet de transmettre automatiquement des sommes d'argent à un ou plusieurs destinataires. Avec « Mass Payment », c'est l'expéditeur qui supporte les frais de transactions, pas le destinataire.
Les frais de transactions pour les paiements « Mass Payment » est de 2% par paiement effectué avec un maximum fixé à 1$ par paiement.
Il existe deux façons d'utiliser l'outil « Mass Payment » :
-
Vous pouvez soumettre votre procédure « Mass Payment » directement depuis votre compte « Premier » ou « Business » en uploadant un fichier contenant les informations à utiliser pour effectuer les paiements.
-
Vous pouvez effectuer votre procédure « Mass Payment » de façon programmatique en utilisant la « MassPay API »
Le contenu présenté vous permet d'implémenter « Mass Payment » de façon programmatique.
01 :: Communiquer avec l'API « Mass Payment »
L'API « Mass Payment » vous permet d'envoyer des paiements à plus de 250 destinataires en une seule requête/appel. Le montant de chaque paiement peut être précisé mais tous les paiements présents au sein d'un même appel doivent être exprimés dans la même devise.
Vous pouvez choisir de préciser l'identité des destinataires à l'aide de leur adresse email ou de leur identifiant de compte Paypal.
L'API Paypal qui reçoit les requêtes de « Mass Payment » retourne une réponse indiquant le status « successfull » ou « failure » du ou des remboursements.
Dans le cas ou l'API Paypal retourne une réponse « successfull », Paypal procède au paiement précisé et, si vous avez l'option « IPN » (Instant Payment Notifications ou Notifications de paiements en temps réel) activée, Paypal envoit une confirmation de paiement à la « Notify URL » précisée dans les informations de votre profil Paypal.
Si vous n'avez l'option « IPN » activée vous pouvez constater l'effectivité des paiements à travers l'interface web de votre compte Paypal.
L'API « Mass Payment » est accessible à la fois en NVP et via SOAP.
02 :: Recevoir et traiter les Notifications de paiements de l'API « Mass Pay »
Si vous possédez l'option « IPN » activée sur votre compte Paypal, Paypal vous enverra deux « IPN » pour chaque transaction effectuée durant le traitement de la requête « Mass Payment ».
Les « IPN » seront postées à l'url « Notify URL » précisée dans votre profil Paypal.
Paypal transmet en premier le « Processed IPN ». Cet « IPN » est transmis lorsque les fonds nécessaires pour effectuer le paiement ont été « sortis » du compte du payeur.
Paypal transmet ensuite le « Completed IPN ». Si tous les destinataires de paiements sont habilités à recevoir des paiements, Paypal transmet de le « Completed IPN » quelques secondes après le « Processed IPN ». Si un ou plusieurs destinataires ne peuvent recevoir le paiement qui leur est destiné, le « Completed IPN » est transmis lorsque l'ensemble des destinataires sont habilités à recevoir le paiement.
Si après 30 jours, l'ensemble des destinataires n'est toujours pas prête à recevoir les paiements, le « Completed IPN » est tranmis avec les précisions sur les paiements qui n'ont pu être effectués et la l'argent « non réclamé par les destinataires » est replacé sur le compte Paypal du payeur.
Les frais de transactions payés à cette occasion par le payeur ne sont pas reversés par Paypal au payeur.
!!! :: un destinataire est habilité à recevoir un paiement « Mass Payment » à partir du moment ou son compte Paypal justifie d'une adresse email vérifiée.
Vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour plus de détails sur les « IPN » ou Notifications de paiements en temps réel.
Vous pouvez aussi consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn.html pour obtenir des détails sur les variables transmises via « IPN »
02.a :: « Processed IPN »
Paypal transmet les « Processed IPN » lorsque les fonds ont été débités du compte du payeur.
Pour chaque paiement effectué, Paypal génère et retourne un identifiant unique « Transaction ID » dans la variable « masspay_txn_id ».
Pour chaque paiement, Paypal retourne également la valeur « unique_id ». Ce paramètre « unique ID » dans la procédure « Mass Payment » provient de votre système d'informations/vérifications et est optionelle.
Paypal génère également un statut de transaction qui peut être « Completed », « Failed », « Reversed » ou « Unclaimed ».
Pour plus d'informations sur ces valeurs vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html .
Est présenté ci après un exemple de « Processed IPN ». Nous pouvons noter d'une manière globale que dans ce « Processed IPN », le « payment_status » est « Processed » et « status_2 » est « Unclaimed » en raison du fait que l'utilisateur visé par le paiement « 2 » n'a pas encore configuré son compte Paypal.
payer_id=HZU8ZEBYHLEZQ&
payment_date=09%3A01%3A16+Dec+21%2C+2006+PST&
payment_gross_1=25.99&
payment_gross_2=9.99&
payment_status=Processed&
receiver_email_1=fred@unknowncompany.com&
receiver_email_2=john@fictionalcompany.com&
charset=windows-1252&
mc_currency_1=USD&
masspay_txn_id_1=5W531651W5136225N&
mc_currency_2=USD&
masspay_txn_id_2=8P09425963946233T&
first_name=Robert&
unique_id_1=12345&
notify_version=2.1&
unique_id_2=45678&
payer_status=verified&
verify_sign=AB5URHwIzIbcANTQUdSveiWRw8-WACTmrKK-dops2Tb6KKAQnpUJyF.l
&payer_email=robert@hisowncompany.com&
payer_business_name=His+Own+Company&
last_name=Moore&
status_1=Completed&
status_2=Unclaimed&
txn_type=masspay&
mc_gross_1=25.99&
mc_gross_2=9.99&
payment_fee_1=0.52&
residence_country=US&
payment_fee_2=0.20&
test_ipn=1&
mc_fee_1=0.52&
mc_fee_2=0.20
!!! :: il est important de noter que les sauts de ligne (\n) ont été ajoutés afin de faciliter la lecture des paramètres et valeurs.
Vous pouvez consulter l'url suivante https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour plus de détails sur les variables IPN.
02.b :: « Completed IPN »
Paypal transmet le « Completed IPN » lorsque tous les destinataires ont pu recevoir leur paiement ou lorsque 30 jours ont passés depuis la procédure « Mass Payment ».
L'extrait de « Completed IPN » présenté ci après inclut les paramètres suivants : « txn_type » à « masspay », « payment_status » à « Completed » et « status_2 » désormais à « Completed » (ndr : voir extrait de « Processed PIN » ci avant) en raison du fait que l'utilisateur a configuré/fait vérifié son compte Paypal.
payer_id=HZU8ZEBYHLEZQ&
payment_date=09%3A01%3A23+Dec+21%2C+2006+PST&
payment_gross_1=25.99&
payment_gross_2=9.99&
payment_status=Completed&
receiver_email_1=fred@unknowncompany.com&
receiver_email_2=john@fictionalcompany.com&charset=windows-1252&
mc_currency_1=USD&
masspay_txn_id_1=5W531651W5136225N&
mc_currency_2=USD&
masspay_txn_id_2=8P09425963946233T&
first_name=Robert&
unique_id_1=12345&
notify_version=2.1&
unique_id_2=45678&
payer_status=verified&
verify_sign=AgHNi5eT0bHgt8xiwqeAG7bDTOsvAkW2ba1G3x3K7ayAOd.bmkafCd-f&
payer_email=robert@hisowncompany.com&
payer_business_name=His+Own+Company&
last_name=Moore&
status_1=Completed&
status_2=Completed&
txn_type=masspay&
mc_gross_1=25.99&
mc_gross_2=9.99&
payment_fee_1=0.52&
residence_country=US&
payment_fee_2=0.20&
test_ipn=1&
mc_fee_1=0.52&
mc_fee_2=0.20
!!! :: les sauts de ligne ont été ajoutés pour améliorer la visibilité de chacun des paramètres.
Vous pouvez consulter l'url https://www.paypal.com/IntegrationCenter/ic_ipn-pdt-variable-reference.html pour obtenir la liste des variables IPN.
03 :: « Mass Payment API » pour SOAP
Vous pouvez consulter les urls https://www.paypal.com/en_US/pdf/PP_APIReference.pdf ou https://www.paypal.com/en_US/ebook/PP_APIReference/index.html pour plus d'informations sur l'utilisation de l'API « Mass Payment » via SOAP à l'aide du SDK Paypal adapté.
Les différents SDK disponibles sont listés ci après : Java, ASP.net and classic ASP, PHP.
04 :: « Mass Payment API » via NVP
Est présenté ci après un exemple d'appel à l'API « Mass Payment » avec deux destinataires précisés par leurs adresses emails.
USER=fictionaluser.unknowncompany.com&
PWD=apiPassword&
SIGNATURE=AFcFxV21C7fd0v3bYYYRCpSSRl31ACInnLACIHV5EdPnjIVOlb1a6kn9&
VERSION=2.3&
METHOD=MassPay&
RECEIVERTYPE=EmailAddress&
L_EMAIL0=fred@unknowncompany.com&
L_AMT0=25.99&
L_EMAIL1=john@fictionalcompany.com&
L_AMT1=9.99&
CURRENCYCODE=USD
!!! :: les retours chariots ont été ajoutés pour améliorer la lisibilité de l'extrait d'url NVP présenté ci avant.
Vous pouvez consulter les urls suivantes https://www.paypal.com/en_US/pdf/PP_NVPAPI_DeveloperGuide.pdf et https://www.paypal.com/en_US/ebook/PP_NVPAPI_DeveloperGuide/index.html pour plus d'informations sur l'API « Mass Payment » utilisée via interface NVP.
: 24/01/2008 20:08:22 | 
: 
