Partner Promotions Construct
This OOB blueprint CX construct is an end-to-end customer experience ideal for 3P Partners providing gift/coupon URLs for Prime members to redeem exclusive online offers such as online subscriptions or online transactions, and does not require Prime members to link their Amazon and 3P accounts for offer redemption.
This experience or workflow includes Amazon-owned and 3P Partner-owned pages. Features include Prime member status verification for the 3P offer on Amazon-owned pages and does not allow for verification on 3P-owned pages.
This construct does not involve tech integration from 3P Partner but requires support for gift/coupon URLs management for tracking and reporting.
Promo Code Upload Guide
As we know Partner Promotions Construct is an API-less integration construct, where clients just need to provide promo codes (aka, claim codes) to Prime team. In this CX, Prime Customers receive a unique 3P provided promotion URL for a Prime member exclusive offer on Amazon landing page and redeem the promo code on 3P domain.
Below are the high-level instructions for uploading promo codes for your promotion (including LTO promotions).
One-Time Setup
Pre-requisite: An AWS account (Please refer to create an AWS account, if you don’t have one created)
Create an IAM Role/User in your AWS account (Please refer to create an IAM Role/User)
- (suggested name:
<YourClientName>-PromoCodesUpload-Role) and share the ARN with us.
- (suggested name:
Add the permissions we'll provide (scoped to your specific bucket and folder paths). (Please refer to add permissions to an IAM Role/User)
Environments
| Environment | Purpose |
|---|---|
| Devo (Testing) | Validate file format and pipeline |
| Prod | Live customer-facing codes |
Please complete the full flow in Devo first. Once we confirm codes are processed correctly, we'll enable Prod access.
File Format
- Format: CSV, no header row, two columns:
<promo_code>,<status> - Encoding: Plain UTF-8 (no BOM)
- File naming (date/time in UTC):
- New codes:
<ClientName>_new_codes_YYYYMMDD_HHMM.csv - Redeemed codes:
<ClientName>_redeemed_codes_YYYYMMDD_HHMM.csv
- New codes:
New Codes Upload
Upload new promo codes to make them available for customers. Status must be new for all rows.
Example (clientname_new_codes_20260515_1400.csv):
PROMO-CODE-001,new
PROMO-CODE-002,new
PROMO-CODE-003,new
Redeemed Codes Upload
Upload redeemed codes to confirm which codes were redeemed on your platform. This should contain
only the diff of codes redeemed since your last upload — not a cumulative list. Status must be redeemed for all rows.
Example (clientname_redeemed_codes_20260522_1400.csv):
PROMO-CODE-001,redeemed
PROMO-CODE-003,redeemed
Upload Structure
Your codes will be uploaded to an S3 bucket organized by client, marketplace, offer type, and promotion ID:
s3://<bucket>/new-promo-codes/clientname=<ClientName>/marketplace=<Marketplace>/offertype=<OfferType>/promotionid=<PromotionId>/
s3://<bucket>/redeemed-promo-codes/clientname=<ClientName>/marketplace=<Marketplace>/offertype=<OfferType>/promotionid=<PromotionId>/
We will provide the inputs for bucket, ClientName, Marketplace, OfferType, and PromotionId.
Troubleshooting
In case of any issues while uploading the promo codes:
- Check if you have signed in to the correct AWS account
- Check if you have signed in with the correct IAM Role/User
- Check if the IAM Role/User has the required permissions
- Reach out to your Amazon Prime POC with details of the error you are facing