| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
Handling Return Content
Topics
Amazon Simple Pay sends transaction information to your Return URL, your IPN URL, and Amazon Flexible Payments Service API calls. If you application demands it, you can capture the transaction data in the pages you specify when you create the button form.
Handling Button Response Data
Amazon Payments sends transaction data to the URL you specify as your Return URL as HTTP GET data. You simply capture the response elements as you would with any other form post.
All the common response parameters are listed in API Return Values.
Important
You should validate Amazon's signature in the button response. For more information, see Verifying the ReturnURL and IPN Notifications.
Handling Instant Payment Notification Responses
Amazon Payments sends transaction data to the URL you specify as your IPN URL as HTTP POST data. You simply capture the response elements as you would with any other form post.
All the IPN response parameters are listed in Appendix: IPN Response Elements for Transactions.
Important
You should validate Amazon's signature of each IPN post. For more information, see Verifying the ReturnURL and IPN Notifications.
Handling Flexible Payments Service Responses
In response to an FPS action request the Amazon FPS returns an XML document fragment that contains the results of the request in an XML data structure. Use your preferred method for parsing an XML document fragment to manipulate the FPS transaction data elements.
As an example, the following XML fragment shows a simplified response to a REST request for a Settle action.
<SettleResponse xmlns="http://fps.amazonaws.com/doc/2008-09-17/">
<SettleResult>
<TransactionId>14GKD9GE66FAA63E6O6B2JDPZKN53LZ7F22</TransactionId>
<TransactionStatus>Pending</TransactionStatus>
</SettleResult>
<ResponseMetadata>
<RequestId>9ed2008b-b230-4ed0-9210-095f77fc2359:0</RequestId>
</ResponseMetadata>
</SettleResponse>The response contains all the data you need to validate and process the transaction.
For a complete listing of the values returned for all FPS actions, see Simple Pay FPS Actions API Reference.
