Your application may wish to monitor the Paid Status of Orders. The Paid Status is set by the Seller in MyeBay, or by the Complete Sale API call. This article describes the support and best practices for monitoring Order level Paid Status.
Setting the Paid Status of an Order
The Paid Status of an Order can be set in two ways, depending on how your eBay Sellers manage their item status. If the Seller uses MyeBay, they can mark an Order as paid by choosing the 'Mark Payment as Received' option in MyeBay. If the Seller uses an API application, the application can call CompleteSale for each item within the Order, or all ReviseCheckoutStatus at the Order level, to mark the Order as paid.
Which fields are set when the Paid Status is updated?
The Order object does not contain it's own PaidTime flag. If an Order is marked as Paid, the following data is changed:
How can I retrieve a list of Orders in which the PaidTime has been set?
Because the Order object does not contain it's own PaidTime flag, you are reliant on the PaidTime setting in the Transaction for this information. Therefore it is suggested that you monitor changes to the Order.CheckoutStatus.LastModifiedTime via GetOrders and Transaction.PaidTime via GetItemTransactions.