Charge Permission
What's Charge Permission?
Once series of checkout session processes are complete, Amazon creates what’s called Charge Permission object and Checkout Session is dismissed. A Charge Permission object represents buyer consent to be charged. Note that it doesn't not represent the Authorization itself. Checkout related informaiton such as shipping address, payment instrument, buyer information and amount etc is replicated to Charge Permission.
Charge Permission object has chargePermissionId as a unique key.
Amazon pay calles authorization as Charge, and it's permission to Charge as Charge Permission. See Object relationship for relationship bewteen Charge Permission and Charge.
Charge Permission holds following information
- chargePermissionId
- OneTime or Recurring type
- Amazon buyer information such as email address, phone number and billing address
- Shipping address
- Payment instrument (instrument)
- Charged amount and balance
- Status
- TimeStamps
etc
Expiration
Charge Permission expires after certain period, and it's different between OneTime checkout and Recurring checkout.
- Onetime
- Recurring
Closes after 180 days
The one-time Charge Permission will move to a Closed state after the total order amount has been captured, if it’s canceled, or it expires after 180 days.
If you want to extend Charge Permission expiration period, you can do so by setting extendExpiration=true in Amazon Pay button rendering script. With this, Charge Permission is kept alive for 13 months instead of 180days.
Why does Charge Permission expiration period matter?
Charge (Authorization) is created against Charge Permission, and Charge expires after 30 days in the Authorized state (which will be explained in Charge section). If you need to re-obtain Authorization, you need to Create Charge against Charge Permission before it expires.
Closed after 13 months
The recurring Charge Permission will move to a Closed state after if it’s canceled or after the expiration date.
However, expiration date is reset to 13 months upon every new Charge.
In addition, if merchant sets recurring frequency longer than 13 months, expiration date is set to 1 month + recurring frequency.
If you want to update recurring frequency of Charge Permission after checkout session completion, call Update Charge Permission API. Note that Charge Permission's expiration date is set to expected date only after subsequent Create Charge API call.
More detail
See Integration Guide - Charge Permission for more detail.