Glossary

AWS Access Key ID

A string distributed by AWS that uniquely identifies your AWS developer account.

You include this ID in every request.

buyer

Customer making a purchase. Also called a sender.

caller

A developer who facilitates payment between a sender and a recipient.

endpoint

The URI that specifies the destination of an API request.

HMAC

The Hash Message Authentication Code used to authenticate a message.

The HMAC is calculated using a standard, hash cryptographic algorithm, such as SHA-1. This algorithm uses a key value to perform the encryption. That key is your Secret Key. For that reason, your Secret Key must remain a shared secret between you and Amazon Payments.

Instant Payment Notification

A notification that is sent whenever a payment, refund, or reserved payment completes successfully or fails. The caller must host this notification service and provide Amazon Payments with its URL.

marketplace

An environment in which the caller charges a fee for facilitating a transaction between a sender and a recipient.

recipient

A seller who receives a payment from a buyer (sender) in exchange for a service or product.

reserve

The amount that is put in reserve against a credit card but not charged.

Later, the transaction is settled (typically when the product is actually shipped).

sandbox

A part of the Amazon Payments web service where you can test the functionality of your application without incurring charges or purchasing products.

Secret Key

A string distributed by AWS that uniquely identifies your AWS developer account.

The Secret Key is a shared secret between the developer and AWS. The Secret Key is used as the key in the HMAC algorithm that encrypts the signature.

seller

Same as a recipient.

sender

The sender (also known as the buyer) pays a recipient for a product or service.

settle

To complete a transaction that has been reserved.

If you don't charge the sender immediately upon the initiation of the purchase (and instead reserve the amount against the sender's credit card), you settle the transaction later, typically after you ship the product to the sender. Settle actually makes the reserved amount move from the sender to the recipient.

signature

A URL-encoded string composed of request parameters and their values encrypted using an HMAC algorithm.

Signatures are used to authenticate and safeguard requests.