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


Copyright © 2009-2018 Amazon.com, Inc. or its affiliates. Amazon and Amazon.com are registered trademarks of Amazon.com, Inc. or its affiliates. All other trademarks are the property of their respective owners.