PayPal Instant Payment Notification - 2009 Guia do Utilizador

Instant Payment Notification GuideFor Professional Use OnlyCurrently only available in English.A usage Professional UniquementDisponible en Anglais un

Introducing IPNIPN Protocol and Architecture10 June, 2009 IPN Guide3. PayPal sends a single word back, which is either VERIFIED if the message origina

IPN Guide June, 2009 11Introducing IPNIPN Protocol and ArchitectureThe numbers in diagram correspond to the following steps:1. The button action initi

Introducing IPNIPN Protocol and Architecture12 June, 2009 IPN GuideThe numbers in diagram correspond to the following steps:1. The API operation initi

IPN Guide June, 2009 13Introducing IPNIPN Protocol and ArchitectureThe numbers in diagram correspond to the following steps:1. Your back-office or adm

Introducing IPNA Sample IPN Message and Response14 June, 2009 IPN GuideThe numbers in diagram correspond to the following steps, which implement the I

IPN Guide June, 2009 15Introducing IPNA Sample IPN Message and Responsemc_gross=19.95&protection_eligibility=Eligible&address_status=confirmed

Introducing IPNA Sample IPN Message and Response16 June, 2009 IPN GuideBefore you can trust the contents of the message, you must first verify that th

IPN Guide June, 2009 17Introducing IPNNon-IPN Notification MechanismsPayPal will then send one single-word message, VERIFIED, if the message is valid;

Introducing IPNNon-IPN Notification Mechanisms18 June, 2009 IPN Guide

IPN Guide June, 2009 192Implementing an IPN ListenerYou write your IPN listener in the scripting or programming language of your choice and host it on

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

Implementing an IPN Listener20 June, 2009 IPN Guide6. If the verified response passes the checks, take action based on the value of the txn_type varia

IPN Guide June, 2009 21Implementing an IPN Listener<?php error_reporting(E_ALL ^ E_NOTICE); $email = $_GET['ipn_email']; $header = "

