account APIv1.6.3


Complex type that that gets populated with a response containing a payment policy.

Types that use SetPaymentPolicyResponse

Not used by any types

Calls that use SetPaymentPolicyResponse


array of CategoryType
The CategoryTypeEnum value to which this policy applies. This container is used to discern accounts that sell motor vehicles from those that do not.

Restriction: Currently, each policy can be set to only one categoryTypes value at a time.
This container is only returned if the seller just created or updated a Motor Vehicles payment policy and requires buyers to pay an initial deposit after they commit to buying a motor vehicle.

  • This container is applicable only if the field is set to MOTORS_VEHICLES.
An optional seller-defined description of the payment policy.
The number of days (after the buyer commits to buy) that a buyer has to pay the remaining balance of a motor vehicle transaction. Sellers can set this value to 3, 7, 10, or 14 days.

Note: This value is always returned if categoryTypes is set to MOTORS_VEHICLES.

The value returned in this field will reflect the value set by the seller in the immediatePay request field. A value of true indicates that immediate payment is required from the buyer for a fixed-price item or for an auction item where the buyer is using the 'Buy it Now' option.

It is possible for the seller to set this field as true in the payment 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.
The ID of the eBay marketplace to which this payment policy applies.
A user-defined name for this payment policy. Names must be unique for policies assigned to the same marketplace.Max length: 64

Note: NO LONGER SUPPORTED. 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.

A free-form string field that allows sellers to add detailed payment instructions to their listings. The payment instructions appear on eBay's View Item and Checkout pages.

eBay recommends sellers use this field to clarify payment policies for motor vehicle listings on eBay Motors. For example, sellers can include the specifics on the deposit (if required), pickup/delivery arrangements, and full payment details on the vehicle.

The field allows only 500 characters as input, but due to the way the eBay web site UI treats characters, this field can return more than 500 characters in the response. For example, characters like & and ' (ampersand and single quote) count as 5 characters each.

Note: This field applies only to offline payment types.

Restriction: This container is not supported for sellers who are enabled for the managed payments program, except in the case of Motors listings.

Max length: 1000
array of PaymentMethod
This array shows the available payment methods that the seller has set for the payment policy.

For sellers who are onboarded with eBay managed payments, this array is usually returned as empty because managed payments sellers do not have to specify electronic payment methods. For listings where an offline payment is applicable, a managed payments seller will have to specify one or more offline payment methods.

For sellers who are not onboarded for managed payments, at least one payment method is required.
A unique eBay-assigned ID for a payment policy. This ID is generated when the policy is created.
array of ErrorDetailV3
A list of warnings related to request. This field normally returns empty, which indicates the request did not generate any warnings.