Integration Guide

Instant Payment Notification (IPN)
Using IPN with Multiple Currencies
36 October 2006 Order Management Integration Guide
Example 3
If the account is set to automatically convert payments, these variables will be used to show
the conversion. This example is for a user with a EUR balance who receives a payment of 100
GBP:
EXAMPLE 3.3 Mutli-currency IPN: Automatic Conversion of GBP Payment
payment_status = Completed
payment_gross =
payment_fee =
mc_gross = 100
mc_fee = 3.00
mc_currency = GBP
settle_amount = 145.5
settle_currency = EUR
exchange_rate = 1.5
Example 4
If a payment received is pending due to pending_reason = multi_currency, the first IPN
received would not have the settle_amount, settle_currency, or exchange_rate.
EXAMPLE 3.4 Mutli-currency IPN: Pending Payment
payment_status = Pending
pending_reason = multi_currency
payment_gross = mc_gross = 100
mc_currency = GBP
The second IPN contains information about settling the payment. If the payment is accepted
into the account’s primary currency, which is EUR in the following example:
EXAMPLE 3.5 Pending - Convert to Primary Currency
payment_status = Completed
payment_gross =
payment_fee =
mc_gross = 100
mc_fee = 3.00
mc_currency = GBP
settle_amount = 145.5
settle_currency = EUR
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