GetAuthorizationDetails

Returns the status of a particular authorization and the total amount captured on the authorization.

Description

To query the status of a particular authorization and to retrieve information about the total amount captured on the authorization, call the GetAuthorizationDetails operation. If you received a Pending status when you called the Authorize operation, you can call this operation to get the current status.

This operation has a maximum request quota of 20 and a restore rate of two requests every second in the production environment. It has a maximum request quota of five and a restore rate of one request every second in the sandbox environment. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Parameter name Required Type Description
AmazonAuthorizationId Yes xs:string The authorization identifier that was generated by Amazon in the earlier call to Authorize.

Response elements

Element name Description
AuthorizationDetails Encapsulates details about the Authorization object including the status, amount captured, and fee charged.

Type: AuthorizationDetails

Examples

Sample query request


POST /OffAmazonPayments/2013-01-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=AKIAFBM3LG5JEEXAMPLE
&Action=GetAuthorizationDetails
&AmazonAuthorizationId=P01-1234567-1234567-0000001
&SellerId=YOUR_SELLER_ID_HERE
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-11-05T19%3A01%3A11Z
&Version=2013-01-01
&Signature=WlQ708aqyHXMkoUBk69Hjxj8qdh3aDcqpY71hVgEXAMPLE

Sample response


<GetAuthorizationDetailsResponse xmlns="https://mws.amazonservices.com/schema/OffAmazonPayments/2013-01-01">
  <GetAuthorizationDetailsResult>
    <AuthorizationDetails>
      <AmazonAuthorizationId>
        P01-1234567-1234567-0000001
      </AmazonAuthorizationId>
      <AuthorizationReferenceId>test_authorize_1</AuthorizationReferenceId>
      <SellerAuthorizationNote>Lorem ipsum</SellerAuthorizationNote>
      <AuthorizationAmount>
        <CurrencyCode>USD</CurrencyCode>
        <Amount>94.50</Amount>
      </AuthorizationAmount>
      <AuthorizationFee>
        <CurrencyCode>USD</CurrencyCode>
        <Amount>0</Amount>
      </AuthorizationFee>
      <AuthorizationStatus>
        <State>Open</State>
        <LastUpdateTimestamp>2012-12-10T19%3A01%3A11Z</LastUpdateTimestamp>
      </AuthorizationStatus>
      <CreationTimestamp>2012-12-10T19%3A01%3A11Z</CreationTimestamp>
      <ExpirationTimestamp>2013-01-10T19:10:16Z</ExpirationTimestamp>
    </AuthorizationDetails>
  </GetAuthorizationDetailsResult>
  <ResponseMetadata>
    <RequestId>b4ab4bc3-c9ea-44f0-9a3d-67cccef565c6</RequestId>
  </ResponseMetadata>
</GetAuthorizationDetailsResponse>

See also