eBay Trading APIVersion 1005

PaymentDetailsType

Type defining the PaymentDetails container, which is used by the seller to specify amounts and due dates for deposits and full payment on motor vehicle listings.

Type that uses PaymentDetailsType:

Calls that use PaymentDetailsType:

Fields

DaysToFullPayment ( int ) [0..1]
This integer value indicates the number of days that a buyer has (after he/she commits to buy) to make full payment to the seller and close the remaining balance on a motor vehicle. Valid values: 3, 7 (default), 10, and 14.

In order for a buyer to make a full payment on an US or CA motor vehicle, at least one of the following PaymentMethods values must be specified for the listing:
  • CashInPerson
  • LoanCheck
  • MOCC (money order or cashier's check)
  • PaymentSeeDescription (indicates to prospective buyers that payment instructions are in the item's description
  • PersonalCheck
See the Field Index to learn which calls use DaysToFullPayment.

DepositAmount ( AmountType (double) ) [0..1]
This dollar value indicates the amount of the deposit that a buyer must make on a purchased motor vehicle (eBay Motors US and CA). The deposit amount can be as high as $2,000.00.

If not specified, this value defaults to '0.0'. If the seller is requiring that the buyer put down a deposit on the vehicle, the seller must include and set the DepositType field to OtherMethod and specify an HoursToDeposit value. If specified, then also specify HoursToDeposit

Deposits can only be paid using PayPal, so if DepositAmount is specified (and not '0.0'), then the listing must offer 'PayPal' as a payment method (in addition to the payment methods offered for the full payment). Unlike other listings, PayPal is not automatically added to a Motors listing even if the seller has a PayPal preference set in My eBay. The seller also needs to have a linked PayPal account in order to require a deposit.

The deposit amount appears in the shipping, payment details and return policy section of the View Item page.

For ReviseItem and related calls: If the listing has no bids, the seller can add or lower a deposit; and they can increase the deposit if the listing doesn't require Immediate Payment. The seller can also remove the Immediate Payment option (if any). If the listing has bids, the seller can only lower an existing deposit; but not add or increase a deposit. The seller can't remove Immediate Payment when a listing with a deposit has bids.
See the Field Index to learn which calls use DepositAmount.

DepositType ( DepositTypeCodeType ) [0..1]
This field applies to eBay Motors (US and CA) vehicles listings. If the seller is requiring that the buyer make a deposit on the vehicle, the DepositType value must be included and set to OtherMethod. Otherwise, specify None (or don't pass in DepositType).
See the Field Index to learn which calls use DepositType.

HoursToDeposit ( int ) [0..1]
This integer value indicates the number of hours that a buyer has (after he/she commits to buy) to make a deposit to the seller as a down payment on a motor vehicle. Valid values: 24, 48 (default), and 72.

The deposit amount is specified in the DepositAmount field. If not specified, the DepositAmount value defaults to 0.0, in which case, a deposit on the vehicle is not required.
See the Field Index to learn which calls use HoursToDeposit.