Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ: 2017年6 月

【2017.10.26 追記】

Amazon.co.jpにおいて、Amazonが認定する法人/個人事業主のお客様は、請求書による支払いを選択できるようになりました。
これに伴い、PaymentMethodDetail要素に「請求書払い」を表す返却値 “Invoice” が追加されました。
請求書払いに関する開発者向けガイドはこちらをご参照願います。

前回の記事「注文API での新しい支払方法の取得方法について」でご案内した注文APIの PaymentMethodDetail 要素の仕様が変更されます。（変更日時は未定です）

※PaymentMethodDetails 要素は注文API セクションの以下のオペレーションのOrders要素の子要素として返却されます。

PaymentMethodDetail要素では購入者様がご利用になったた全ての支払方法を取得できるようになっておりました。

しかし、購入者様のプライバシー保護の観点から、代金引換の場合を除き、Amazon が代金の回収を代行するため出品者様に意識して頂く必要がない支払方法では詳細は開示されず、Standard という共通の値が返却されるように変更されます。

■ 仕様変更後にPaymentMethodDetail要素で返却される値

返却値	支払方法
CashOnDelivery	代金引換
Invoice	請求書払い
Standard	上記以外の支払方法

仕様変更後にListOrdersオペレーションやGetOrderオペレーションで返却されるレスポンスのOrder要素のサンプルは以下のようになる予定です。

■ クレジットカード・Amazonポイント・Amazonギフト券の併用時の 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>Standard</PaymentMethodDetail>
          <PaymentMethodDetail>Standard</PaymentMethodDetail>
          <PaymentMethodDetail>Standard</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 要素が返却され、支払いの内訳が確認できます。

[注文の合計金額：326円に対し、Amazonポイント：1円分とAmazonギフト券：325円分を併用して支払われた場合]

     <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>Standard</PaymentMethodDetail>
          <PaymentMethodDetail>Standard</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>