Skip to content

Postman Collection (APL)

← Back to Postman Collections

Use this Postman collection to quickly integrate and test Amazon Pay Later APIs — including authentication, payment instruments, charges, refunds, and status checks — with pre-built requests and automated request signing.

Get the Collection

▶ Fork Collection

Get a copy of all pre-built requests, environment variables, and auto-signing scripts in your own workspace. Best for developers ready to integrate.

  1. Click "Fork Collection" below
  2. Sign in to your Postman account
  3. Choose a workspace to fork into
  4. Configure environment variables
  5. Start making API calls
Fork Collection

🤖 Try with AI Agent

Explore the APIs interactively using Postman's AI assistant. Ask natural language questions and get guided through the integration. Best for developers exploring or learning the APIs.

  1. Fork the collection to your workspace first
  2. Open the forked collection in Postman
  3. Click the AI Agent icon in the bottom-right panel
  4. Ask questions like "How do I create a charge?"
  5. Follow the guided steps to test APIs
View Collection & Fork

📥 Download Collection

Download the collection JSON file and import it directly into Postman. Best for offline use or restricted network environments.

  1. Click "Download JSON" below
  2. Open Postman
  3. Click Import → Upload Files
  4. Select the downloaded JSON file
  5. Configure environment variables and start testing
Download JSON

Configure Environment Variables

After forking or importing the collection, create a new environment in Postman and add the following variables:

Variable Description
mid Your Merchant ID
secret_key Your Secret Key for signing
access_key Your Access Key for authorization
client_id Your OAuth Client ID
Android: AmazonPay.startAuthorize() returns clientID
iOS: PayAuthorizeCallbackHandler() returns clientID
Web: Developer Account → Web Settings → click Show
client_secret Your OAuth Client Secret (Web Settings → click Show)
redirect_uri Your Redirect URI
Android: AmazonPay.startAuthorize() returns redirectUri
iOS: PayAuthorizeCallbackHandler() returns redirectUri
Web: The URL added under Developer Account → Web Settings → "Allowed Return URLs"
code_verifier PKCE code verifier from client-side SDK (Mobile App flow only)
auth_code Authorization code from OAuth flow
Android: AmazonPay.startAuthorize() returns authCode
iOS: PayAuthorizeCallbackHandler() returns authCode
Web: LoginWithAmazon returns authCode
callback_url Callback URL where the user is redirected after payment via Charge API
hostname Production: amazonpay.amazon.in
Sandbox: amazonpay-sandbox.amazon.in
paymentMetaData (Optional) Required only for Android app transactions
sellerStoreName (Optional) Merchant's store name displayed to the customer on the Amazon Pay payment page

Available APIs in the Collection

API Description
Get Access Token (Website) Exchange authorization code for access token using client_id + client_secret
Get Access Token (Mobile App) Exchange authorization code for access token using PKCE flow
Refresh Access Token Refresh an expired access token
Get Payment Instruments Retrieve Amazon Pay Later instrument for a customer
Create Charge Initiate a charge/payment transaction
Get Charge Status Check the status of a charge transaction
Create Refund Initiate a refund for a previously charged transaction
Get Refund Status Check the status of a refund transaction

Usage

  1. Run Get Access Token first — this saves access_token and refresh_token automatically.

  2. All other APIs will auto-sign requests using your credentials.

  3. charge_id and refund_id are auto-generated when you run Create Charge / Create Refund.

  4. Status check APIs automatically use the last generated charge/refund ID.

Notes

  • Set hostname to amazonpay-sandbox.amazon.in for sandbox testing.

  • For Website flow: use Get Access Token (Website) with client_id + client_secret.

  • For Mobile App flow: use Get Access Token (Mobile App) with client_id + code_verifier.