PayPal Instant Payment Notification - 2012 Guia do Utilizador

Instant Payment Notification GuideLast updated: July 10, 2012

Introducing IPNIPN Protocol and Architecture10 July 10, 2012 IPN Guide2. Your listener sends the complete unaltered message back to PayPal; the messag

IPN Guide July 10, 2012 11Introducing IPNIPN Protocol and ArchitectureIPN Messages Generated by PayPal Payments StandardPayPal generates an IPN messag

Introducing IPNIPN Protocol and Architecture12 July 10, 2012 IPN GuideIPN Messages Generated by APIsPayPal generates an IPN message when you invoke an

IPN Guide July 10, 2012 13Introducing IPNIPN Protocol and ArchitectureIPN Messages Generated by a Back-Office ProcedurePayPal generates an IPN message

Introducing IPNA Sample IPN Message and Response14 July 10, 2012 IPN GuidePayPal-Initiated IPN MessagesSome IPN messages generated by PayPal are not d

IPN Guide July 10, 2012 15Introducing IPNA Sample IPN Message and Responsemc_gross=19.95&protection_eligibility=Eligible&address_status=confir

Introducing IPNA Sample IPN Message and Response16 July 10, 2012 IPN GuideBefore you can trust the contents of the message, you must first verify that

IPN Guide July 10, 2012 17Introducing IPNNon-IPN Notification MechanismsPayPal will then send one single-word message, VERIFIED, if the message is val

Introducing IPNNon-IPN Notification Mechanisms18 July 10, 2012 IPN Guide

IPN Guide July 10, 2012 192Implementing an IPN ListenerYou write your IPN listener in the scripting or programming language of your choice and host it

IPN GuideDocument Number: 10087.en_US-20120710© 2012 PayPal, Inc. All rights reserved. PayPal is a registered trademark of PayPal, Inc. The PayPal log

Implementing an IPN Listener20 July 10, 2012 IPN Guide

IPN Guide July 10, 2012 213Identifying Your IPN Listener to PayPalAfter you implement and test your IPN listener, you make your listener known to PayP

Identifying Your IPN Listener to PayPalSetting Up IPN Notifications on PayPal22 July 10, 2012 IPN Guide4. Specify the URL for your listener in the Not

IPN Guide July 10, 2012 23Identifying Your IPN Listener to PayPalDynamically Setting the Notification URLDynamically Setting the Notification URLYou c

Identifying Your IPN Listener to PayPalDynamically Setting the Notification URL24 July 10, 2012 IPN Guide

IPN Guide July 10, 2012 254IPN TestingAfter you implement your listener and start it running on your web server, you can use the IPN simulator in the

IPN TestingTesting Your Listener26 July 10, 2012 IPN Guide3. Keep or modify the values of fields that you want to include in the IPN.By default, only

IPN Guide July 10, 2012 27IPN TestingIPN Troubleshooting Tips4. Click Send IPN. The IPN message is sent to the specified URL and the results of the op

IPN TestingIPN Troubleshooting Tips28 July 10, 2012 IPN Guide Ensure that you are encoding your response string and are using the same character enco

IPN Guide July 10, 2012 295IPN Operations on PayPalThe IPN History page on PayPal provides additional information to help you troubleshoot IPN message

July 10, 2012 3ContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Documentation

IPN Operations on PayPalUsing the IPN History30 July 10, 2012 IPN GuideThe search results contain the following information: The date and time that P

IPN Guide July 10, 2012 31IPN Operations on PayPalUsing the IPN History– Queued indicates that PayPal is ready to send the message – Retrying indicate

IPN Operations on PayPalUsing the IPN History32 July 10, 2012 IPN GuideIn addition to the information on the IPN History page, the details contain the

IPN Guide July 10, 2012 33IPN Operations on PayPalResending IPN MessagesResending IPN MessagesYou can use the IPN History page to request that PayPal

IPN Operations on PayPalResending IPN Messages34 July 10, 2012 IPN Guidenot check this option, PayPal sends the message to the same URL to which the o

IPN Guide July 10, 2012 35IPN Operations on PayPalResending IPN MessagesWhen the message has been sent, your server’s response to the HTTP POST is use

IPN Operations on PayPalResending IPN Messages36 July 10, 2012 IPN Guide

IPN Guide July 10, 2012 376Using Fraud Management Filters With IPNFraud Management Filter actions are reported in IPN payment messages only when a fil

Using Fraud Management Filters With IPN38 July 10, 2012 IPN Guidetxn_type = virtual_terminal payment_date = 17:11:42 Jul 15, 2008 PDT last_name = rec

IPN Guide July 10, 2012 39Using Fraud Management Filters With IPNtxn_type = virtual_terminal payment_date = 17:11:42 Jul 15, 2008 PDT last_name = rec

Contents4 July 10, 2012Chapter 6 Using Fraud Management Filters With IPN . . . . . . . . .37Chapter 7 IPN Variable Reference . . . . .

Using Fraud Management Filters With IPN40 July 10, 2012 IPN Guidetxn_type = virtual_terminal payment_date = 17:09:40 Jul 15, 2008 PDT last_name = rec

