Developer's Guide

Adaptive Payments Developer Guide August 7, 2012 71
Getting Started
Making a Chained Payment (XML)
Making a Chained Payment (XML)
A chained payment is when a sender sends a payment to a PayPal-registered receiver who is
the primary receiver.
 You send a PayRequest, enabling the primary receiver.
 You receive a response with a pay key.
 You must redirect the sender’s browser to PayPal to approve the payment.
With chained payments, the sender only sees the transaction to the primary API caller. The
receiver only sees the transaction from the primary API caller. The transactions from and to
the receivers are hidden from the sender and receivers.
In the example below, Tim makes a single payment of $100 to Frank, who is the primary
receiver. Of this amount, Frank keeps $25 and pays Yvonne $75. The following event
sequence takes place:
Pay Request for Chained Payment
<PayRequest>
<requestEnvelope>
<errorLanguage>en_US</errorLanguage> </requestEnvelope>
<cancelUrl xmlns="">http://exammple.com/cancelURL.htm</cancelUrl>
<actionType>PAY</actionType>
<currencyCode xmlns="">USD</currencyCode>
<receiverList xmlns="">
<receiver>
<amount>100</amount>
<email>[e-mail]</email>
<primary>true</primary>
</receiver>
<receiver>
<amount>75</amount>
<email>[e-mail]</email>
<primary>false</primary>
</receiver>
</receiverList>
<returnUrl xmlns="">http://example.com/returnURL.htm</returnUrl>
</PayRequest>