Order reference states and reason codes
The following diagram depicts the state transition of an Order Reference object:
The following table describes each state that an order reference can be in, the allowed operations on a state, and the reasons why an Order Reference object can end up in a state:
|State||Description||Allowed operations||Reason codes|
|Draft||An Order Reference object is in the Draft state before being confirmed by calling the ConfirmOrderReference operation.||--|
|Open||An Order Reference object moves to the Open state after it is confirmed by calling the ConfirmOrderReference operation. Authorisations can only be requested on an order reference that is in the Open state.||--|
An Order Reference object moves to the Suspended state when problems with the payment method are preventing Amazon from processing the authorisations. You cannot request new authorisations when the order reference is in the Suspended state. But you still can capture existing authorisations and apply refunds to captures.
You should request another form of payment from the buyer if the Order Reference object moves to the Suspended state.
|InvalidPaymentMethod-There were problems with the payment method.|
The Order Reference object can be cancelled by calling the CancelOrderReference operation or it can be cancelled by Amazon. You can cancel an order only if no money has been captured or charged on the order reference.
Any pending authorisations are cancelled, and no new payment operations are allowed in the future.
SellerCanceled-You have explicitly cancelled the order reference by calling the CancelOrderReference operation. You can specify the reason for the cancellation in the CancelationReason request parameter.
Stale-You did not confirm the order reference by calling the ConfirmOrderReference operation within the allowed period of 3 hours.
AmazonCanceled-Amazon has cancelled the order reference.
The Order Reference object can be closed by calling the CloseOrderReference operation, or it can be closed by Amazon.
You cannot request new authorisations when the order reference is in the Closed state. Captures on existing authorisations are still allowed. Refunds on captures are also still allowed.
Expired-You can only authorise funds on the buyer's payment instrument up to 180 days after the order reference is created. After this, Amazon marks the order reference as closed, and new authorisations aren't allowed.
MaxAmountCharged-You are allowed to capture the following amounts before the order reference is closed by Amazon:
MaxAuthorizationsCaptured-You have fully or partially captured 25 authorisations. After this, the order reference is closed by Amazon.
AmazonClosed-Amazon has closed the order reference because of a failed internal validation or because of an A-to-z claim being decided against you.
SellerClosed-You have explicitly closed the order reference by calling the CloseOrderReference operation. You can specify the reason for closure in the ClosureReason request parameter of the CloseOrderReference operation.