Integration Guide

Order Management Integration Guide March 2008 - first technical draft 31
Instant Payment Notification (IPN)
Dispute Notification and Downloadable Dispute Report
3
payment_gross =
payment_fee =
mc_gross = 100
mc_fee = 3.00
mc_currency = GBP
settle_amount = 145.5
settle_currency = USD
exchange_rate = 1.5
If the payment is accepted into a balance of the same currency:
EXAMPLE 3.6 Pending - Accept to Currency Balance
payment_status = Completed
payment_gross =
payment_fee =
mc_gross = 100
mc_fee = 3.00
mc_currency = GBP
If the payment is denied:
EXAMPLE 3.7 Pending - Denied
payment_status = Denied
payment_gross =
mc_gross = 100
mc_currency = GBP
N OTE: If a user receives a payment into a currency balance and later converts this amount into
another currency balance, the corresponding currency conversion transaction has no
IPN.
Dispute Notification and Downloadable Dispute Report
Buyers can register claims about payments; such claims are called cases. PayPal notifies
merchants about new cases with email and with IPN.
There are two kinds of cases:
z Complaint: A buyer has used the PayPal Resolution Center to register a claim about a
payment to a merchant.
N OTE: After notification about a complaint claim, merchants must log in to PayPal to use
the Resolution Center to respond to the case.
z Chargeback: A buyer has filed a complaint with a credit card company that has resulted in
a chargeback. The credit card company notifies PayPal about the reason for the
chargeback. After investigating the case, PayPal notifies the merchant of any action
required.