GET/payment_policy
This method retrieves all the payment business policies configured for the marketplace you specify using the marketplace_id query parameter.
Input
Resource URI
This method is supported in Sandbox environment. To access the endpoint, just replace the api.ebay.com root URI with api.sandbox.ebay.com
URI parameters
| Parameter | Type | Description |
|---|---|---|
| marketplace_id | MarketplaceIdEnum | This query parameter specifies the eBay marketplace of the policies you want to retrieve. Occurrence: Required |
HTTP request headers
All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.
The table below shows additional HTTP request headers that are either required, conditionally required, or strongly recommended for this method. Other standard HTTP request headers- opens rest request components page (not in this table) can also be used, but they are optional.
| Header | Type | Description |
|---|---|---|
| Content-Language | string | Get the correct policies for a marketplace that supports multiple locales using the Content-Language request header. For example, get the policies for the French locale of the Canadian marketplace by specifying fr-CA for the Content-Language header. Likewise, target the Dutch locale of the Belgium marketplace by setting Content-Language: nl-BE. For details on header values, see HTTP request headers. Occurrence: Conditional |
OAuth scope
This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
See OAuth access tokens for more information.
Request payload
This call has no payload.
Request fields
This call has no field definitions.
Output
HTTP response headers
This call has no response headers.
Response payload
Response fields
| Output container/field | Type | Description |
|---|---|---|
| href | string | This field is for future use. Occurrence: Conditional |
| limit | integer | This field is for future use. Occurrence: Conditional |
| next | string | This field is for future use. Occurrence: Conditional |
| offset | integer | This field is for future use. Occurrence: Conditional |
| paymentPolicies | array of PaymentPolicy | A list of all of the seller's payment business policies defined for the specified marketplace. This array will be returned as empty if no payment business policies are defined for the specified marketplace. Occurrence: Always |
| paymentPolicies.categoryTypes | array of CategoryType | This container indicates whether the payment policy applies to motor vehicle listings, or if it applies to non-motor vehicle listings. Occurrence: Always |
| paymentPolicies.categoryTypes.default | boolean | Note: This field has been deprecated and is no longer used. Occurrence: Conditional |
| paymentPolicies.categoryTypes.name | CategoryTypeEnum | The category type to which the policy applies (motor vehicles or non-motor vehicles). Occurrence: Always |
| paymentPolicies.deposit | Deposit | This container is applicable only if the categoryTypes.name field is set to 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. Occurrence: Conditional |
| paymentPolicies.deposit.amount | Amount | This value indicates the initial deposit amount required from the buyer in order to purchase a motor vehicle. This value can be as high as $2,000.00 if immediate payment is not required, and up to $500.00 if immediate payment is required. Occurrence: Conditional |
| paymentPolicies.deposit.amount.currency | CurrencyCodeEnum | The base currency applied to the value field to establish a monetary amount. Occurrence: Conditional |
| paymentPolicies.deposit.amount.value | string | The monetary amount in the specified currency. Occurrence: Conditional |
| paymentPolicies.deposit.dueIn | TimeDuration | This value indicates the number of hours that the buyer has (after they commit to buy) to pay the initial deposit on a motor vehicle. Valid dueIn times are 24, 48, and 72 hours. Occurrence: Conditional |
| paymentPolicies.deposit.dueIn.unit | TimeDurationUnitEnum | These enum values represent the time measurement unit, such as Occurrence: Conditional |
| paymentPolicies.deposit.dueIn.value | integer | An integer that represents an amount of time, as measured by the time-measurement unit specified in the unit field. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods | array of PaymentMethod | This array is no longer applicable and should not be used since eBay now manages the electronic payment options available to buyers to pay the deposit. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods.brands | array of PaymentInstrumentBrandEnum | Note: This array is no longer applicable and should not be used. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods, including any credit card brands accepted. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods.paymentMethodType | PaymentMethodTypeEnum | This array is only applicable for listings supporting offline payment methods. See the PaymentMethodTypeEnum type for supported offline payment method enum values. If offline payments are enabled for the policy, provide at least one offline payment method. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods.recipientAccountReference | RecipientAccountReference | Note: This container is no longer applicable and should not be used. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods, including PayPal. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods.recipientAccountReference.referenceId | string | Note: DO NOT USE THIS FIELD. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods. Occurrence: Conditional |
| paymentPolicies.deposit.paymentMethods.recipientAccountReference.referenceType | RecipientAccountReferenceTypeEnum | Note: DO NOT USE THIS FIELD. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods. Occurrence: Conditional |
| paymentPolicies.description | string | 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. Occurrence: Conditional |
| paymentPolicies.fullPaymentDueIn | TimeDuration | 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) payment business policy must specify at least one of the following paymentMethods values for the final payment:
Occurrence: Conditional |
| paymentPolicies.fullPaymentDueIn.unit | TimeDurationUnitEnum | These enum values represent the time measurement unit, such as Occurrence: Conditional |
| paymentPolicies.fullPaymentDueIn.value | integer | An integer that represents an amount of time, as measured by the time-measurement unit specified in the unit field. Occurrence: Conditional |
| paymentPolicies.immediatePay | boolean | If this field is returned as
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. Occurrence: Always |
| paymentPolicies.marketplaceId | MarketplaceIdEnum | The ID of the eBay marketplace to which the payment business policy applies. Occurrence: Always |
| paymentPolicies.name | string | A seller-defined name for this payment policy. Names must be unique for policies assigned to the same marketplace. Occurrence: Always |
| paymentPolicies.paymentInstructions | string | 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. Occurrence: Conditional |
| paymentPolicies.paymentMethods | array of PaymentMethod | This container is returned to show the payment methods that are accepted for the payment business policy. Occurrence: Always |
| paymentPolicies.paymentMethods.brands | array of PaymentInstrumentBrandEnum | Note: This array is no longer applicable and should not be used. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods, including any credit card brands accepted. Occurrence: Conditional |
| paymentPolicies.paymentMethods.paymentMethodType | PaymentMethodTypeEnum | This array is only applicable for listings supporting offline payment methods. See the PaymentMethodTypeEnum type for supported offline payment method enum values. If offline payments are enabled for the policy, provide at least one offline payment method. Occurrence: Conditional |
| paymentPolicies.paymentMethods.recipientAccountReference | RecipientAccountReference | Note: This container is no longer applicable and should not be used. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods, including PayPal. Occurrence: Conditional |
| paymentPolicies.paymentMethods.recipientAccountReference.referenceId | string | Note: DO NOT USE THIS FIELD. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods. Occurrence: Conditional |
| paymentPolicies.paymentMethods.recipientAccountReference.referenceType | RecipientAccountReferenceTypeEnum | Note: DO NOT USE THIS FIELD. eBay now controls all electronic payment methods available for a marketplace, and a seller never has to specify any electronic payment methods. Occurrence: Conditional |
| paymentPolicies.paymentPolicyId | string | A unique eBay-assigned ID for a payment business policy. This ID is generated when the policy is created. Occurrence: Always |
| prev | string | This field is for future use. Occurrence: Conditional |
| total | integer | The total number of payment business policies retrieved in the result set. Occurrence: Always |
HTTP status codes
This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.
| Status | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad Request |
| 500 | Internal Server Error |
Error codes
For more on errors, plus the codes of other common errors, see Handling errors.
| Code | Domain | Category | Meaning |
|---|---|---|---|
| 20401 | API_ACCOUNT | REQUEST | Missing field {fieldName}. {additionalInfo} |
| 20403 | API_ACCOUNT | REQUEST | Invalid {fieldName}. {additionalInfo} |
| 20500 | API_ACCOUNT | APPLICATION | System error. |
| 20501 | API_ACCOUNT | APPLICATION | Service unavailable. Please try again in next 24 hours. |
Warnings
This call has no warnings.
Samples
New to making API calls? Please see Making a Call.
Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.
Sample 1: Get all Payment Policies
Sellers can create one or more payment policies for a particular marketplace. This call returns all the current payment policies for the specified marketplace.
Input
Specify the marketplace for the policies you want to retrieve using the marketplace_id query parameter.
GEThttps://api.ebay.com/sell/account/v1/payment_policy?marketplace_id=EBAY_US
Output
If the call is successful, eBay returns an HTTP status code of 200 OK and a complete list of the payment policies associated with the specified marketplace.