| Name
|
Location
|
Description
|
| x-amz-pay-idempotency-key (required) Type: string |
Header
|
Idempotency key to safely retry requests
|
| chargePermissionId (required) Type: string |
Body
|
Charge Permission identifier
|
| chargeAmount (required) Type: price |
Body
|
Transaction amount
|
| captureNow Type: boolean |
Body
|
Boolean that indicates whether or not Charge should be captured immediately after a successful authorization Default: false |
| softDescriptor Type: string |
Body
|
Description shown on the buyer payment instrument statement. You can only use this parameter if CaptureNow is set to trueDo not store sensitive data about the buyer or the transaction in this field. Sensitive data includes, but is not limited to: government-issued identification, bank account numbers, or credit card numbers The soft descriptor sent to the payment processor is: "AMZ* <soft descriptor specified here>" Default: "AMZ*<SELLER_NAME> pay.amazon.com" Max length: 16 characters |
| canHandlePendingAuthorization Type: boolean |
Body
|
Boolean that indicates whether or not merchant can handle pending response If set to false, you will receive a response within a maximum of 15 seconds in US, EU, and UK regions or 30 seconds in JP region. If set to true, Amazon Pay will process the authorization asynchronously and you will receive a response within 24 hours. See asynchronous processing for more info |
| merchantMetadata Type: merchantMetadata |
Body
|
Merchant-provided order details
|
| providerMetadata Type: providerMetadata |
Body
|
Payment service provider (PSP)-provided order details Only PSPs should use these fields |
| chargeInitiator Type: string |
Body
|
Represents who initiated the charge.
Supported values: 'CITU', 'MITU', 'CITR', 'MITR' CITU: A customer-initiated unscheduled transaction is a transaction where the customer is present and provides their payment credentials. This can be through a terminal in-store, or online through a checkout experience. The customer-initiated transaction is the proof that the customer and merchant entered into a relationship and that the payment credential presented was in fact a validly presented payment instrument. MITU: A merchant-initiated unscheduled transaction is a transaction where the customer is not present and is conducted without any additional cardholder validation. In all cases, a merchant-initiated transaction must refer to a customer’s original interaction where a customer and merchant have entered into an agreement for a recurring product or service or an automated billing or unscheduled transactions etc. There are many different kinds of merchant-initiated transactions. Examples include:
MITR: A merchant-initiated transaction for a recurring transaction. Use this for all subsequent recurring charges, regardless of how the first recurring charge was initiated. |
| channel Type: string |
Body
|
Represents the channel of the charge.
Supported values: 'Web', 'Phone', 'App', 'Alexa', 'PointOfSale', 'Firetv', 'Offline' When to use these channels:
|
| checkoutResultReturnUrl Type: string |
Body
|
Checkout result URL provided by the merchant. Amazon Pay will redirect to this URL after completing the transaction. The parameter is required in case you need to handle charge when MFA challenge is required to be completed by buyer (for EU and UK merchants only) Note: In the Live environment, URLs must use HTTPS protocol. In Sandbox environment, you don't need a SSL certificate and can use the HTTP protocol if you're testing on localhost (http://localhost) Max length: 1024 characters/bytes |