Buy with Prime
Buy with Prime lets shoppers pay with their Amazon Prime account on your storefront. The screen’s own description: “Amazon takes the payment and ships from its own warehouses; every Prime order lands in this store’s order list.”
The screen is at /settings/integrations/buy-with-prime. It needs the settings.manage
permission and a CIQRA Commerce plan. A link at the top, Buy with Prime merchant console, opens
Amazon’s console in a new tab.
Before you start: two things only you can arrange
Section titled “Before you start: two things only you can arrange”- Amazon’s approval. “Amazon approves your store for Buy with Prime and for API access in the merchant console.” That happens in Amazon’s console, not in the admin, and the steps below depend on it.
- A web address of your own. Connecting registers your store’s address with Amazon so events can reach it. A store with no domain Amazon can post to is refused at the Connect step — see below.
The four steps, as the screen lays them out
Section titled “The four steps, as the screen lays them out”The screen shows a Getting set up panel that marks each step done as it happens:
- Get approved by Amazon — in the merchant console (Open the merchant console).
- Paste the API credentials — “Download the credentials file from the console and paste its values into the form on this page.”
- Connect — “This store registers its own address with Amazon, so orders, deliveries and refunds reach it.”
- Receive the first Prime order — “It appears in your order list already paid, and Amazon ships it.”
Pasting the credentials
Section titled “Pasting the credentials”The API credentials form asks for the values from Amazon’s credentials file:
- Client ID
- Target ID
- Client secret — “Stored encrypted and never shown again — not even to you.”
- API version — “Leave as it is unless Amazon asks you to use another date.”
Each value is pasted exactly as it appears in the file, on one line, up to 256 characters. Select Save credentials. Saving does not connect anything: “After saving, connect to start receiving orders.”
Connecting
Section titled “Connecting”The status card then offers Connect. “Connecting registers this store’s address with Amazon and subscribes it to order, delivery and refund events.”
If Connect is refused, the card says why, sorted by who can fix it:
| What the screen says | Who fixes it |
|---|---|
| “This store has no web address Amazon can send events to yet. Connect a domain first, then connect again.” with Open Domains | You — connect a domain under Settings → Domains, then connect again. |
| “Amazon refused the connection. Check the permissions granted to these credentials in your Buy with Prime merchant console. Amazon said: …” | You, in Amazon’s console. Amazon’s own words are kept — they are what Amazon’s support will ask for. |
Once connected
Section titled “Once connected”The status card reads Connected to Buy with Prime and shows the last event from Amazon, when it was connected, the Target ID and API version, the address Amazon sends events to (with Copy), and the events this store receives: Order confirmed, Package in transit, Package delivered, Delivery canceled and Refund completed.
Prime orders carry the tag buy-with-prime in your order list. Recent Prime orders on the same screen lists the latest ones; View orders opens the order list.
Replacing the credentials
Section titled “Replacing the credentials”When Amazon issues new credentials, use Replace credentials. 🔴 The form warns first, and it means it: “Saving new credentials disconnects Buy with Prime. No Prime orders arrive until you connect again.” Save, then select Connect again straight away.
What this page does not say
Section titled “What this page does not say”- It does not cover Amazon’s fees, eligibility or which products qualify for Prime. Those are set in Amazon’s merchant console.
- It does not describe shipping Prime orders yourself. On this screen’s terms, Amazon ships them from its own warehouses.