Getting Started

Before you can publish product offers on eBay through EcartAPI, your seller account must have four things in place. This page walks through each one.

Prerequisites

1. Payoneer Account

eBay requires a linked Payoneer account for seller payouts. Make sure your eBay account is connected to a verified Payoneer account before attempting to publish any offers.

2. Seller Program Enrollment

Enroll your account in the SELLING_POLICY_MANAGEMENT program. This unlocks the ability to create and manage custom fulfillment, payment, and return policies through the API.

Check current enrollment:

GET /api/v1/policies/sellerPrograms

→ API Reference: Get SellerPrograms

Enroll:

POST /api/v1/policies/sellerPrograms
{
  "policy": {
    "programType": "SELLING_POLICY_MANAGEMENT"
  }
}

→ API Reference: Create SellerPrograms

3. Policies

You must have at least one of each policy type created for your target marketplace before publishing offers:

• Fulfillment policy — shipping method, handling time, service options
• Payment policy — accepted payment methods
• Returns policy — return window, who pays for return shipping

Create each via:

POST /api/v1/policies/fulfillments/{marketplaceId}
POST /api/v1/policies/payments/{marketplaceId}
POST /api/v1/policies/returns/{marketplaceId}

→ See Policies & Locations for full details and API references.

4. Location

At least one inventory location with a valid postal code is required to publish offers. The merchantLocationKey you assign at creation becomes the location's permanent ID.

POST /api/v2/locations

→ API Reference: Create Location

Marketplace IDs

All eBay operations that are marketplace-specific require a marketplaceId. Use the underscore format — EBAY_US, not EBAY-US.

Each marketplace is an independent integration. Policies and locations created for EBAY_US do not carry over to EBAY_GB. Connect each marketplace separately via OAuth and repeat the setup steps for each one.

First-time seller setup flow

1. GET  /api/v1/policies/sellerPrograms               — verify enrollment status
2. POST /api/v1/policies/sellerPrograms               — enroll in SELLING_POLICY_MANAGEMENT
3. POST /api/v1/policies/fulfillments/{marketplaceId} — create fulfillment policy
4. POST /api/v1/policies/payments/{marketplaceId}     — create payment policy
5. POST /api/v1/policies/returns/{marketplaceId}      — create returns policy
6. POST /api/v2/locations                             — create inventory location

Once these are in place, you're ready to create products and publish offers. Continue with Products & Variants.