Amazon Pay

Accept Amazon Pay wallet payments.

Amazon Pay provides a wallet checkout route for customers using their Amazon account. The wallet route uses automatic capture and supports refunds. It does not declare mandate reuse or webhook handling.

Status and capabilities

Integration status: beta

Category: alternative payment method

Webhook flows: None declared in code

Payment method	Type	Mandates	Refunds	Capture methods	Countries	Currencies
wallet	Amazon Pay	not supported	supported	automatic	USA	USD

Authentication

Supply Public Key and Private Key, the labels shown in the Hyperswitch control center. Hyperswitch hashes the canonical request with SHA-256, signs the algorithm line and request hash with RSA-PSS-SHA256 using the Private Key, Base64-encodes the signature, and places the Public Key with the signature in the Authorization header. See AmazonpayAuthType::try_from(), create_authorization_header(), create_signature(), and build_headers().

Before you start

1. Sign in to the Hyperswitch control center.

2. Have four values ready, all of them required by the connector form:

   Field	What it is
   Public Key	The credential Hyperswitch sends in the Authorization header
   Private Key	The RSA key Hyperswitch signs each request with
   Merchant ID	Your Amazon Pay merchant identifier
   Store ID	The Amazon Pay store the payments belong to

3. Enter all four during connector activation. Merchant ID and Store ID are wallet fields on the same form; activation without them is incomplete.

To connect Amazon Pay to your Hyperswitch account, follow Activate a connector on Hyperswitch, then return here for Amazon Pay-specific behavior.

Webhooks

Amazon Pay webhooks are not supported. Sync instead: payment sync for payment status, and refund sync for refund status, which this connector implements as a GET to /refunds/{connector_refund_id}. get_webhook_object_reference_id(), get_webhook_event_type(), and get_webhook_resource_object() each return WebhooksNotImplemented.

Source reference

Authentication and webhook behavior on this page follows Amazon Pay connector source and Amazon Pay transformers.