Skip to main content
Published: March 30 2010, 11:36:00 AMUpdated: November 28 2020, 8:19:39 PM

How does PayPal refund impact the Transaction Status fields returned in GetSellerTransactions?

Snippets of the GetSellerTransaction response show how the Transaction Status changes when a transaction is refunded and other observable changes that are indicative of a refund. This example is for PayPal payment and refund scenario only.

The below snippet shows that the item was bought on 2010-03-30T18:03:03.000Z. The buyer paid for the item on 2010-03-30T18:05:56.000Z via PayPal. As you can see from the timestamp, the GST call was made after the buyer paid for the item. The ExternalTransaction container shows the details of the payment and the CheckOutStatus field confirms that the buyer completed checkout for the item.

 <Timestamp>2010-03-30T18:06:27.714Z</Timestamp>
<CreatedDate>2010-03-30T18:03:03.000Z</CreatedDate>
- <Status>
  <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
  <CheckoutStatus>CheckoutComplete</CheckoutStatus>
  <LastTimeModified>2010-03-30T18:05:59.000Z</LastTimeModified>
  <PaymentMethodUsed>PayPal</PaymentMethodUsed>
  <CompleteStatus>Complete</CompleteStatus>
  <BuyerSelectedShipping>true</BuyerSelectedShipping>
  <PaymentHoldStatus>None</PaymentHoldStatus>
  <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
  </Status>
  <TransactionID>0</TransactionID>
  <TransactionPrice currencyID="USD">10.0</TransactionPrice>
  <BestOfferSale>false</BestOfferSale>
- <ExternalTransaction>
  <ExternalTransactionID>3B094585MY1123322</ExternalTransactionID>
  <ExternalTransactionTime>2010-03-30T18:05:56.000Z</ExternalTransactionTime>
  <FeeOrCreditAmount currencyID="USD">0.74</FeeOrCreditAmount>
  <PaymentOrRefundAmount currencyID="USD">15.0</PaymentOrRefundAmount>
  </ExternalTransaction>

If the seller issues a refund for the transaction from PayPal, the CheckoutStatus flips from CheckoutComplete to CheckoutIncomplete. The below snippet is of GetSellerTransactions response after the seller issued a refund. Notice a new ExternalTransaction container in the response. Note that the amounts in this container are negative, indicating the refund.The LastTimeModified field will be updated when a refund is issued.

 <Timestamp>2010-03-30T18:14:27.368Z</Timestamp>
- <Status>
  <eBayPaymentStatus>NoPaymentFailure</eBayPaymentStatus>
  <CheckoutStatus>CheckoutIncomplete</CheckoutStatus>
  <LastTimeModified>2010-03-30T18:14:08.000Z</LastTimeModified>
  <PaymentMethodUsed>PayPal</PaymentMethodUsed>
  <CompleteStatus>Incomplete</CompleteStatus>
  <BuyerSelectedShipping>true</BuyerSelectedShipping>
  <PaymentHoldStatus>None</PaymentHoldStatus>
  <IntegratedMerchantCreditCardEnabled>false</IntegratedMerchantCreditCardEnabled>
  </Status>
  <TransactionID>0</TransactionID>
  <TransactionPrice currencyID="USD">10.0</TransactionPrice>
  <BestOfferSale>false</BestOfferSale>
- <ExternalTransaction>
  <ExternalTransactionID>3B094585MY1123322</ExternalTransactionID>
  <ExternalTransactionTime>2010-03-30T18:05:56.000Z</ExternalTransactionTime>
  <FeeOrCreditAmount currencyID="USD">0.74</FeeOrCreditAmount>
  <PaymentOrRefundAmount currencyID="USD">15.0</PaymentOrRefundAmount>
  </ExternalTransaction>
- <ExternalTransaction>
  <ExternalTransactionID>0KV35537N54870704</ExternalTransactionID>
  <ExternalTransactionTime>2010-03-30T18:13:48.000Z</ExternalTransactionTime>
  <FeeOrCreditAmount currencyID="USD">-0.74</FeeOrCreditAmount>
  <PaymentOrRefundAmount currencyID="USD">-15.0</PaymentOrRefundAmount>
  </ExternalTransaction>

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