注文API での新しい支払方法の取得方法について

【2017.06.29 追記】

PaymentMethodDetail 要素の仕様が変更されます。詳しくは「注文APIのPaymentMethodDetail要素について」をご確認ください。

Amazon MWSの注文APIに購入者様が注文の代金の支払いに利用された支払方法を表す PaymentMethodDetail 要素が追加されました。PaymentMethodDetails 要素は注文API セクションの以下のオペレーションのOrders要素の子要素として返却されます。

これまでは同じくOrder要素配下のPaymentMethod要素によって代金引換決済（COD）、コンビニ決済（CVS）またはその他（Other）の3つの情報のみ取得が可能でした。また、PaymentMethod要素は注文の保留期間中は返却されず、注文確定後のみ取得可能でした。

PaymentMethodDetail要素は、購入者様が利用された支払方法によらず必ず返却され、注文の保留期間中にも取得できます。複数の支払方法が併用された場合には、複数のPaymentMethodDetail要素が返却され、利用された全ての支払方法を取得できます。

■ PaymentMethodDetail要素で返却される値

返却値	支払方法
CreditCard	クレジットカード
CashOnDelivery	代金引換
GiftCertificate	Amazonギフト券
StoredValueCard	コンビニ・ATM・ネットバンキング・電子マネー払い
Other	Amazonポイント

■ クレジットカード・Amazonポイント・Amazonギフト券の併用時の Order 要素のサンプル

＜注文保留中＞

     <Order>
        <LatestShipDate>2017-05-16T14:59:59Z</LatestShipDate>
        <OrderType>StandardOrder</OrderType>
        <PurchaseDate>2017-05-15T05:11:32Z</PurchaseDate>
        <AmazonOrderId>250-2337413-2866231</AmazonOrderId>
        <LastUpdateDate>2017-05-15T05:12:03Z</LastUpdateDate>
        <IsReplacementOrder>false</IsReplacementOrder>
        <ShipServiceLevel>Next JP D2D Dom</ShipServiceLevel>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <OrderStatus>Pending</OrderStatus>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <PaymentMethodDetails>
          <PaymentMethodDetail>CreditCard</PaymentMethodDetail>
          <PaymentMethodDetail>Other</PaymentMethodDetail>
          <PaymentMethodDetail>GiftCertificate</PaymentMethodDetail>
        </PaymentMethodDetails>
        <IsPremiumOrder>true</IsPremiumOrder>
        <EarliestShipDate>2017-05-15T15:00:00Z</EarliestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <IsPrime>true</IsPrime>
        <ShipmentServiceLevelCategory>NextDay</ShipmentServiceLevelCategory>
     </Order>

＜注文確定後＞

     <Order>
        <LatestShipDate>2017-05-16T14:59:59Z</LatestShipDate>
        <OrderType>StandardOrder</OrderType>
        <PurchaseDate>2017-05-15T05:11:32Z</PurchaseDate>
        <AmazonOrderId>xxx-xxxxxxx-xxxxxxx</AmazonOrderId>
        <BuyerEmail>[email protected]</BuyerEmail>
        <LastUpdateDate>2017-05-15T05:42:08Z</LastUpdateDate>
        <IsReplacementOrder>false</IsReplacementOrder>
        <ShipServiceLevel>Next JP D2D Dom</ShipServiceLevel>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <OrderStatus>Unshipped</OrderStatus>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <LatestDeliveryDate>2017-05-17T14:59:59Z</LatestDeliveryDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <PaymentMethodDetails>
          <PaymentMethodDetail>CreditCard</PaymentMethodDetail>
          <PaymentMethodDetail>Other</PaymentMethodDetail>
          <PaymentMethodDetail>GiftCertificate</PaymentMethodDetail>
        </PaymentMethodDetails>
        <BuyerName>アマゾン　太郎</BuyerName>
        <EarliestDeliveryDate>2017-05-16T15:00:00Z</EarliestDeliveryDate>
        <OrderTotal>
          <CurrencyCode>JPY</CurrencyCode>
          <Amount>2.00</Amount>
        </OrderTotal>
        <IsPremiumOrder>true</IsPremiumOrder>
        <EarliestShipDate>2017-05-15T15:00:00Z</EarliestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <PaymentMethod>Other</PaymentMethod>
        <ShippingAddress>
          <StateOrRegion>東京都</StateOrRegion>
          <Phone>xxxxxxxxxx</Phone>
          <CountryCode>JP</CountryCode>
          <PostalCode>xxx-xxxx</PostalCode>
          <Name>アマゾン　太郎</Name>
          <AddressLine1>目黒区下目黒</AddressLine1>
          <AddressLine2>x-x-x xxxx xxxx</AddressLine2>
        </ShippingAddress>
        <IsPrime>true</IsPrime>
        <ShipmentServiceLevelCategory>NextDay</ShipmentServiceLevelCategory>
     </Order>

