|
【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>
■Amazonポイントの利用については、以下の記事もご参照ください。
http://aws.typepad.com/jp_mws/2014/05/point.html
■代金引換の利用については、以下の記事もご参照ください。
http://aws.typepad.com/jp_mws/2012/02/order_processing_of_cod.html
以上、皆様の開発時のご参考となれば幸いです。
