eBay Business Policies Management APIVersion 1.0.0


Type that defines the depositDetails container, which is used by the seller to specify amounts and due dates for deposits and full payment on eBay Motors (US and CA) vehicle listings. The depositDetails container is conditionally required if the the payment policy is for eBay Motors (US and CA) vehicles listings (categoryGroup.name=MOTORS_VEHICLE).

Type that uses DepositDetails:

Calls that use DepositDetails:


daysToFullPayment ( int ) [0..1]
This integer value indicates the number of days that a buyer has to make their full payment to the seller and close the remaining balance on a motor vehicle transaction. This container must be specified for motor vehicles listings. Valid values are '3', '7' (default), '10', and '14'.

In order for a buyer to make a full payment on a US or CA motor vehicle, at least one of the following acceptedPaymentMethod values must be specified for the corresponding payment policy:
  • CashOnPickup
  • LoanCheck
  • MOCC (money order or cashier's check)
  • PersonalCheck
See the Field Index to learn which calls use daysToFullPayment.

depositAmount ( Amount (double) ) [0..1]
This value indicates the initial deposit amount required from the buyer in order to purchase a motor vehicle. This value can be as high as $2,000.00 if immediate payment is not required, and up to $500.00 if immediate payment is required. This container is only applicable if the categoryGroup.namefield is set to 'MOTORS_VEHICLE'.

If not specified, this value defaults to '0.0'. If this value is specified, the seller must also specify an hoursToDeposit value.

The deposit amount appears in the shipping, payment details and return policy sections of the View Item page.
See the Field Index to learn which calls use depositAmount.

hoursToDeposit ( int ) [0..1]
This integer value indicates the number of hours that a buyer has (after he/she commits to buy) to make an initial deposit to the seller as a down payment on a motor vehicle. Valid values are '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.
Note: The hoursToDeposit value is overridden if the seller has set the motor vehicle listing to require immediate payment. If the listing requires immediate payment, the buyer must pay the deposit immediately in order to be eligible to purchase the motor vehicle.
See the Field Index to learn which calls use hoursToDeposit.