Reserve and Settle

You can use the Reserve and Settle operations for reserving funds on a sender's credit card before the service or goods are delivered and then settle the amount after the service or goods are delivered.

[Important]Important

Amazon FPS supports only credit cards for the reserve and settle functionality.

The Reserve call is similar to a Pay call and accepts a sender token, recipient token, and caller token as input parameters. You can acquire the sender token by directing the sender to the Amazon FPS Co-branded UI pipeline. Here, the sender can authorize you to use the sender's credit card for a specific one-time amount. A token that captures this payment authorization is returned when the sender is redirected to the merchant web site.

Settlement can happen for any amount equal to or less than the reserved amount specified at the time of the reserve. The Settle call takes the TransactionId that is returned as response for the Reserve operation.

Making a Reserve and Settle Operation

  1. After a sender decides buy a product from your website, you direct him to the Amazon FPS Co-branded UI pipeline.

  2. The sender signs into the sender's Amazon Payments account and sets a payment authoriztion to use the credit card for making the payment.

  3. After setting up the payment authorization, Amazon FPS returns the sender to your web site along with the sender token.

  4. Using the sender token (returned by Amazon FPS), your caller token, and the recipient token you can make Reserve operation request.

    The Reserve operation places the amount on reserve on the sender's credit card.

    [Important]Important

    At this point, the amount is not transfered to you account.

    Amazon FPS returns a transactionID corresponding to the reserve transaction.

  5. After the product is delivered to the sender, you can make the Settle operation request. If the Settle operation is successful, the amount is transfered into your account.

[Important]Important

You must settle the reserve amount within 7 days after the reserve succeeds.

The Reserve operation uses a credit card, it takes few seconds to complete. The results of a Reserve operation is returned asynchronously. You can get the results of the transaction using GetResults operation. On each of the results you can use the GetTransaction operation to view the transaction status.

See the "Handing Transaction Status" topic for more information about handling transactions with different status. [TBD]