Skip to main content
Published: June 29 2007, 9:39:00 AMUpdated: November 28 2020, 3:50:53 PM

Can the amount of money that a buyer has to pay be calculated or determined through the API?

Can the total amount of money that a buyer has to pay be calculated or determined through the API?

Detailed Description

The simple answer is that the amount of money that a buyer has to pay cannot be calculated through the API.
When a purchase is made for one item on eBay, a transaction is created for that purchase.
The details of the transaction are returned in the response of the GetItemTransactions (GIT) and GetSellerTransactions (GST) API calls.
The amount of money that the buyer will have to pay includes the actual price of the item, any sales tax the seller is charging, the shipping and handling and insurance costs, and any other charges or credits that the seller indicates.
These line items that make up the amount of money that the buyer will have to pay are not known immediately at the time the purchase is made.
They become known once the buyer proceeds through the eBay Checkout flow.
The page where the data becomes known in the eBay Checkout flow is commonly known as "Review Your Purchase(s)".

Therefore, if the GIT and GST calls are made before the buyer has gone through the eBay Checkout flow, the total amount of money cannot be determined.

Here are the data points that are available, and a description of each data point with regards to the validity of the data:

  • Transaction.AmountPaid
    This is the total amount of money that eBay expects the buyer to pay. It does not indicate that the buyer has actually made a payment.
    The data is considered valid once Transaction.Status.BuyerSelectedShipping is true or Transaction.Status.PaymentMethodUsed has been set.
    If Transaction.Status.BuyerSelectedShipping is true, it means that the buyer has completed the eBay Review Your Purchase(s) page.
    If Transaction.Status.PaymentMethodUsed is set, it means that eBay, PayPal, or another API application has marked the transaction as paid on behalf of the seller.
    Before this data is considered valid, it will still contain a default value.
  • Transaction.ShippingServiceSelected.ShippingServiceCost
    The cost of shipping for the transaction.
    The data is considered valid once Transaction.Status.BuyerSelectedShipping is true.
    There can be other conditions under which the value is valid, however these other conditions are not 100% deterministic.
    When PaymentMethodUsed is set, the entity (PayPal or other API application) may have set this value as well, but there is no guarantee of this, and there is no way to tell for sure.
    When the data is valid, this is part of the calculation for the total amount of money the buyer has to pay.
  • Transaction.ShippingServiceSelected.ShippingInsuranceCost
    The insurance cost for shipping for the transaction.
    The data is considered valid once Transaction.Status.BuyerSelectedShipping is true.
    There can be other conditions under which the value is valid, however these other conditions are not 100% deterministic.
    When PaymentMethodUsed is set, the entity (PayPal or other API application) may have set this value as well, but there is no guarantee of this, and there is no way to tell for sure.
    When the data is valid, this is part of the calculation of the total amount of money the buyer has to pay.
  • Transaction.AdjustmentAmount
    This data represents charges or credits entered by the buyer or by the seller.
    The seller can optionally allow the buyer to enter this in the Review Your Purchase(s) page.
    The seller can also add charges or credits to a transaction from their My eBay, or Selling Manager or Selling Manager Pro interface on the eBay site.
    The data is considered valid once Transaction.Status.BuyerSelectedShipping is true or Transaction.Status.PaymentMethodUsed has been set.
    When the data is valid, this is part of the calculation of the total amount of money the buyer has to pay.


Additional Resources

How well did this answer your question?
Answers others found helpful