eBay Merchant Data APIVersion 1225

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.

For sellers that are not onboarded for managed payments, deposits can only be paid with PayPal, so these sellers must make sure that PayPal is specified as one of the Item.PaymentMethods values (along with the other offline payment method values that will be options for full payment). For managed payments listings, the buyer may have other payment options for the deposit, and managed payment sellers never have to specify any electronic payment methods since eBay controls these payment methods, and not the seller.

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.