IPN Guide July 10, 2012 417IPN Variable ReferencePayPal returns related variables for each kind of IPN message. Not all variables are returned for eac

IPN Variable ReferenceTransaction and Notification-Related Variables42 July 10, 2012 IPN GuideTransaction and Notification-Related VariablesTransactio

IPN Guide July 10, 2012 43IPN Variable ReferenceBuyer Information VariablesBuyer Information VariablesBuyer information identifies the buyer or initia

IPN Variable ReferencePayment Information Variables44 July 10, 2012 IPN GuidePayment Information VariablesPayment information identifies the amount an

IPN Guide July 10, 2012 45IPN Variable ReferencePayment Information Variablesauth_exp Authorization expiration date and time, in the following format:

IPN Variable ReferencePayment Information Variables46 July 10, 2012 IPN Guidemc_gross Full amount of the customer's payment, before transaction f

IPN Guide July 10, 2012 47IPN Variable ReferencePayment Information Variablespayment_date Time/Date stamp generated by PayPal, in the following format

IPN Variable ReferencePayment Information Variables48 July 10, 2012 IPN Guidepayment_status The status of the payment:Canceled_Reversal: A reversal ha

IPN Guide July 10, 2012 49IPN Variable ReferencePayment Information Variablespending_reason This variable is set only if payment_status = Pending.addr

IPN Guide July 10, 2012 5 Preface This document describes the Instant Payment Notification (IPN) message service.Documentation FeedbackHelp us improve

IPN Variable ReferenceAuction Variables50 July 10, 2012 IPN GuideAuction VariablesAuction information identifies the auction for which a payment is ma

IPN Guide July 10, 2012 51IPN Variable ReferenceMass Pay VariablesMass Pay VariablesMass pay information identifies the amounts and status of transact

IPN Variable ReferenceRecurring Payments Variables52 July 10, 2012 IPN GuideRecurring Payments VariablesRecurring payments information identifies the

IPN Guide July 10, 2012 53IPN Variable ReferenceRecurring Payments Variablesoutstanding_balance Outstanding balance for recurring paymentspayment_cycl

IPN Variable ReferenceRecurring Payments Variables54 July 10, 2012 IPN GuideSummary of recurring payment variablesVariables Profile created message Re

IPN Guide July 10, 2012 55IPN Variable ReferenceSubscription VariablesSubscription VariablesSubscription information identifies the amounts and parame

IPN Variable ReferenceSubscription Variables56 July 10, 2012 IPN Guideamount2 Amount of payment for trial period 2 for USD payments; otherwise blank (

IPN Guide July 10, 2012 57IPN Variable ReferenceSubscription VariablesSummary of subscription variablesVariable Signup Cancel ModifyUSD PaymentMulti-C

IPN Variable ReferenceSubscription Variables58 July 10, 2012 IPN Guidepayment_gross XXXpayment_fee XBuyer Informationfirst_name XXXX X XXlast_name XXX

IPN Guide July 10, 2012 59IPN Variable ReferenceDispute Resolution VariablesDispute Resolution VariablesDispute resolution information identifies the

Documentation Feedback6 July 10, 2012 IPN Guide

IPN Variable ReferencePay Message Variables60 July 10, 2012 IPN GuidePay Message VariablesPayPal generates an IPN message that contains information ab

IPN Guide July 10, 2012 61IPN Variable ReferencePay Message Variablesstatus The status of the payment. Possible values are: CREATED – The payment req

IPN Variable ReferencePay Message Variables62 July 10, 2012 IPN Guidetransaction[n].status_for _sender_txnThe transaction status, where [n] is a numbe

IPN Guide July 10, 2012 63IPN Variable ReferencePreapproval Message VariablesPreapproval Message VariablesPayPal generates an IPN message that contain

IPN Variable ReferencePreapproval Message Variables64 July 10, 2012 IPN Guidecurrent_total_amount_of_all_paymentsThe current total of payments made fo

IPN Guide July 10, 2012 65IPN Variable ReferencePreapproval Message VariablescurrencyCode The currency code. Possible values are: Australian Dollar –

IPN Variable ReferenceAdaptive Accounts IPN Messages66 July 10, 2012 IPN GuideAdaptive Accounts IPN MessagesPayPal sends an IPN message whenever a Pay

IPN Guide July 10, 2012 67IPN Variable ReferenceAdaptive Accounts IPN MessagesExample IPN message in response to CreateAccount requestnotify_version=U

IPN Variable ReferencePayment Review Using Notifications68 July 10, 2012 IPN GuidePayment Review Using NotificationsIf PayPal places a payment under r

IPN Guide July 10, 2012 69 Revision HistoryRevision history for PayPal Instant Payment Notification Guide. Date Published Description 07/10/12 Mainte

IPN Guide July 10, 2012 71Introducing IPNInstant Payment Notification (IPN) is a message service that notifies you of events related to PayPal transac

70 July 10, 2012 IPN Guide

Introducing IPNIPN Overview8 July 10, 2012 IPN Guide Trigger order fulfillment or enable media downloads when a check clears or a payment is made Up

IPN Guide July 10, 2012 9Introducing IPNIPN Protocol and ArchitectureThe diagram shows requests and responses, which are the result of processing butt