A successful call returns a paymentPolicyId, plus the Location response header contains the URI to the resource.
Policy instructions can be localized by providing a locale in the
Content-LanguageHTTP request header. For example:
Tip: For more on using business policies, see eBay business policies.
Types that use PaymentPolicyRequest
Calls that use PaymentPolicyRequest
Restriction: Currently, each policy can be set to only one categoryTypes value at a time.
For sellers who are not onboarded with eBay managed payments, a payment method must be set for the deposit in the paymentMethods array, and this payment method must be PayPal.
Note: The brands field is not applicable when setting a motor vehicle deposit. Set the paymentMethodType value to 'PayPal' and pass in the PayPal payment address in the recipientAccountReference container.
Sellers who are onboarded for managed payments do not need to specify a payment method for the deposit, as all electronic payment methods are managed by eBay.
Max length: 250
Note: This value is always returned if categoryTypes is set to
7 DAYS(the default)
7 DAYS(this value is supported by a compound type)
Sellers who are not onboarded with eBay managed payments have the following additional requirements:
- Offer PayPal as the only payment method
- Provide a valid PayPal payment email address in the paymentMethods.recipientAccountReference.referenceId field
Note: A limited number of sellers, on a limited number of eBay marketplaces, are currently opted-in to the eBay managed payments program. To view the eBay marketplaces where managed payments are currently supported, see the managed payments landing page.
Note: eBay will create a new payment policy for sellers who opt-in to the managed payments program.Max length: 64
Note: DO NOT USE THIS FIELD. Payment instructions are no longer supported by payment business policies.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.
Restriction: This container is not supported for sellers who opt-in to the managed payments program.
Max length: 1000
Because available electronic payments are strictly managed by eBay for sellers who are onboarded with eBay managed payments, this array is only needed by those sellers to specify offline payments (if applicable).
For sellers who are not onboarded with managed payments, at least one electronic payment method is required. For most marketplaces and categories, this payment method is 'PAYPAL'.
For a motor vehicle payment policy, the payment policy must specify at least one of the following as an offline payment method:
- CASH_ON_PICKUP (not available in the US)