Find the answer to your question
Advanced Search
Published: May 18 2007, 10:25:00 PMUpdated: November 28 2020, 3:45:38 PM
Product
How do I go about listing items with financing options?
Summary
Items can be listed on eBay with financing available to buyers. This is done by including the FinanceOfferID element in the AddItem request.
The value for FinanceOfferID is the numerical id of the finance offer the seller is offering.
The GetFinanceOffers call is used to get the list of finance offers, including the numerical id, that a seller can offer in an item.
Detailed Description
Here is an AddItem request that is used to list with the finance offer defined by FinanceOfferID = 0
<?xml version="1.0" encoding="utf-8"?>
<AddItemRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>513</Version>
<ErrorLanguage>en_US</ErrorLanguage>
<WarningLevel>High</WarningLevel>
<Item>
<BuyItNowPrice>10.0</BuyItNowPrice>
<Country>US</Country>
<Currency>USD</Currency>
<Description>your description</Description>
<ListingDuration>Days_5</ListingDuration>
<Location>San Jose, CA</Location>
<FinanceOfferID>0</FinanceOfferID>
<PaymentMethods>PaymentSeeDescription</PaymentMethods>
<PaymentMethods>PayPal</PaymentMethods>
<PayPalEmailAddress>yourpaypalemailaddress</PayPalEmailAddress>
<PrimaryCategory>
<CategoryID>71263</CategoryID>
</PrimaryCategory>
<Quantity>1</Quantity>
<StartPrice>1.0</StartPrice>
<ShippingTermsInDescription>True</ShippingTermsInDescription>
<Title>your item title</Title>
</Item>
<RequesterCredentials>
<eBayAuthToken>token</eBayAuthToken>
</RequesterCredentials>
</AddItemRequest>
Here is a GetFinanceOffers request, and the FinanceOfferArray of a typical response showing the finance offers available for the seller to use.
<?xml version="1.0" encoding="utf-8"?>
<GetFinanceOffersRequest xmlns="urn:ebay:apis:eBLBaseComponents">
<Version>513</Version>
<DetailLevel>ReturnAll</DetailLevel>
<RequesterCredentials>
<eBayAuthToken>token</eBayAuthToken>
</RequesterCredentials>
</GetFinanceOffersRequest>
<FinanceOfferArray>
<FinanceOffer>
<FinanceOfferID>0</FinanceOfferID>
<BuyerTerms><font face="Arial" color="#339933" size="2"><b> Make no payments for 3 months <br></b><font color="#666666"> and pay no interest if paid in 3 months on your first purchase over $50 with the PayPal Plus Credit Card. Plus, earn rewards on every purchase you make! Get the PayPal Plus Credit Card and use anywhere MasterCard is accepted. </font></font></BuyerTerms>
<SellerTerms>Limited time offer: "No Payments for 3 Months" will be displayed for items over $50 (free for sellers).</SellerTerms>
<StartDate>2006-12-29T00:12:59.000Z</StartDate>
<LastModifiedDate>2006-12-28T17:12:59.000Z</LastModifiedDate>
<MinimumAmount currencyID="USD">50.0</MinimumAmount>
<RateFactor>0.041667</RateFactor>
<Priority>0</Priority>
</FinanceOffer>
<FinanceOffer>
<FinanceOfferID>6</FinanceOfferID>
<BuyerTerms><font face="Arial" color="#000000" size="2"><b>12 fixed monthly payments at 12.9% APR<br></b><font color="#666666">if you use PayPal Buyer Credit for this item. Total purchase must be over $999. Subject to credit approval. US residents only.</font></BuyerTerms>
<SellerTerms>12 fixed monthly payments at 12.9% APR for total purchases over $999 (1.25% selling fee)</SellerTerms>
<StartDate>2004-05-13T07:00:00.000Z</StartDate>
<LastModifiedDate>2004-06-10T08:01:28.000Z</LastModifiedDate>
<MinimumAmount currencyID="USD">999.0</MinimumAmount>
<RateFactor>0.08927</RateFactor>
<Priority>300</Priority>
</FinanceOffer>
<FinanceOffer>
<FinanceOfferID>7</FinanceOfferID>
<BuyerTerms><font face="Arial" color="#000000" size="2"><b>24 fixed monthly payments at 12.9% APR<br></b><font color="#666666">if you use PayPal Buyer Credit for this item. Total purchase must be over $1999. Subject to credit approval. US residents only.</font></BuyerTerms>
<SellerTerms>24 fixed monthly payments at 12.9% APR for total purchases over $1,999 (2.75% selling fee)</SellerTerms>
<StartDate>2004-05-13T07:00:00.000Z</StartDate>
<LastModifiedDate>2004-06-10T08:01:28.000Z</LastModifiedDate>
<MinimumAmount currencyID="USD">1999.0</MinimumAmount>
<RateFactor>0.047495</RateFactor>
<Priority>500</Priority>
</FinanceOffer>
<FinanceOffer>
<FinanceOfferID>2</FinanceOfferID>
<BuyerTerms><font face="Arial" color="#000000" size="2"><b>No interest if paid in 6 months<br></b><font color="#666666">if you use PayPal Buyer Credit for this item. Total purchase must be over $199. Subject to credit approval. US residents only. Monthly payments required.</font></BuyerTerms>
<SellerTerms>6 months deferred interest for total purchases over $199 (1.75% selling fee)</SellerTerms>
<StartDate>2004-08-15T07:00:00.000Z</StartDate>
<LastModifiedDate>2004-08-15T23:34:45.000Z</LastModifiedDate>
<MinimumAmount currencyID="USD">199.0</MinimumAmount>
<RateFactor>0.0</RateFactor>
<Priority>675</Priority>
</FinanceOffer>
<FinanceOffer>
<FinanceOfferID>4</FinanceOfferID>
<BuyerTerms><font face="Arial" color="#000000" size="2"><b>No interest if paid in 12 months<br></b><font color="#666666">if you use PayPal Buyer Credit for this item. Total purchase must be over $199. Subject to credit approval. US residents only. Monthly payments required.</font></BuyerTerms>
<SellerTerms>12 months deferred interest for total purchases over $199 (5.00% selling fee)</SellerTerms>
<StartDate>2004-08-15T07:00:00.000Z</StartDate>
<LastModifiedDate>2004-08-15T23:34:45.000Z</LastModifiedDate>
<MinimumAmount currencyID="USD">199.0</MinimumAmount>
<RateFactor>0.0</RateFactor>
<Priority>875</Priority>
</FinanceOffer>
</FinanceOfferArray>
Additional Resources
-
Documentation:
GetFinanceOffers
-
Documentation:
FinanceOfferID input request element