■ 代金引換・Amazonポイント・Amazonギフト券の併用時の Order 要素のサンプル

代金引換を利用される場合のみ、注文確定後の Order 要素配下に PaymentExecutionDetail 要素が返却されます。その子要素である PaymentExecutionDetailItem 要素配下にも PaymentMethod 要素が返却され、支払いの内訳が確認できます。

＜注文保留中＞

     <Order>
        <LatestShipDate>2017-05-16T14:59:59Z</LatestShipDate>
        <OrderType>StandardOrder</OrderType>
        <PurchaseDate>2017-05-15T05:12:45Z</PurchaseDate>
        <AmazonOrderId>xxx-xxxxxxx-xxxxxxx</AmazonOrderId>
        <LastUpdateDate>2017-05-15T05:16:38Z</LastUpdateDate>
        <IsReplacementOrder>false</IsReplacementOrder>
        <ShipServiceLevel>Std JP D2D Dom 1</ShipServiceLevel>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <OrderStatus>Pending</OrderStatus>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <PaymentMethodDetails>
          <PaymentMethodDetail>CashOnDelivery</PaymentMethodDetail>
          <PaymentMethodDetail>GiftCertificate</PaymentMethodDetail>
          <PaymentMethodDetail>Other</PaymentMethodDetail>
        </PaymentMethodDetails>
        <IsPremiumOrder>false</IsPremiumOrder>
        <EarliestShipDate>2017-05-15T15:00:00Z</EarliestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <IsPrime>true</IsPrime>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
     </Order>

＜注文確定後＞

     <Order>
        <LatestShipDate>2017-05-16T14:59:59Z</LatestShipDate>
        <OrderType>StandardOrder</OrderType>
        <PurchaseDate>2017-05-15T05:12:45Z</PurchaseDate>
        <PaymentExecutionDetail>
          <PaymentExecutionDetailItem>
            <PaymentMethod>PointsAccount</PaymentMethod>
            <Payment>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>1.00</Amount>
            </Payment>
          </PaymentExecutionDetailItem>
          <PaymentExecutionDetailItem>
            <PaymentMethod>GC</PaymentMethod>
            <Payment>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>325.00</Amount>
            </Payment>
          </PaymentExecutionDetailItem>
        </PaymentExecutionDetail>
        <AmazonOrderId>xxx-xxxxxxx-xxxxxxx</AmazonOrderId>
        <BuyerEmail>[email protected]</BuyerEmail>
        <LastUpdateDate>2017-05-15T05:42:58Z</LastUpdateDate>
        <IsReplacementOrder>false</IsReplacementOrder>
        <ShipServiceLevel>Std JP D2D Dom 1</ShipServiceLevel>
        <NumberOfItemsShipped>0</NumberOfItemsShipped>
        <OrderStatus>Unshipped</OrderStatus>
        <SalesChannel>Amazon.co.jp</SalesChannel>
        <ShippedByAmazonTFM>false</ShippedByAmazonTFM>
        <LatestDeliveryDate>2017-05-18T14:59:59Z</LatestDeliveryDate>
        <NumberOfItemsUnshipped>1</NumberOfItemsUnshipped>
        <PaymentMethodDetails>
          <PaymentMethodDetail>CashOnDelivery</PaymentMethodDetail>
          <PaymentMethodDetail>GiftCertificate</PaymentMethodDetail>
          <PaymentMethodDetail>Other</PaymentMethodDetail>
        </PaymentMethodDetails>
        <BuyerName>アマゾン　太郎</BuyerName>
        <EarliestDeliveryDate>2017-05-16T15:00:00Z</EarliestDeliveryDate>
        <OrderTotal>
          <CurrencyCode>JPY</CurrencyCode>
          <Amount>326.00</Amount>
        </OrderTotal>
        <IsPremiumOrder>false</IsPremiumOrder>
        <EarliestShipDate>2017-05-15T15:00:00Z</EarliestShipDate>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <FulfillmentChannel>MFN</FulfillmentChannel>
        <PaymentMethod>COD</PaymentMethod>
        <ShippingAddress>
          <StateOrRegion>東京都</StateOrRegion>
          <Phone>xxxxxxxxxx</Phone>
          <CountryCode>JP</CountryCode>
          <PostalCode>xxx-xxxx</PostalCode>
          <Name>アマゾン　太郎</Name>
          <AddressLine1>目黒区下目黒</AddressLine1>
          <AddressLine2>x-x-x xxx xxxx</AddressLine2>
        </ShippingAddress>
        <IsPrime>true</IsPrime>
        <ShipmentServiceLevelCategory>Standard</ShipmentServiceLevelCategory>
     </Order>