Skip to main content

Test your integration

Check service name is correctly shown as "Amazon Pay"​

Use Amazon Pay as A and P are capital in case you mention our service name on your website.



Check shippingAddress and paymentDescriptor are correctly shown on order review page​

This only applieds to 2 step Amazon Pay implementation

As explained in "Step4 - Operation after Amazon Pay button click", a buyer doesn't always see a page with shipping address/payment instrument selection option on Amazon hosted page when they signIn. So, you need to show shipping address and payment instrument on your order review page for a buyer.



Check if information retrieved from Amazon is appripriately processed​

This only applieds to 2 step Amazon Pay implementation

During Checkout Session, you call Get Checkout Session API （or Get Charge Permission API after checkout）to get buyer's information from Amazon.
Check if you are processing these information appropriately as some of information requires special handling. See FAQ - What kind of account information can I get from Amazon?



Check if bindChangeAction is implemented with Change button for shipping address and payment instrument​

This only applieds to 2 step Amazon Pay implementation Please ignore shipping address part if you use productType=payOnly

A buyer often goes through following steps during checkout:

1) A buyer clicks Amazon Pay button on cart page
2) A buyer signs in with Amazon and click continue on the next page (on Amazon hosted page)
3) A buyer comes back to order review page.
4) A buyer clicks "Place Order" button to complete checkout

In this flow, merchants show information such as shipping address and payment instrument at 3).
At that timing, a buyer may want to change shipping address and payment instrument to whichever they have on Amazon account. So, you implement bindChangeAction to Change buttons for shipping address and payment instrument respectively to redirect buyer to Amazon hosted page again.
See Integration Guide - Enable shipping and payment updates



Check if other payment method is NOT offered after Amazon checkout session is initiated​

This only applieds to 2 step Amazon Pay implementation

A buyer clicking on Amazon Pay button means checkout has already started with Amazon Pay. If other payment methods are still offerred to a buyer after checkout is initiated, a buyer will be confused. So, make sure you don't offer other payment methods after Amazon Pay checkout session is initiated.



Test multiple payment instruments in Sandbox test account​

Amazon Pay provides payment instruments such as Amazon Gift Card and Paidy in additon to Credit Cards. However, sandbox test buyer accounts come pre-configured with simulated payment methods, and such payment methods are limited to test credit card. Gift Card and Paidy are only available in live environment.

Test your integration with test credit cards set for your test account in principle.
Some test credit cards are designed to simulate decline or buyer cancel cases. See Integration Guide - Using simulated payment methods

Amazon Pay doesn't provide test credit cards in live environment. Use your live credit cards saved with amazon.co.jp account to test if you want to test in live environment. In such case, you need to cancel or refund on your end after the test.



API response simulation​

Pre-configured payment methods can simulate only limited scanarios, and you may want to test other scenarios.
In that case, use simulation string to simulate many kinds of API response. See Using simulation strings

Note there are some senarios can only be available in live environment.



Buyer drop during final payment process​

When a buyer is redirected to Amazon hosted page waiting for payment completion, a buyer may drop from website suddenly for some reasons.
In such case, Amazon Pay cannot redirect to URL provided in checkoutResultReturnUrl, and thus you cannot call Complete Checkout Session API.

Such transaction may be tempoprarily shown in Seller Central as status=Open somtimes. However, Amazon automatically cancels such transaction after 24 hours because Complete Checkout Session API has not been successfully done.

See FAQ - Authorization was successful (order data shown in Seller Central), but respective order is not saved at merchant



Store name or Logo on Amazon hosted page​

Amazon hosted page shows merchant store name or logo if you set them in Integration Central.
Check if store name or logo is shown on the page as expected.

See FAQ - I want to edit store name or log and store URLs shown on Amazon hosted page

caution

It takes up to 24 hours to reflect store name or logo changed from Integration Central to Amazon hosted page.



Emails from Amazon Pay to buyers​

When checkout is complete, Amazon Pay sends several kinds of emails to buyers. See;



(In case of PayAndShip) Shipping address shown on Seller Central​

When productType=PayAndShip is used, shipping address for the order should be save and shown on Seller Central. Check if shipping address is shown on Seller Central as expected.



Browser compatibility​

See Browser compatibility (for buyers)



Private Key​

Make sure to prevent unauthorized access to private key. Amazon Pay assumes no responsibility in the event of information leakage.



Seller Central

Transactions performed on Sandbox and Live are shown on Amazon Pay Seller Central > 取引管理画面 (transaction view). Seller Central also provides integration related features and report creation/download features.

Skip this page if you don't use Seller Central after launch

Seller Central Access​

See I want to know how to login with Seller Central

Seller Central transaction view​

See I want to know about Seller Central transaction view

About status on transaction view

Status is shown for each transaction on transaction view (Open/Closed/Canceled/Suspended). Note this status is based on Charge Permission. Below are example of scenario for each status.

  • Open:
    • 1) Charge is created, but uncatpured.
    • 2) Payment is almost ready but has not been completed. i.e.) a buyer is redirected to Amazon hosted page, and waits for payment to complete, but a buyer dropped from website suddenly for some reason. In this case, Amazon Pay cannot redirect buyer to checkoutResultReturnUrl and thus, merchant cannot call Complete Checkout Session API. Amazon Pay cancels such transaction after 24 hours of its creation, so the transaction is considered failed. See FAQ - Authorization was successful (order data shown in Seller Central), but respective order is not saved at merchant
  • Closed:
    • 1) Charge is captured (In case of allowOvercharge=true, upper limit charge is captured）
    • 2) Close Charge Permission API is called and Charge Permission is closed
    • 3) "終了したお支払い" operation is performed from Transaction view
    • 4) Amazon closed Charge Permission as a fraud transaction (contact Amazon Pay for details)
    • 5) Charge Permission is expired（180days or 13months after its creation）
  • Canceled:
    • 1) "お支払いキャンセル" operation is performed from Transaction view
    • 2) Chanceled without Complete Checkout Session. i.e.) a buyer is redirected to Amazon hosted page, and waits for payment to complete, but a buyer dropped from website suddenly for some reason. In this case, Amazon Pay cannot redirect buyer to checkoutResultReturnUrl and thus, merchant cannot call Complete Checkout Session API. Amazon Pay cancels such transaction after 24 hours of its creation. See FAQ - Authorization was successful (order data shown in Seller Central), but respective order is not saved at merchant
  • Suspended:

Reference ID on transaction view

Amazon Reference ID stands for;

  • chargePermissionId of OneTime checkout
  • ChargeId of Recurring checkout

Seller Central payment detail view​

See FAQ - I want to know Seller Central payment detail view

Operation on Seller Central​

Order cancel, capture and refund can be initiated on Seller Central. See FAQ - I want to know how to capture, refund and cancel the order on Seller Central

note

Note on Capture operation on Seller Central.

  • If uncaptured Charge is created by Complete Checkout Session API or by Create Charge API: respective Charge will be captured
  • If no active uncaptured Charge exists: new Charge is created and captured at the same time.

Other FAQs about Seller Central​