Get Merchant Notification Configuration

Gets the notification configuration settings for a merchant, which consist of IPN endpoint URLs and event types.

Description

Call the GetMerchantNotificationConfiguration operation to query the IPN endpoint URLs and event types configured for a merchants account.

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
SellerId Yes String SellerId of the merchant whose notification configuration settings will be retrieved.

Response Elements

Element Name Type Description
NotificationConfigurationList List List of NotificationConfiguration

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=0GS7553JW74RRM612K02EXAMPLE
&Action=GetMerchantNotificationConfiguration
&SellerId=YOUR_SELLER_ID_HERE
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2018-03-16T07%3A04%3A47Z
&Version=2013-01-01
&Signature=2RPzkOgQmDybUjk0dA54maCEXAMPLE

Sample response

<GetMerchantNotificationConfigurationResponse xmlns="http://mws.amazonservices.com/schema/OffAmazonPayments/2013-01-01">
    <GetMerchantNotificationConfigurationResult>
        <NotificationConfigurationList>
            <member>
                <NotificationUrl>
                  URL 
                </NotificationUrl>
                <EventTypes>
                    <member>EVENT_TYPE</member>
                </EventTypes>
            </member>
        </NotificationConfigurationList>
    </GetMerchantNotificationConfigurationResult>
    <ResponseMetadata>
        <RequestId>a249808b-f961-454a-8664-5b494462d1f2</RequestId>
    </ResponseMetadata>
</GetMerchantNotificationConfigurationResponse>

Sample response with the default event type: This shows a configuration where notifications for all event types will be sent to the same IPN endpoint URL.

<GetMerchantNotificationConfigurationResponse xmlns="http://mws.amazonservices.com/schema/OffAmazonPayments/2013-01-01">
    <GetMerchantNotificationConfigurationResult>
        <NotificationConfigurationList>
            <member>
                <NotificationUrl>
                 URL
                </NotificationUrl>
                <EventTypes>
                    <member>ALL</member>
                </EventTypes>
            </member>
        </NotificationConfigurationList>
    </GetMerchantNotificationConfigurationResult>
    <ResponseMetadata>
        <RequestId>a249808b-f961-454a-8664-5b494462d1f2</RequestId>
    </ResponseMetadata>
</GetMerchantNotificationConfigurationResponse>

Example response of an event-based notification configuration: This shows a configuration where notifications different IPN endpoint URLs receive notifications for different event types.

<GetMerchantNotificationConfigurationResponse xmlns="http://mws.amazonservices.com/schema/OffAmazonPayments/2013-01-01">
    <GetMerchantNotificationConfigurationResult>
        <NotificationConfigurationList>
            <member>
                <NotificationUrl> URL1 </NotificationUrl>
                <EventTypes>
                    <member> ORDER_REFERENCE </member>
                    <member> PAYMENT_AUTHORIZE </member>
                    <member> PAYMENT_CAPTURE </member>
                </EventTypes>
            </member>
            <member>
                <NotificationUrl> URL2 </NotificationUrl>
                <EventTypes>
                    <member> PAYMENT_REFUND </member>
                </EventTypes>
            </member>
        </NotificationConfigurationList>
    </GetMerchantNotificationConfigurationResult>
    <ResponseMetadata>
        <RequestId>a249808b-f961-454a-8664-5b494462d1f2</RequestId>
    </ResponseMetadata>
</GetMerchantNotificationConfigurationResponse>