Skip to main content

Account Linking Offer Code Construct

This OOB blueprint CX for Prime Offer Code is for Prime member exclusive offers that are for subscription or loyalty program in nature which can be unlocked with a discount or promotional code, QR code or barcode. This construct requires deeper integration where customer consent is explicitly required for sharing their Prime benefit status and other customer information with our 3P Partners. In this Account Linking construct, customer generated Prime Offer Code can be used both in physical store (scan at POS or Point of Sale system) or in the online checkout as a promotional code to unlock the 3P offer. Additionally, customer also explicitly consents to sharing their Prime benefit status and other information with 3P. For return or subsequent visits, customer does not need to generate a new code as consent is in place. Customer can choose to simply use the 3P’s app as 3P can query Prime membership status any time without additional customer action. This deeper integration requires onboarding to Login with Amazon (‘LWA’) and Prime APIs to provide benefit to the customer. This document provides an overview of the overall flow, 3P technical requirements, and high-level API details.

Flow​

  1. Customer clicks on online advertisement or scans the QR code in physical store
  2. Customer lands on the Prime hosted co-branded offer landing page that details the Prime x 3P offer including terms & conditions.
  3. Customer is recognized as Prime or Non Prime or will be asked to log in if Amazon account cookies are not stored. Non Prime members will have the option to sign up for Prime.
  4. On first visit, customer will see ‘Login with Amazon’ consent screen and asked to provide consent to share their Prime benefit status.
  5. On clicking ‘Allow’, Prime members will be redirected to Prime hosted co-branded offer landing page and see the Prime Offer Code in the form of a numerical code or bar code.
  6. Physical Store Associate will scan this Prime Offer barcode or enter the numeric code manually as the promotional code. For online offer, Prime member will copy to clipboard and paste Prime Offer Code into the promo code field.
  7. 3P makes the Prime get auth code API call to retrieve the LWA auth code.
  8. 3P calls LWA API to retrieve the access token and refresh token.
  9. 3P calls Prime API (Benefits Discovery API) to verify Prime benefit status
  10. Once verified, 3P provides the benefit to the customer.
  11. 3P then calls Prime API (LinkCustomer API) to confirm accounts are linked.

Prerequisite Tech Requirements​

The following section details certain prerequisites that clients must follow or prepare beforehand in order to integrate with this construct. We are listing down all the technical requirements below required to complete this integration pattern:

  1. The POS systems should be connected to a centric 3P server from where the integration with Amazon (Prime and LWA) will be done.
  2. Clients must have the tech capability to call LWA and Prime APIs.
  3. Clients must own a data store to maintain or associate the LWA-generated token-pair to a customer in a database on their end. (Without this, the overall flow will have to be repeated for every customer interaction at the store).
  4. Clients may represent this association of customer’s token-pair via the customerId or with some unique identifier generated at their end.

Onboarding Steps​

Clients can onboard to Account Linking Offer Code Construct in four easy steps:

  1. Create Authorization Header to sign the API calls request
  2. Call Get Auth Code API
  3. LWA Onboarding & APIs Integration
  4. Call Benefit Discovery and Account Linking APIs
  5. Onboard to Prime Notification System

1. Create Authorization Header to sign the API calls request​

  • Authorization Header creation is covered in detail here.

2. Call Get Auth Code From Offer Code API to retrieve the auth Code​

  • Get Auth Code From Offer Code API integration is covered here.

3. LWA Onboarding & APIs Integration​

  • LWA Onboarding & Integration specifically for Account Linking Offer Code are covered in detail here.

4. Call Benefit Discovery and Account Linking APIs​

  • Benefit Discovery API integration is covered here.
  • Account Linking API integration is covered here.

5. Onboard to Prime Notification System​

  • Notification System Onboarding is covered in detail here.