AmountType ( double )

An eBay-defined complex type for specifying monetary amounts.

A double value (e.g., 1.00 or 1.0) is meaningful as a monetary amount when accompanied by a specification of the currency, in which case the value specifies the amount in that currency. An AmountType expresses both the value (a double) and the currency.

The AmountType data type is typically used to specify details such as prices, fees, costs, and payments. In some cases, a whole number (i.e., without a period) can be passed or returned as a monetary value. This is necessary to support certain currencies that are only expressed as whole numbers (like the Italian Lira and Spanish Peseta).

Because a double is used to represent the amount, this also means whole monetary amounts may be returned with only one 0 after the decimal. For example, a dollar value could be returned as 1.0 instead of 1.00 in calls like AddItem. For fields of type AmountType, see the individual topics for specific restrictions beyond this.

Types that use AmountType:

AccountEntryType, AccountSummaryType, AdditionalAccountType, AddSecondChanceItemRequestType, AddTransactionConfirmationItemRequestType, AdFormatLeadType, BestOfferDetailsType, BestOfferType, BiddingDetailsType, BuyingSummaryType, CalculatedHandlingDiscountType, CalculatedShippingRateType, CategoryFeatureType, DiscountPriceInfoType, DiscountProfileType, eBayPaymentMismatchDetailsType, ExternalTransactionType, FeedbackDetailType, FeeType, FlatRateInsuranceRangeCostType, GetAllBiddersResponseType, InsuranceDetailsType, InternationalShippingServiceOptionsType, InventoryStatusType, IssueRefundRequestType, IssueRefundResponseType, ItemType, ListingDetailsType, ListingStartPriceDetailsType, MultiLegShippingServiceType, MyeBayFavoriteSearchType, MyeBaySellingSummaryType, OfferType, OrderType, PaymentDetailsType, ProductInfoType, PromotionalSaleDetailsType, PromotionalShippingDiscountDetailsType, RefundFundingSourceType, RefundType, RespondToBestOfferRequestType, ReviseCheckoutStatusRequestType, SalesTaxType, SellerDiscountsType, SellerDiscountType, SellerFavoriteItemPreferencesType, SellerPaymentType, SellingManagerAutoSecondChanceOfferType, SellingManagerProductDetailsType, SellingManagerProductInventoryStatusType, SellingManagerSoldOrderType, SellingManagerSoldTransactionType, SellingStatusType, SellingSummaryType, SendInvoiceRequestType, ShipmentType, ShippingDetailsType, ShippingServiceOptionsType, SiteDefaultsType, StoreSubscriptionType, TaxDetailsType, TaxesType, TransactionType, VariationType, VerifyAddSecondChanceItemRequestType

Calls that use AmountType:

AddFixedPriceItem, AddItem, AddItems, AddOrder, AddSecondChanceItem, AddSellingManagerProduct, AddSellingManagerTemplate, AddTransactionConfirmationItem, DeleteSellingManagerItemAutomationRule, DeleteSellingManagerTemplateAutomationRule, GetAccount, GetAllBidders, GetBestOffers, GetBidderList, GetCategoryFeatures, GetDispute, GeteBayDetails, GetFeedback, GetItem, GetItemRecommendations, GetItemShipping, GetItemTransactions, GetMemberMessages, GetMyeBayBuying, GetMyeBaySelling, GetOrders, GetOrderTransactions, GetSellerEvents, GetSellerList, GetSellerPayments, GetSellerTransactions, GetSellingManagerInventory, GetSellingManagerItemAutomationRule, GetSellingManagerSaleRecord, GetSellingManagerSoldListings, GetSellingManagerTemplateAutomationRule, GetSellingManagerTemplates, GetShippingDiscountProfiles, GetStoreOptions, GetUserPreferences, IssueRefund, PlaceOffer, RelistFixedPriceItem, RelistItem, RespondToBestOffer, ReviseCheckoutStatus, ReviseFixedPriceItem, ReviseInventoryStatus, ReviseItem, ReviseSellingManagerProduct, ReviseSellingManagerSaleRecord, ReviseSellingManagerTemplate, SendInvoice, SetSellingManagerItemAutomationRule, SetSellingManagerTemplateAutomationRule, SetShippingDiscountProfiles, SetUserPreferences, VerifyAddFixedPriceItem, VerifyAddItem, VerifyAddSecondChanceItem, VerifyRelistItem

Fields

This type has no fields.

Attribute

currencyID ( see CurrencyCodeType for possible values )

Three-digit code representing the currency type being used.

In the AddItem family of calls, the currency can be specified in the Item.Currency field in requests instead. If you do specify this attribute in the AddItem family of calls, the value must match the site currency (i.e., it must be the same as the value in Item.Currency) unless otherwise stated.

In the AddItem family of calls, listing fees are returned in the currency of the user's registration site. For example, a user who is registered on the eBay US site always sees their fees returned in USD, even when their listing request is sent to another site, such as eBay UK or eBay Germany.

Copyright © 2005–2013 eBay, Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.