Skip to main content
Published: August 20 2008, 11:27:00 AMUpdated: November 28 2020, 4:12:18 PM

I read that beginning in late October, all items listed on eBay.com must use a 'paperless' payment method and that methods such as checks and money orders will no longer be accepted.  How can I revise my items to reflect this change?

With eBay's new 'paperless payment' requirement, it's important to add these options to your listings, or to provide functionality for your users to modify their own listings.  According to the August 2008 update, at least one of the following is required:

Paperless Payment Options 
  • PayPal (funded by PayPal account balance, credit card, debit card, bank account, PayPal Pay Later, PayPal Buyer Credit or eBay gift certificate)
  • Credit or debit card payment to a seller (through a seller's Internet merchant account)
  • ProPay
  • Payment upon pickup

With that in mind, let's see how we can use the API in order to fix our listings.  There are three calls we're interested in: AddItem, RelistItem, and ReviseItem.  Let's take a look at each one and see how we can use it to add paperless payment options.

In all three cases, the field we're most interested in is the <PaymentMethods> field(s) of the request.  You can include multiple payment methods, and can do so simply by adding multiple <PaymentMethods> in the body of your request.  A list of applicable values for payment methods can be found here, though keep in mind this listing will be changing per this annoucement.  Take a look at the sample below:

AddItem call with PayPal and Visa / Mastercard accepted 
  <?xml version="1.0" encoding="utf-8" ?>
- <AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>577</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
- <Item>
  <BuyItNowPrice>10.0</BuyItNowPrice>
  <Country>US</Country>
  <Currency>USD</Currency>
  <Description>NewSchema item description.</Description>
  <ListingDuration>Days_5</ListingDuration>
  <Location>San Jose, CA</Location>
  <PaymentMethods>VisaMC</PaymentMethods>
  <PaymentMethods>PayPal</PaymentMethods>
  <PayPalEmailAddress>ve2@aol.com</PayPalEmailAddress>
- <PrimaryCategory>
  <CategoryID>1463</CategoryID>
  </PrimaryCategory>
  <Quantity>1</Quantity>
  <StartPrice>1.0</StartPrice>
  <ShippingTermsInDescription>True</ShippingTermsInDescription>
  <Title>NewSchema item title</Title>
  </Item>
- <RequesterCredentials>
  <eBayAuthToken>YOUR_USER_TOKEN</eBayAuthToken>
  </RequesterCredentials>
  </AddItemRequest>

As you can see in the highlight portion of the request above, all we need to do when adding a new item is to specify at least one of the paperless methods referred to above.  By January 2009, all payments on eBay must be paperless, so it would make sense to begin listing items in this fashion. 

However, if you or your users have many items already on eBay and need to revise them, that can be done with the API as well.  When revising an item, you simply specify the <PaymentMethods> tag for each payment option you want to include, including payment methods that already be associated with the auction.  For instance, assume you have an item listed with PayPal, but want to add VisaMC as a second paypment option.  If, in your ReviseItem call, you only include VisaMC in <PaymentMethods>, your auction will no longer accept PayPal.  Instead, you need to specify two payment methods - VisaMC and PayPal.  Take a look at the example below:

ReviseItem - adding VisaMC to an auction that already accepts PayPal 
 
  <?xml version="1.0" encoding="utf-8" ?>
- <ReviseItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <Version>577</Version>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
- <Item>
  <ItemID>YOUR_ITEM_ID</ItemID>
  <PaymentMethods>PayPal</PaymentMethods>
  <PaymentMethods>VisaMC</PaymentMethods>
  </Item>
- <RequesterCredentials>
  <eBayAuthToken>YOUR_USER_TOKEN</eBayAuthToken>
  </RequesterCredentials>
  </ReviseItemRequest>

As you can see, we've specified PayPal and VisaMC, even though the original auction already included PayPal.  Our auction should now meet the criteria for paperless payments.

There's one last call that you might need to meet the new requirement, and that's RelistItem.  You can use this API call to relist any of your items that have ended, and make the necessary changes as you do it.  We don't need to go into too much detail here, since RelistItem works pretty much like ReviseItem.  In the example below, we're relisting our item and only accepting PayPal.

RelistItem - Relisting an item with VisaMC only 
  <?xml version="1.0" encoding="utf-8" ?>
- <RelistItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <DetailLevel>ReturnAll</DetailLevel>
  <ErrorLanguage>en_US</ErrorLanguage>
  <WarningLevel>High</WarningLevel>
  <Version>579</Version>
- <Item>
  <ItemID>YOUR_ITEM_ID</ItemID>

  <PaymentMethods>PayPal</PaymentMethods><P<


<PayPalEmailAddress>PAYPAL_EMAIL@YOUR_MAIL.com</PayPalEmailAddress>

  </Item>
- <RequesterCredentials>
  <eBayAuthToken>YOUR_USER_TOKEN</eBayAuthToken>
  </RequesterCredentials>
  </RelistItemRequest>

It's pretty easy to fix your listings.  If you need additional assistance, there are quite a few more in-depth guides, discussing these same API calls.  And of course, you can always file a support ticket.

Paperless payments: Developer Impact
eBay FAQ: Paperless payments
Listing an Item With Payment Methods
Changing Payment Methods in a Revised Item
Changing Payment Methods in a Relisted Item

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