Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.
The following datatypes are used in the 亚马逊商城网络服务 (亚马逊 MWS) “付款 API”部分:
Datatype | Description |
---|---|
AdjustmentEvent | An adjustment to your account. |
AdjustmentItem | An item of an adjustment to your account. |
ChargeComponent | A charge on your account. |
ChargeInstrument | A payment instrument. |
CurrencyAmount | A currency type and amount. |
DebtRecoveryEvent | A debt payment or debt adjustment. |
DebtRecoveryItem | An item of a debt payment or debt adjustment. |
DirectPayment | A payment made directly to a seller. |
FeeComponent | A fee on your account. |
FinancialEventGroup | Contains information related to a financial event group. |
FinancialEvents | Contains all information related to a financial event. |
LoanServicingEvent | A loan advance, loan payment, or loan refund. |
PayWithAmazonEvent | An event related to your Pay with Amazon account. |
PerformanceBondRefundEvent | A refund of a seller performance bond that is issued when a seller in China stops selling in certain categories. |
Promotion | A promotion applied to an item. |
RentalTransactionEvent | An event related to a rental transaction. |
RetrochargeEvent | A retrocharge or retrocharge reversal. |
ServiceFeeEvent | A service fee on your account. |
ShipmentEvent | A shipment, refund, guarantee claim, or chargeback. |
ShipmentItem | An item of a shipment, refund, guarantee claim, or chargeback. |
SolutionProviderCreditEvent | A credit given to a solution provider. |
An adjustment to your account.
The following table shows the elements of the AdjustmentEvent datatype:
Name | Description |
---|---|
AdjustmentType | AdjustmentType values:
类型:xs:string |
AdjustmentAmount | The amount adjusted as part of this event. Type: CurrencyAmount |
AdjustmentItemList | A list of AdjustmentItem values. Type: List of AdjustmentItem |
An item of an adjustment to your account.
The following table shows the elements of the AdjustmentItem datatype:
Name | Description |
---|---|
Quantity | Represents the number of units in the seller's inventory when the
AdustmentType is
FBAInventoryReimbursement. 类型:xs:int |
PerUnitAmount | The per unit value of the item. Type: CurrencyAmount |
TotalAmount | The total value of the item. Type: CurrencyAmount |
SellerSKU | The Seller SKU of the item. The Seller SKU is qualified by your Seller ID,
which is included with every call to 亚马逊MWS. 类型:xs:string |
FnSKU | A unique identifier assigned by Amazon to products stored in and fulfilled
from an 亚马逊配送中心. 类型:xs:string |
ProductDescription | A short description of the item. 类型:xs:string |
ASIN | The ASIN of the item. 类型:xs:string |
A charge on your account.
The following table shows the elements of the ChargeComponent datatype:
Name | Description |
---|---|
ChargeType | ChargeType values:
类型:xs:string |
ChargeAmount | The amount of the charge. Type: CurrencyAmount |
A payment instrument.
The following table shows the elements of the ChargeInstrument datatype:
Name | Description |
---|---|
Description | A short description of the charge instrument. 类型:xs:string |
Tail | The account tail (trailing digits) of the charge instrument. 类型:xs:string |
Amount | The amount charged to this charge instrument. Type: CurrencyAmount |
A currency type and amount.
The following table shows the elements of the CurrencyAmount datatype:
Name | Description |
---|---|
CurrencyCode | The three-digit currency code in ISO 4217 format. 类型:xs:string |
CurrencyAmount | The currency amount. 类型:xs:decimal |
A debt payment or debt adjustment.
The following table shows the elements of the DebtRecoveryEvent datatype:
Name | Description |
---|---|
DebtRecoveryType | DebtRecoveryType values:
类型:xs:string |
RecoveryAmount | The amount applied for recovery. Type: CurrencyAmount |
OverPaymentCredit | The amount returned for overpayment. Type: CurrencyAmount |
DebtRecoveryItemList | A list of settlement debt recovery items. Type: List of DebtRecoveryItem |
ChargeInstrumentList | A list of charge instruments used for
DebtPayment or DebtPaymentFailure
recovery types. Type: List of ChargeInstrument |
An item of a debt payment or debt adjustment.
The following table shows the elements of the DebtRecoveryItem datatype:
Name | Description |
---|---|
RecoveryAmount | The amount applied for the recovery item. Type: CurrencyAmount |
OriginalAmount | The original debt amount. Type: CurrencyAmount |
GroupBeginDate | The beginning date of the financial event group that contains the
debt. 类型:xs:dateTime |
GroupEndDate | The ending date of the financial event group that contains the debt. 类型:xs:dateTime |
A payment made directly to a seller.
The following table shows the elements of the DirectPayment datatype:
Name | Description |
---|---|
DirectPaymentType | DirectPaymentType values:
类型:xs:string |
DirectPaymentAmount | The amount of the direct payment. Type: CurrencyAmount |
A fee on your account.
The following table shows the elements of the FeeComponent datatype:
Name | Description |
---|---|
FeeType | FeeType values:
类型:xs:string |
FeeAmount | The amount of the fee. Type: CurrencyAmount |
Contains information related to a financial event group.
The following table shows the elements of the FinancialEventGroup datatype:
Name | Description |
---|---|
FinancialEventGroupId | A unique identifier for the financial event group. 类型:xs:string |
ProcessingStatus | The processing status of the financial event group indicates whether the
balance of the financial event group is
settled. ProcessingStatus values:
类型:xs:string |
FundTransferStatus | The status of the fund transfer. 类型:xs:string |
OriginalTotal | The total amount in the currency of the marketplace in which the
transactions occurred. Type: CurrencyAmount |
ConvertedTotal | The total amount in the currency of the marketplace in which the funds were
disbursed. Type: CurrencyAmount |
FundTransferDate | The date when the disbursement or charge was initiated. Only present for
closed settlements. 类型:xs:dateTime |
TraceId | The trace ID used by sellers to look up transactions externally. 类型:xs:string |
AccountTail | The account tail of the payment instrument. 类型:xs:string |
BeginningBalance | The balance at the beginning of the settlement period. Type: CurrencyAmount |
FinancialEventGroupStart | The time at which the financial event group is opened. 类型:xs:dateTime |
FinancialEventGroupEnd | The time at which the financial event group is closed. 类型:xs:dateTime |
Contains all information related to a financial event.
The following table shows the elements of the FinancialEvents datatype:
Name | Description |
---|---|
ShipmentEvents | A list of shipment events. Type: List of ShipmentEvent |
RefundEvents | A list of refund events. Type: List of ShipmentEvent |
GuaranteeClaimEvents | A list of guarantee claim events. Type: List of ShipmentEvent |
ChargebackEvents | A list of chargeback events. Type: List of ShipmentEvent |
PayWithAmazonEvents | A list of Pay with Amazon events. Type: List of PayWithAmazonEvent |
ServiceProviderCreditEvents | A list of service provider credit events. Type: List of SolutionProviderCreditEvent |
RetrochargeEvents | A list of retrocharge events. Type: List of RetrochargeEvent |
RentalTransactionEvents | A list of rental transaction events. Type: List of RentalTransactionEvent |
PerformanceBondRefundEvents | A list of performance bond refund events. Type: List of PerformanceBondRefundEvent |
ServiceFeeEvents | A list of service fee events. Type: List of ServiceFeeEvent |
DebtRecoveryEvents | A list of debt recovery events. Type: List of DebtRecoveryEvent |
LoanServicingEvents | A list of loan servicing events. Type: List of LoanServicingEvent |
AdjustmentEvents | A list of adjustment events. Type: List of AdjustmentEvent |
A loan advance, loan payment, or loan refund.
The following table shows the elements of the LoanServicingEvent datatype:
Name | Description |
---|---|
LoanAmount | The amount of the loan. Type: CurrencyAmount |
SourceBusinessEventType | SourceBusinessEventType values:
类型:xs:string |
An event related to your Pay with Amazon account.
The following table shows the elements of the PayWithAmazonEvent datatype:
Name | Description |
---|---|
SellerOrderId | An order identifier that is specified by the seller. 类型:xs:string |
TransactionPostedDate | The date when the payment transaction is posted. 类型:xs:dateTime |
BusinessObjectType | BusinessObjectType values:
类型:xs:string |
SalesChannel | The sales channel for the transaction. 类型:xs:string |
Charge | The charge associated with the event. Type: ChargeComponent |
FeeList | A list of fees associated with the event. Type: List of FeeComponent |
PaymentAmountType | PaymentAmountType values:
类型:xs:string |
AmountDescription | A short description of this payment event. 类型:xs:string |
FulfillmentChannel | FulfillmentChannel values:
类型:xs:string |
StoreName | The store name where the event occurred. 类型:xs:string |
A refund of a seller performance bond that is issued when a seller in China stops selling in certain categories.
The following table shows the elements of the PerformanceBondRefundEvent datatype:
Name | Description |
---|---|
MarketplaceCountryCode | The two-letter code for the country associated with the marketplace. 类型:xs:string |
Amount | The amount that Amazon refunds to the seller. Type: CurrencyAmount |
ProductGroupList | A list of product categories that the seller has stopped selling
in. Type: List of xs:string |
A promotion applied to an item.
The following table shows the elements of the Promotion datatype:
Name | Description |
---|---|
PromotionType | The type of promotion. 类型:xs:string |
PromotionId | The seller-specified identifier for the promotion. 类型:xs:string |
PromotionAmount | The amount of promotional discount applied to the item. Type: CurrencyAmount |
An event related to a rental transaction.
The following table shows the elements of the RentalTransactionEvent datatype:
Name | Description |
---|---|
AmazonOrderId | An Amazon-defined order identifier. 类型:xs:string |
RentalEventType | RentalEventType values:
类型:xs:string |
ExtensionLength | The number of days that the buyer extended an already rented item. This
value is only returned for RentalCustomerPayment-Extension
and RentalCustomerRefund-Extension events. 类型:xs:int |
PostedDate | The date when the rental event was posted. 类型:xs:dateTime |
RentalChargeList | A list of charges accociated with the rental event. Type: List of ChargeComponent |
RentalFeeList | A list of fees associated with the rental event. Type: List of FeeComponent |
MarketplaceName | The name of the marketplace. 类型:xs:string |
RentalInitialValue | The amount of money the customer originally paid to rent the item. This
value is only returned for RentalChargeFailureReimbursement
and RentalLostItemReimbursement events. Type: CurrencyAmount |
RentalReimbursement | The amount of money Amazon sends the seller to compensate for a lost item
or a failed charge. This value is only returned for
RentalChargeFailureReimbursement and
RentalLostItemReimbursement events. Type: CurrencyAmount |
A retrocharge or retrocharge reversal.
The following table shows the elements of the RetrochargeEvent datatype:
Name | Description |
---|---|
RetrochargeEventType | RetrochargeEventType values:
类型:xs:string |
AmazonOrderId | An Amazon-defined identifier for an order. 类型:xs:string |
PostedDate | The date when the retrocharge event was posted. 类型:xs:dateTime |
BaseTax | The base tax associated with the retrocharge event. Type: CurrencyAmount |
ShippingTax | The shipping tax associated with the retrocharge event. Type: CurrencyAmount |
MarketplaceName | The name of the marketplace where the retrocharge event occurred. 类型:xs:string |
A service fee on your account.
The following table shows the elements of the ServiceFeeEvent datatype:
Name | Description |
---|---|
AmazonOrderId | An Amazon-defined identifier for an order. 类型:xs:string |
FeeReason | A short description of the service fee reason. 类型:xs:string |
FeeList | A list of fee components associated with the service
fee. Type: List of FeeComponent |
SellerSKU | The Seller SKU of the item. The Seller SKU is qualified by your Seller ID,
which is included with every call to 亚马逊MWS. 类型:xs:string |
FnSKU | A unique identifier assigned by Amazon to products stored in and fulfilled
from an 亚马逊配送中心. 类型:xs:string |
FeeDescription | A short description of the service fee event. 类型:xs:string |
ASIN | The ASIN of the item. 类型:xs:string |
A shipment, refund, guarantee claim, or chargeback.
The following table shows the elements of the ShipmentEvent datatype:
Name | Description |
---|---|
AmazonOrderId | An Amazon-defined identifier for an order. 类型:xs:string |
SellerOrderId | A seller-defined identifier for an order. 类型:xs:string |
MarketplaceName | The name of the marketplace where the event occurred. 类型:xs:string |
OrderChargeList | A list of order-level charges. These charges are applicable to
多渠道配送 (MCF) COD orders. Type: List of ChargeComponent |
OrderChargeAdjustmentList | A list of order-level charge adjustments. These adjustments are
applicable to 多渠道配送 (MCF) COD
orders. Type: List of ChargeComponent |
ShipmentFeeList | A list of shipment-level fees. Type: List of FeeComponent |
ShipmentFeeAdjustmentList | A list of shipment-level fee adjustments. Type: List of FeeComponent |
OrderFeeList | A list of order-level fees. These charges are applicable to 多渠道配送 (MCF) orders. Type: List of FeeComponent |
OrderFeeAdjustmentList | A list of order-level fee adjustments. These adjustments are
applicable to 多渠道配送 (MCF)
orders. Type: List of FeeComponent |
DirectPaymentList | A list of transactions where buyers pay Amazon through one of
the credit cards offered by Amazon or where buyers pay a seller directly through
COD. Type: List of DirectPayment |
PostedDate | The date when the financial event was created. 类型:xs:dateTime |
ShipmentItemList | A list of shipment items. Type: List of ShipmentItem |
ShipmentItemAdjustmentList | A list of shipment item adjustments. Type: List of ShipmentItem |
An item of a shipment, refund, guarantee claim, or chargeback.
The following table shows the elements of the ShipmentItem datatype:
Name | Description |
---|---|
SellerSKU | The Seller SKU of the item. The Seller SKU is qualified by your Seller ID,
which is included with every call to 亚马逊MWS. 类型:xs:string |
OrderItemId | An Amazon-defined order item identifier. 类型:xs:string |
OrderAdjustmentItemId | An Amazon-defined order adjustment identifier defined for refunds,
guarantee claims, and chargeback events. 类型:xs:string |
QuantityShipped | The number of items shipped. 类型:xs:int |
ItemChargeList | A list of charges associated with the shipment item. Type: List of ChargeComponent |
ItemChargeAdjustmentList | A list of charge adjustments associated with the shipment item.
This value is only returned for refunds, guarantee claims, and chargeback
events. Type: List of ChargeComponent |
ItemFeeList | A list of fees associated with the shipment item. Type: List of FeeComponent |
ItemFeeAdjustmentList | A list of fee adjustments associated with the shipment item.
This value is only returned for refunds, guarantee claims, and chargeback
events. Type: List of FeeComponent |
PromotionList | A list of promotions associated with the shipment item. Type: List of Promotion |
PromotionAdjustmentList | A list of promotion adjustments associated with the shipment
item. This value is only returned for refunds, guarantee claims, and chargeback
events. Type: List of Promotion |
CostOfPointsGranted | The cost of Amazon Points granted for a
shipment item. Type: CurrencyAmount |
CostOfPointsReturned | The cost of Amazon Points returned for a
shipment item. This value is only returned for refunds, guarantee claims, and
chargeback events. Type: CurrencyAmount |
A credit given to a solution provider.
The following table shows the elements of the SolutionProviderCreditEvent datatype:
Name | Description |
---|---|
ProviderTransactionType | ProviderTransactionType values:
类型:xs:string |
SellerOrderId | A seller-defined identifier for an order. 类型:xs:string |
MarketplaceId | The identifier of the marketplace where the order was placed. 类型:xs:string |
MarketplaceCountryCode | The two-letter country code of the country associated with the markerplace
where the order was placed. 类型:xs:string |
SellerId | The Amazon-defined identifier of the seller. 类型:xs:string |
SellerStoreName | The store name where the payment event occurred. 类型:xs:string |
ProviderId | The Amazon-defined identifier of the solution provider. 类型:xs:string |
ProviderStoreName | The store name where the payment event occurred. 类型:xs:string |