Developer's Guide

Pay API Operation
Pay Summary
74 August 7, 2012 Adaptive Payments Developer Guide
Parallel Payments
For a simple payment, you must specify values for the fields above. For a parallel payment,
you must specify both the above values and the following fields:
Chained Payments
For a chained payment, you must specify all required fields for a parallel payment and you
must also specify enable the primary receiver:
By default, a payment requires explicit approval in which the sender must log in to PayPal. In
that case, you are not required to specify the sender’s email address. To initiate the approval
process, you must redirect the sender to PayPal as follows:
https://www.paypal.com/webscr?cmd=_ap-payment&paykey=value
NOTE: The command is _ap-payment. You obtain the value of the paykey parameter from
the payKey field in the Pay API operation’s response message.
returnUrl URL to redirect the sender’s browser to after the sender has
logged into PayPal and approved a payment; it is always
required but only used if a payment requires explicit
approval
requestEnvelope.errorLanguage The code for the language in which errors are returned,
which must be en_US.
Field Description
receiverList.receiver(
n).email The receiver’s email address for each receiver, where n is
between 0 and 5 for a maximum of 6 receivers
receiverList.receiver(
n).amount Amount to send to each corresponding receiver
Field Description
receiverList.receiver(
n).email The receivers’ email addresses, where n is between 0 and 5
for a total of one primary receiver and between one and 5
secondary receivers
receiverList.receiver(
n).amount Amount to send to each corresponding receiver
receiverList.receiver(
n).primary Set to true to indicate a chained payment; only one receiver
can be a primary receiver. Omit this field, or set it to false
for simple and parallel payments.
Field Description