eBay

Overview

Connect your users to eBay for marketplace selling, inventory management, order fulfillment, and account data.

Property	Value
Provider ID	ebay
Category	E-commerce
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create an eBay OAuth App

Go to the eBay Developer Portal

Navigate to developer.ebay.com/my/keys and sign in.

Create a new application

Click Get a Keyset and fill in the application details.

Register the callback URL and get its RuName

Open User Tokens, then Get a Token from eBay via Your Application. The first time, click You have no Redirect URLs. Click here to add one, confirm the legal address, and click Continue to create RuName. Enter a Display Title and Privacy Policy URL, paste the Alter callback URL from the Developer Portal into Auth Accepted URL, and save. eBay assigns the registration a RuName (Redirect URL name, for example Davy_Developer-DavyDeve-DavysT-euiukxwt). eBay issues one RuName per environment, so copy the production RuName: eBay requires the RuName, not the URL, in every authorization request, and Alter sends it for you once it is entered below.

Get credentials

Copy the Client ID (App ID) and Client Secret (Cert ID).

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add eBay provider

Go to OAuth Providers > Add Provider > eBay.

Enter credentials

• Client ID: Paste your eBay App ID
• Client Secret: Paste your eBay Cert ID
• RuName: Paste the Redirect URL name from Step 1. The field is required for eBay; the configuration cannot be saved without it.

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
https://api.ebay.com/oauth/api_scope	Access to general eBay API endpoints
https://api.ebay.com/oauth/api_scope/sell.marketing	Access to selling marketing tools and promotions
https://api.ebay.com/oauth/api_scope/sell.inventory	Access to inventory and listing management
https://api.ebay.com/oauth/api_scope/sell.fulfillment	Access to order fulfillment and shipping
https://api.ebay.com/oauth/api_scope/sell.account	Access to seller account settings and policies
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly	View the user’s basic eBay account information (immutable user ID)

Notes

• eBay uses full URL strings as scope values rather than short names.
• eBay does not accept the callback URL as redirect_uri; it expects the RuName assigned to the registered Auth Accepted URL, and with the URL in its place eBay rejects the request before any consent screen. Enter the RuName in the eBay configuration (Developer Portal, or alter providers create --provider ebay --redirect-uri-alias <RuName> with the CLI; switching an Alter-managed eBay configuration to custom credentials requires it too) and Alter sends it in every authorization request and token exchange.
• eBay’s sandbox environment is not supported by this integration. Use a production keyset and its production RuName.
• See the eBay OAuth documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
issueRefund	payment	POST	/order/{order_id}/issue_refund
acceptPaymentDispute	payment	POST	/payment_dispute/{payment_dispute_id}/accept
contestPaymentDispute	write	POST	/payment_dispute/{payment_dispute_id}/contest
addEvidence	write	POST	/payment_dispute/{payment_dispute_id}/add_evidence
updateEvidence	write	POST	/payment_dispute/{payment_dispute_id}/update_evidence
uploadEvidenceFile	write	POST	/payment_dispute/{payment_dispute_id}/upload_evidence_file
createShippingFulfillment	write	POST	/order/{orderId}/shipping_fulfillment
fetchEvidenceContent	read	GET	/payment_dispute/{payment_dispute_id}/fetch_evidence_content
getActivities	read	GET	/payment_dispute/{payment_dispute_id}/activity
getOrder	read	GET	/order/{orderId}
getOrders	read	GET	/order
getPaymentDispute	read	GET	/payment_dispute/{payment_dispute_id}
getPaymentDisputeSummaries	read	GET	/payment_dispute_summary
getShippingFulfillment	read	GET	/order/{orderId}/shipping_fulfillment/{fulfillmentId}
getShippingFulfillments	read	GET	/order/{orderId}/shipping_fulfillment