Acquiring Recipient Tokens

In a marketplace application, you make Amazon FPS web service calls to transfer money between a sender and a recipient. In this case you must acquire a recipient token apart from the sender token.

Important

Several Amazon FPS actions now include parameters for collecting fees from sellers (recipients) using a marketplace application. When a seller registers on a marketplace web site, the seller agrees to pay a fee for each sale they derive from the marketplace web site. The Co-Branded UI pipeline displays the fee rates to the seller as a condition of participation. The fees and parameters are described in the Marketplace Fees topic in this guide.

A recipient token can have the following restrictions:

The following diagram describes the recipient token installation process using the Recipient Token Installation Pipeline. The recipient token installation process returns two tokens: a recipient token and a refund token. You must store the refund token returned in this pipeline to issue refunds to senders from their respective recipients.

Signed URL—See the Signing A URL section for more information about signing a URL.

Following are some parameters and respective values that are passed in the market place use case:

Parameter	Description	Value in this Use Case
callerKey	This is an access identifier used to identify the caller.	NA83EBSV60656N1J58G2
pipelineName	Name of the pipeline being used.	Recipient
returnURL	This parameter is used to specify the caller destination website from the Amazon FPS UI pipeline.	http://www.my2c.com/writeBlog.jsp
recipientPaysFee	Set this value to true, if the recipient agrees to pay the fees, else set this value to false.	True
callerReference	This is a unique, Caller specific reference used in the token installation to retrieve the token installed by this pipeline.	My2Cents1166203756000 Note This use case appends a time stamp to the use case title to keep the value unique.
validityStart	The validity start date should be within one year from the current date. The date cannot be beyond one year or earlier than the current date. By default this date is current date. Provides seconds using EPOCH time.	1166203756
validityExpiry	The expiry date should be within one year from the current date. The date cannot be beyond one year or earlier than the current date. Provides seconds using EPOCH time.	1197307756
paymentMethod	A comma separated string that allows you to pass payment methods supported by the recipient. You can specify only CC and ACH as payment methods. If this is not specified then all the three payment methods (CC, ACH, and ABT) are considered to be available. By default, ABT will always be given as payment method option.	ABT
maxVariableFee	The maximum variable fee that the caller charges in a marketplace transaction. The variable fee is a percentage of the transaction amount. The actual variable marketplace fee is passed as a parameter to Pay or Reserve actions.	None
maxFixedFee	The maximum fixed fee that the caller charges in a marketplace transaction. The actual fixed marketplace fee is passed as a parameter to Pay or Reserve actions.	None

	Note
	An additional parameter awsSignature is appended to the unsigned URL during the signing process. This value makes the URL tamper proof.