Acquiring Multi-use Tokens

Multi-use tokens are sender tokens that can be set up using the Amazon FPS Co-branded UI pipeline. A multi-use token is the most flexible token that your senders can set up for your application. As the name suggests, a multi-use token can be used multiple times based on the restrictions specified by the sender while setting up the token. A multi-use token can have two types of restrictions—Amount limit and Usage limit. You, as a caller, can use this token to charge the sender multiple times to pay a single or multiple recipients. A multi-use token, however, cannot be used to charge the sender for unlimited amount or for unlimited amount of time.

	Important
	If you charge your customers at a regular interval for a fixed amount, then you should use the recurring token .

Usage Restrictions

A multi-use token provides the flexibility of usage based on restrictions or limitations. You can specify two two types of restrictions for a multi-use token—amount limit and usage limit.

Multiuse Token Restrictions

Amount Limit—Limiting the maximum amount
Amount limit specifies the maximum amount that can be charged using the token within a specified period or for the lifetime of the token. For example, the token can be used for a maximum amount of $30 in a month starting from August 10, 2007 or for a maximum amount of $30.
Usage Limit—Limiting the number of uses
Usage Limits specifies maximum number of times you can charge the token within a specified period or for the lifetime of the token. For example, the token can be used a maximum of 10 times or for 10 times in a day starting from August 10, 2007.

A maximum of 3 usage restrictions can be specified for a multi-use token. For example, a combination of usage restrictions mentioned above will restrict a token to be used 10 times a day for a maximum of $30 in a month.

	Important
	Amazon FPS requires you to always to set the maximum amount limit.

In addition to the usage restrictions, you can also set one of the following restrictions on the transaction amount. These apply individually to each transaction and not across multiple transactions.

Maximum transaction amount for each transaction
Minimum transaction amount for each transaction
Exact transaction amount for each transaction

Calling Application Restriction

A multi-use token can be used to pay multiple recipients in a marketplace application. To enable this, the calling application should specify the list of recipients that will receive payments. Once the list of recipients are specified in the token, it cannot be modified.

Setting Up Multi Use Token

The multi-use token installation process is similar to the single-use token installation process, however, the token accepts different set of parameters. You can use the Multi-use Token Installation Pipeline to install a multi-use token on your customers account.

As a caller, however, you can use the InstallPaymentInstruction operation to install the multi-use token on your own account.

Example - Using Multi-Use Tokens

The Multiple Payments Use Case is a complete example on using a multi-use token.