Amazon Pay Module

20 views Markdown

Connect Amazon Pay so clients can pay with their Amazon account and you can track payments and refunds in WISECP.

Reaching the Screen

Go to Settings → Financial → Payment Gateways → All Modules and click Amazon Pay: {admin}/modules/payment?module=AmazonPay

What Is on the Screen

The form contains account credentials, region, language and a return address. The Amazon Pay button opens Amazon's payment page. This module uses Checkout v2 for one-time payments with immediate capture.

WISECP card storage, automatic payment, subscriptions, installment selection and separate authorization/capture are unavailable. Payment methods saved at Amazon remain with Amazon.

Before You Configure It

Register an Amazon Pay merchant account for your supported business region and complete its approval. A developer account permits sandbox testing. Use HTTPS and create a sandbox buyer account through the official setup guide.

Use USD for the United States or JPY for Japan. Europe uses an EUR ledger; the United Kingdom uses GBP. Approved EUR/GBP accounts can charge AUD, GBP, DKK, EUR, HKD, JPY, NZD, NOK, ZAR, SEK, CHF or USD.

The current module sends the invoice currency without applying the shared conversion setting. Create invoices in a supported currency; TRY is unavailable. Check the currency and rounded amount, particularly whole-yen JPY payments.

Fields

Merchant IDRequired; empty initially. Your merchant identifier from Seller Central, Settings → Account Info.
Public Key IDRequired; empty initially. SANDBOX- or LIVE- selects the environment, overriding Test Mode.
Private KeyRequired; empty initially. Paste the complete PEM private key belonging to that Public Key ID, including its header and footer.
Store IDRequired; empty initially. The store's client ID from Integration Central, beginning with amzn1.application-oa2-client.
RegionRequired; defaults to United States (USD). Match the merchant account: United States, Europe, United Kingdom or Japan.
Checkout LanguageOptional; defaults to Automatic. US accepts English; Japan accepts Japanese. Europe/UK accept English, German, French, Italian and Spanish. Unsupported choices use the region default.
Test ModeOff initially. This switch selects sandbox only for older key IDs without SANDBOX-/LIVE- prefixes.
Return URLGenerated and required; cannot be edited here. Copy the complete HTTPS address to Amazon's allowed return URLs.

Status, commission, amount limits and country lists follow Payment Modules. Generated Callback URL, Success URL and Failed URL are not credential fields.

Tasks

Set Up the Account

  1. In Seller Central, open Integration Central and choose the sandbox marketplace. Select Self-developed and the one-time payment option, then click Get instructions.
  2. Under API keys, click Create keys. Choose Generate API credentials, name the key and click Create keys. Secure the downloaded PEM file.
  3. Enter the four credentials and matching region in WISECP's Amazon Pay form. Enable Status and click Save Changes.
  4. Open Payment Gateways → Initial → Enabled Module Selection, select Amazon Pay and click Save Changes. It becomes available within its limits.

Register the Website and Return

In Integration Central, add the live checkout website to JavaScript Origins and WISECP's Return URL to the allowed return addresses. Include the protocol and any custom port. Amazon may review a new origin for up to 48 hours.

This module signs the payment request and reads the returned session and charge through Amazon's API. It has no separate IPN/webhook receiver. Do not register Return URL as an Amazon SNS notification endpoint.

Test and Enable Live Payments

  1. Open an unpaid test invoice as its client, select Amazon Pay and click Pay Now. Click the Amazon Pay button and use the sandbox buyer.
  2. Test success, cancellation and interrupted return. Compare the Amazon charge ID, amount and currency with the invoice's payment record.
  3. Check pending results in Seller Central before retrying. There is no connection-test button or background IPN recovery in this module.
  4. After account approval and successful tests, enter matching LIVE credentials and click Save Changes. The LIVE prefix enables real payments even if Test Mode remains selected.

Refund a Payment

  1. Open the paid invoice at {admin}/invoices/detail?id={invoice}.
  2. Under Summary → Change Status, choose Refunded and Refund via payment gateway. Click Update Status.
  3. WISECP requests the invoice's recorded share of the Amazon charge, including payments covering several invoices. If that share cannot be found, arrange the refund in Seller Central.
  4. Confirm the final refund in Seller Central. An accepted request can still be RefundInitiated; WISECP does not later synchronize its completion.

Things to Watch

A Started Transfer Is Not Final Settlement

The module accepts Captured and CaptureInitiated as payment success. A charge lookup failure leaves payment waiting. Check Amazon's final result before fulfilling an uncertain payment or charging again.

Keep the Account Keys Available

Do not replace the account credentials while old payments still need refunds. A full invoice refund differs from a custom partial refund; handle custom amounts in Seller Central and reconcile both records.

Required Privileges

Settings require Modules → Payment Gateways (MODULES_PAYMENT_SETTINGS). Refunds require Billing → Edit (INVOICES_OPERATION) and the corresponding Seller Central access.

Was this helpful?

Thanks for your feedback!

Still Need Help?

Our support team is here around the clock for anything you can't find above.

Contact Us Open a Ticket

We use cookies to keep you signed in, remember your language and currency, and improve the site. Cookie Policy