Skip to main content
Published: April 02 2009, 6:06:00 PMUpdated: August 19 2022, 8:13:00 AM

I have some questions regarding GetSellerTransactions API call, specifically about the transaction status.

Q. What statuses do I need to check so that the item transaction status can be mapped to the item status in My eBay? 
Sold --> Awaiting Payment
Sold --> Awaiting Shipment
Sold --> Paid and Shipped

Ans. If you make a call to GetSellerTransactions, then this is how you can map the transaction status to the item status in My eBay.

Sold --> Awaiting Payment
Paid is determined by the existence of the Transaction.PaidTime element with a valid dateTime value. If the PaidTime element is not returned for a transaction or is returned with no value, then the transaction is considered "Awaiting Payment". Also
TransactionArray.Transaction.Status.CheckoutStatus will be equal to CheckoutIncomplete
TransactionArray.Transaction.Status.CompleteStatus will be equal to Incomplete

Sold --> Awaiting Shipment
TransactionArray.Transaction.ShippedTime - Shipped is determined by the existence of the Transaction.ShippedTime element with a valid dateTime value. If the ShippedTime element is not returned for a transaction or is returned with no value, then the transaction is considered "Awaiting Shipment".

Sold --> Paid and Shipped
Paid is determined by the existence of the Transaction.PaidTime element with a valid dateTime value. Also
TransactionArray.Transaction.Status.eBayPaymentStatus will be equal to NoPaymentFailure
TransactionArray.Transaction.Status.CheckoutStatus will be equal to CheckoutComplete
TransactionArray.Transaction.Status.CompleteStatus will be equal to Complete
TransactionArray.Transaction.ShippedTime will indicate the time when the item(s) associated with the transaction were marked as shipped, if known. The value is set when the seller uses shipment tracking features offered by eBay or an eBay partner. This value is also set when the seller marks the item as shipped by using CompleteSale.

Note: As of today transactions cannot be filtered by these statuses using the API.

Q. What is the meaning of the transaction status Pending and Incomplete?

Ans. TransactionArray.Transaction.Status.CompleteStatus field indicates the status of the transaction and derives its value from the CheckoutStatus field. The values in the field transition from Pending to Incomplete to Complete. When the user commit's to buy an item a Transaction is created and its status shows Incomplete. In reality the status change happens from Pending to Incomplete, however this is indicernible. When user completes checkout for the item the value changes from Incomplete to Complete.

You can update the status of a transaction regarding payment received or shipping information. See the CompleteSale and ReviseCheckoutStatus API calls for the same. There is no way to tag the transaction as cancelled or returned.

If you issued a paypal refund to a customer then the PaymentOrRefundAmount field in GetSellerTransactions will indicate the amount refunded. Also the TransactionArray.Transaction.Status.CompleteStatus and CheckoutStatus will be flipped back to Incomplete.

 

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

Got thoughts? Click the feedback button – your insights help us improve!