Implementing an IPN Listener22 June, 2009 IPN Guide} mail($email, "Live-INVALID IPN", $emailtext . "\n\n" . $req); } } fclose ($fp

IPN Guide June, 2009 233Identifying Your IPN Listener to PayPalAfter you implement and test your IPN listener, you make your listener known to PayPal

Identifying Your IPN Listener to PayPalSetting Up IPN Notifications on PayPal24 June, 2009 IPN Guide4. Specify the URL for your listener in the Notifi

IPN Guide June, 2009 25Identifying Your IPN Listener to PayPalDynamically Setting the Notification URLDynamically Setting the Notification URLYou can

Identifying Your IPN Listener to PayPalDynamically Setting the Notification URL26 June, 2009 IPN Guide

IPN Guide June, 2009 274IPN TestingAfter you implement your listener and start it running on your web server, you can use the IPN simulator in the San

IPN TestingTesting Your Listener28 June, 2009 IPN Guide3. Keep or modify the values of fields that you want to include in the IPN.By default, only pop

IPN Guide June, 2009 29IPN TestingIPN Troubleshooting Tips4. Click Send IPN. The IPN message is sent to the specified URL and the results of the opera

IPN Guide June, 2009 3ContentsIntended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

IPN TestingIPN Troubleshooting Tips30 June, 2009 IPN Guidez Ensure that you are encoding your response string and are using the same character encodin

IPN Guide June, 2009 315IPN Operations on PayPalThe IPN History page on PayPal provides additional information to help you troubleshoot IPN messages.

IPN Operations on PayPalUsing the IPN History32 June, 2009 IPN Guidez Whether this IPN message was the original message or whether it was resent, whic

IPN Guide June, 2009 33IPN Operations on PayPalResending IPN MessagesIn addition to the information on the IPN History page, the details contain the f

IPN Operations on PayPalResending IPN Messages34 June, 2009 IPN GuideTo make a request that PayPal resend IPN messages, mark one or more messages for

IPN Guide June, 2009 35IPN Operations on PayPalResending IPN MessagesWhen the message has been sent, your server’s response to the HTTP POST is used t

IPN Operations on PayPalResending IPN Messages36 June, 2009 IPN Guide

IPN Guide June, 2009 376Using Fraud Management Filters With IPNFraud Management Filter actions are reported in IPN payment messages only when a filter

Using Fraud Management Filters With IPN38 June, 2009 IPN Guidetxn_type = virtual_terminal payment_date = 17:11:42 Jul 15, 2008 PDT last_name = receip

IPN Guide June, 2009 39Using Fraud Management Filters With IPNtxn_type = virtual_terminal payment_date = 17:11:42 Jul 15, 2008 PDT last_name = receip

Contents4 June, 2009 IPN GuideTransaction and Notification-Related Variables . . . . . . . . . . . . . . . . . . . . . . . 42B

Using Fraud Management Filters With IPN40 June, 2009 IPN Guidetxn_type = virtual_terminal payment_date = 17:09:40 Jul 15, 2008 PDT last_name = receip

IPN Guide June, 2009 417IPN Variable ReferencePayPal returns related variables for each kind of IPN message. Not all variables are returned for each t

IPN Variable ReferenceTransaction and Notification-Related Variables42 June, 2009 IPN GuideTransaction and Notification-Related VariablesTransaction a

IPN Guide June, 2009 43IPN Variable ReferenceBuyer Information VariablesBuyer Information VariablesBuyer information identifies the buyer or initiator

IPN Variable ReferencePayment Information Variables44 June, 2009 IPN GuidePayment Information VariablesPayment information identifies the amount and s

IPN Guide June, 2009 45IPN Variable ReferencePayment Information Variablesfraud_managment_pending_filters_xOne or more filters that identify a trigger

IPN Variable ReferencePayment Information Variables46 June, 2009 IPN Guidemc_fee Transaction fee associated with the payment. mc_gross minus mc_fee eq

IPN Guide June, 2009 47IPN Variable ReferencePayment Information Variablesoption_selection2 Option 2 choice as entered by your customer.PayPal appends

IPN Variable ReferencePayment Information Variables48 June, 2009 IPN Guidepayment_status The status of the payment:Canceled_Reversal: A reversal has b

IPN Guide June, 2009 49IPN Variable ReferencePayment Information Variablespending_reason This variable is set only if payment_status = Pending.address

IPN Guide June, 2009 5PrefaceThis document describes the Instant Payment Notification (IPN) message service.Intended AudienceThis document is intended

IPN Variable ReferenceAuction Variables50 June, 2009 IPN GuideAuction VariablesAuction information identifies the auction for which a payment is made

IPN Guide June, 2009 51IPN Variable ReferenceMass Pay VariablesMass Pay VariablesMass pay information identifies the amounts and status of transaction

IPN Variable ReferenceRecurring Payments Variables52 June, 2009 IPN GuideRecurring Payments VariablesRecurring payments information identifies the amo

IPN Guide June, 2009 53IPN Variable ReferenceRecurring Payments Variablesoutstanding_balance Outstanding balance for recurring paymentspayment_cycle P

IPN Variable ReferenceRecurring Payments Variables54 June, 2009 IPN GuideSummary of recurring payment variablesVariables Profile created message Recur

IPN Guide June, 2009 55IPN Variable ReferenceSubscription VariablesSubscription VariablesSubscription information identifies the amounts and parameter

IPN Variable ReferenceSubscription Variables56 June, 2009 IPN Guideamount2 Amount of payment for trial period 2 for USD payments; otherwise blank (opt

IPN Guide June, 2009 57IPN Variable ReferenceSubscription VariablesSummary of subscription variablesVariable Signup Cancel ModifyUSD PaymentMulti-Curr

IPN Variable ReferenceSubscription Variables58 June, 2009 IPN Guidepayment_gross XXXpayment_fee XBuyer Informationfirst_name XXXX X X Xlast_name XXXX

IPN Guide June, 2009 59IPN Variable ReferenceDispute Resolution VariablesDispute Resolution VariablesDispute resolution information identifies the cas

Revision History6 June, 2009 IPN Guide

IPN Variable ReferencePayment Review Using Notifications60 June, 2009 IPN GuidePayment Review Using NotificationsIf PayPal places a payment under revi

IPN Guide June, 2009 71Introducing IPNInstant Payment Notification (IPN) is a message service that notifies you of events related to PayPal transactio

Introducing IPNWhat is IPN?8 June, 2009 IPN Guideadministrative processes that respond the messages. PayPal provides sample code that you can modify t

IPN Guide June, 2009 9Introducing IPNIPN Protocol and ArchitectureThe IPN message is not actually part of the response sent to your website. Rather, t