Amazon Simple Pay
Advanced User Guide (API Version 2010-08-28)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

Accept Marketplace Fee Button Input Reference

This button may be use to set terms for either the Marketplace button or the Marketplace-enabled donation button. The input parameters are a mix of required parameters, as listed in the following table.

Parameter

Description

Required

accessKeyYour access key from your account security credentialsYes
callerReferenceOptionally, a value to uniquely identifies this transactionNo

collectEmailAddress

Set to 1 if you want Amazon Payments to return the buyer's email address as part of the transaction information

No

maxFixedFeeIf you assess a fixed charge per transaction, set maxFixedFee to that value. You may have a value in both this parameter and maxVariableFee, and you must have a value for at least one of them.No
maxVariableFeeIf you assess a percentage charge per transaction, set maxVariableFee to that value. You may have a value in both this parameter and maxFixedFee, and you must have a value for at least one of them.No

pipelineName

The kind of token you are creating. For Amazon Simple Pay, this value is always Recipient.

Yes

recipientPaysFee

Set this value to True if the recipient agrees to pay the fees, otherwise set this value to False.

Yes

returnURL

Optionally enter the URL where buyers should be redirected after they complete the transaction

No

signatureA value calculated using the form parameters.Yes
signatureMethodThe signing algorithm, either HmacSHA1 or HmacSHA256.Yes
signatureVersionA value that specifies the signature format. Currently, the only valid value is 2.Yes

For information on using the Amazon Simple Pay to create buttons, see Understanding the Amazon Simple Pay Button Samples.

Accept Marketplace Fee Button Well-Formed HTML

Example HTML for a marketplace fee button, signed using the signature version 2 method.

<form 
  action="https://authorize.payments.amazon.com/cobranded-ui/actions/start"
  method="get">
  <input 
    type="hidden" name="signature" 
    value="8UVrm+bK/O8I92e6RKlWKg76els=" >
  <input 
    type="hidden" name="accessKey" 
    value="AKIAIOSFODNN7EXAMPLE" >
  <input 
    type="hidden" name="callerReference" 
    value="983fab72-6695-4b53-a69f-5bf5fb47c25e" >
  <input 
    type="hidden" name="collectEmailAddress" 
    value="true" >
  <input 
    type="hidden" name="maxFixedFee" 
    value="0.2" >
  <input 
    type="hidden" name="maxVariableFee" 
    value="4.00" >
  <input 
    type="hidden" name="pipelineName" 
    value="Recipient" >
  <input 
    type="hidden" name="recipientPaysFee" 
    value="true" >
  <input 
    type="hidden" name="returnURL" 
    value="http://yourwebsite.com/returnurl" >
  <input 
    type="hidden" name="signatureVersion"
    value="2" >
  <input type="hidden" name="signatureMethod"
    value="HmacSHA256" >
  <input type="image" 
    src=
 "http://g-ecx.images-amazon.com/images/G/01/asp/MarketPlaceFeeWithLogo.gif"
    border="0">
</form>