Skip to main content

This type is used by the paymentPolicy response container, a container which defines a seller's payment business policy for a specific marketplace.

Type that uses PaymentPolicy

PaymentPolicyResponse

Calls that use PaymentPolicy

Fields

Field
Type
Description
categoryTypes
array of CategoryType
This container indicates whether the fulfillment policy applies to motor vehicle listings, or if it applies to non-motor vehicle listings.
deposit
This container is applicable only if the categoryTypes.name field is set to MOTORS_VEHICLES, and is only returned if the seller requires an initial deposit on motor vehicles.

The container shows the amount due for the deposit and when it is due (within 1-3 days after commitment to purchase, unless the listing requires immediate payment).

Note: The due date that is specified in the deposit container will be overridden if the payment business policy requires immediate payment (in this case, for the deposit), and the buyer commits to purchasing the motor vehicle through a fixed-price listing or through the 'Buy it Now' option of an auction listing.

description
A seller-defined description of the payment policy. This description is only for the seller's use, and is not exposed on any eBay pages.

Max length: 250
fullPaymentDueIn
This container applies to motor vehicles listings only and indicates when a final payment for the vehicle is due. This value is always returned if categoryTypes is set to MOTORS_VEHICLES.

This container 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. The period starts when the buyer commits to buy. The valid values, as specified with TimeDuration, are:
  • 3 DAYS
  • 7 DAYS (the default)
  • 10 DAYS
  • 14 DAYS
A MOTORS_VEHICLES) payment business policy must specify at least one of the following paymentMethods values for the final payment:
  • CASH_ON_PICKUP

    Note: This payment method is only available to sellers outside the US.
  • CASHIER_CHECK
  • MONEY_ORDER
  • PERSONAL_CHECK
immediatePay
If this field is returned as true, immediate payment is required from the buyer for:
  • A fixed-price item
  • An auction item where the buyer uses the 'Buy it Now' option
  • A deposit for a motor vehicle listing

It is possible for the seller to set this field as true in the payment business policy, but it will not apply in some scenarios. For example, immediate payment is not applicable for auction listings that have a winning bidder, for buyer purchases that involve the Best Offer feature, or for transactions that happen offline between the buyer and seller.
marketplaceId
The ID of the eBay marketplace to which the payment business policy applies.
name
A seller-defined name for this fulfillment policy. Names must be unique for policies assigned to the same marketplace.

Max length: 64
paymentInstructions
Although this field may be returned for some older payment business policies, payment instructions are no longer supported by payment business policies. If this field is returned, it can be ignored and these payment instructions will not appear in any listings that use the corresponding business policy.

Max length: 1000
paymentMethods
array of PaymentMethod
This container is returned to show the payment methods that are accepted for the payment business policy.

Sellers do not have to specify any electronic payment methods for listings, so this array will often be returned empty unless the payment business policy is intended for motor vehicle listings or other items in categories where offline payments are required or supported.
paymentPolicyId
A unique eBay-assigned ID for a payment business policy. This ID is generated when the policy is created.