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...

Marketplace Payment Button Input Reference

The input parameters are a mix of required parameters, as listed in the following table.

Parameter

Description

Required

abandonUrl

Optionally enter the URL where senders should be redirected if they cancel their transaction

No

accessKey

Your AWS Access Key

Yes

amount

Enter the amount you want to collect for the item

Yes

cobrandingStyle

Optionally, set to a cobranding style. Valid values are "logo" or "banner". ("logo" is preferred)

No

collectShippingAddress

Optionally set to 1 if you want Amazon Payments to return the buyer's shipping address as part of the transaction information

No

description

Enter a description of the item

Yes

fixedMarketplaceFeeIf you assess a fixed charge per transaction, set fixedMarketplaceFee to that value. You may have a value in both this parameter and variableMarketplaceFee, and you must have a value for at least one of them.No

immediateReturn

Optionally set to 1 to skip the final status page in Amazon Payments. Default is 0.

No

ipnUrl

Optionally type the URL of your host page to which Amazon Payments should send the IPN transaction information

No

processImmediate

Optionally set to 1 to settle the transaction, otherwise set processImmediate to 0. Default value is 1

No

recipientEmailThe email address of the sellerYes

referenceId

Optionally provide a unique identifies of this transaction for your records.

No

returnUrl

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

No

secretKeyYour AWS secret keyYes
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
variableMarketplaceFeeIf you assess a percentage charge per transaction, set variableMarketplaceFee to that value. You may have a value in both this parameter and fixedMarketplaceFee, and you must have a value for at least one of them.No

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

Marketplace Payment Button Well-Formed HTML

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

<form 
     action="https://authorize.payments.amazon.com/pba/paypipeline" 
     method="POST">
     <input type="hidden" name="immediateReturn"
         value="1" >
     <input type="hidden" name="collectShippingAddress"
         value="1" >
     <input type="hidden" name="accessKey"
         value="YourAccessKeyId" >
     <input type="hidden" name="referenceId"
        value="MyTransaction-001" >
     <input type="hidden" name="recipientEmail"
         value="email domain.com" >
     <input type="hidden" name="amount"
         value="USD 10" >
     <input type="hidden" name="variableMarketplaceFee"
         value="4" >
     <input type="hidden" name="signature"
         value="dXZgCQ8fLsPjNkbHswghORXd34tTVZWEjyetpzYG1ok=" >
     <input type="hidden" name="fixedMarketplaceFee"
         value="USD 0.20" >
     <input type="hidden" name="description"
         value="Pay for Purple Vase (Walter store)" >
     <input type="hidden" name="ipnUrl"
         value="http://yourwebsite.com/instantpaymentnotification" >
     <input type="hidden" name="returnUrl"
         value="http://yourwebsite.com/success" >
     <input type="hidden" name="processImmediate"
         value="1" >
     <input type="hidden" name="cobrandingStyle"
         value="logo" >
     <input type="hidden" name="abandonUrl"
         value="http://yourwebsite.com/cancel" >
     <input type="image"
         src=
   "https://authorize.payments.amazon.com/pba/images/SMPayNowWithAmazon.png"
         border="0">
     <input type="hidden" name="signatureVersion"
         value="2" >
     <input type="hidden" name="signatureMethod"
         value="HmacSHA256" >
</form>