eBay Trading APIVersion 1235

PaymentDetailsType

Type defining the PaymentDetails container, which is used by the seller to specify the amount of the initial deposit, and the due dates for the deposit and the full payment for a motor vehicle listing.

Note: The seller may not use the PaymentDetails container if selling a motor vehicle through a Classified Ad listing. If it is used in a Trading call, it will be dropped and the seller will get a warning that it was dropped. For a Classified Ad listing, the buyer and seller directly discuss amongst themselves any details on a deposit, or due dates for a deposit and full balance. eBay will not be involved in this process for a Classified Ad listing.

Type that uses PaymentDetailsType:

Calls that use PaymentDetailsType:

Fields

DaysToFullPayment ( int ) [0..1]
This field is used to set the due date (in days) for the buyer to pay off the full balance of the motor vehicle. The "clock starts" on the full payment due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are 3, 7 (default), 10, and 14 days.

The seller must specify one or more of the following offline payment methods in the listing. The buyer will be expected to use one of these payment method options to pay the full balance of the motor vehicle.
  • CashOnPickup
  • MOCC (money order or cashier's check)
  • PersonalCheck
See the Field Index to learn which calls use DaysToFullPayment.

DepositAmount ( AmountType (double) ) [0..1]
This dollar value indicates the amount of the initial deposit on the vehicle required from the buyer.

If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the deposit will be required immediately, and the HoursToDeposit field (if set) will not be applicable. If immediate payment is required for a motor vehicle deposit, the value input into this field cannot exceed '500.0', or an error will occur.

If there is no immediate payment requirement set for the listing the deposit will be required in 24, 48, or 72 hours after commitment to purchase (see the HoursToDeposit field). If immediate payment is not required for a motor vehicle deposit, the value input into this field cannot exceed '2000.0', or an error will occur.

If this field is not included in an Add/Revise call, its value defaults to '0.0', which would technically mean that a deposit is not required, even if the DepositType and HoursToDeposit fields were included.

Motor vehicle deposit details will be shown to prospective buyers in the listing. The available payment methods for the deposit will be shown on the checkout page once the buyer clicks the the Buy It Now button.

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]
In order for a seller to require a motor vehicle deposit from a buyer, this field must be included and set to OtherMethod. Otherwise, the field will default to None and a deposit will not be required.
See the Field Index to learn which calls use DepositType.

HoursToDeposit ( int ) [0..1]
This field is used to set the due date (in hours) for the motor vehicle deposit. The deposit amount is specified in the DepositAmount field. The "clock starts" on the deposit due date as soon as the buyer commits to buying the vehicle by clicking the Buy It Now button, by winning the auction, or by the seller accepting that buyer's Best Offer/counteroffer. The three supported values here are 24, 48 (default), and 72 hours.

Note: If the immediate payment requirement is set for the listing (see Item.AutoPay description), and the listing qualifies for immediate payment (e.g. the Buy It Now button is used), the HoursToDeposit field will not be applicable, since the buyer will be required to pay any deposit amount immediately (and not within 1, 2 or 3 days).
See the Field Index to learn which calls use HoursToDeposit.