nOfert API

Bootstrap endpoint for mobile apps. Returns store name, currency, payment methods, categories, feature flags, and social login availability. Call once on app launch.

curl "https://nofert.net/api/v1/app/config"

{
  "store_name": "Nofert",
  "currency": "EUR",
  "currency_symbol": "€",
  "payment_methods": ["stripe", "paypal", "cod"],
  "features": {
    "reviews": true,
    "wishlist": true,
    "blog": true
  },
  "social_login": {
    "google": true,
    "facebook": true
  },
  "categories": [
    { "id": 1, "name": "Electronics", "slug": "electronics" }
  ]
}

Homepage data for mobile apps. Returns promotional banners, featured products, new arrivals, on-sale items, flash deals, and top categories — everything needed to render the home screen.

curl "https://nofert.net/api/v1/app/home"

{
  "banners": [
    { "id": 1, "title": "Summer Sale", "image": "https://...", "link": "/deals" }
  ],
  "featured": [
    { "id": 42, "name": "Running Shoes", "price": "59.99", ... }
  ],
  "new_arrivals": [ ... ],
  "on_sale": [ ... ],
  "flash_deals": [ ... ],
  "categories": [
    { "id": 1, "name": "Electronics", "image": "https://...", "product_count": 142 }
  ]
}

List and filter approved products. Supports full-text search, price ranges, category, stock status, and bulk ID lookup.

Query Parameters

curl "https://nofert.net/api/v1/products?search=shoes&sort=price_asc&per_page=5"

# Bulk lookup
curl "https://nofert.net/api/v1/products?ids=42,87,103"

{
  "data": [
    {
      "id": 42,
      "name": "Running Shoes",
      "slug": "running-shoes",
      "price": "59.99",
      "sale_price": "49.99",
      "quantity": 100,
      "rating": 4.8,
      "category": { "id": 3, "name": "Footwear" },
      "vendor": { "name": "Sport Store" }
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "total": 48,
    "currency": "EUR",
    "currency_symbol": "€"
  }
}

Get a single product with full details — all images, variants, and reviews.

curl "https://nofert.net/api/v1/products/42"

{
  "data": {
    "id": 42,
    "name": "Running Shoes",
    "description": "...",
    "price": "59.99",
    "sale_price": "49.99",
    "quantity": 100,
    "images": [ { "url": "https://..." } ],
    "variants": [
      { "id": 7, "name": "Blue / Size 42", "price": "59.99" }
    ],
    "reviews_count": 24,
    "rating": 4.8
  }
}

Returns up to 12 related products from the same category or vendor. Results are randomized.

curl "https://nofert.net/api/v1/products/42/related"

{
  "data": [
    {
      "id": 88,
      "name": "Trail Sneakers",
      "price": "74.99",
      "vendor": { "name": "Sport Store" }
    }
  ]
}

Public Q&A for a product. Returns answered questions with pagination.

curl "https://nofert.net/api/v1/products/42/questions"

Ask a question about a product. Questions are pending until vendor/admin answers.

curl -X POST "https://nofert.net/api/v1/products/42/questions" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "question=Does this come with a warranty?"

Approved customer reviews for a product, including average rating and star-by-star breakdown.

curl "https://nofert.net/api/v1/products/42/reviews?sort=helpful&per_page=5"

Submit a review for a product. Requires a delivered purchase. Reviews are pending until admin approval. Supports image uploads.

curl -X POST "https://nofert.net/api/v1/products/42/reviews" \
  -H "Authorization: Bearer nofert_u_..." \
  -F "rating=5" \
  -F "comment=Excellent quality!" \
  -F "images[]=@photo.jpg"

Delete your own review.

curl -X DELETE "https://nofert.net/api/v1/user/reviews/19" \
  -H "Authorization: Bearer nofert_u_..."

Type-ahead search suggestions. Returns up to 8 matching products by name. Use for autocomplete in search bars.

curl "https://nofert.net/api/v1/search/suggestions?q=phone"

{
  "data": [
    {
      "id": 12,
      "name": "iPhone 15 Pro",
      "slug": "iphone-15-pro",
      "category": "Phones"
    },
    {
      "id": 45,
      "name": "Phone Case Clear",
      "slug": "phone-case-clear",
      "category": "Accessories"
    }
  ]
}

Fetch product details for recently viewed items. The client tracks viewed product IDs locally and sends them to get full details.

curl "https://nofert.net/api/v1/recently-viewed?ids=159,150,140"

Returns the full category tree with product counts at every level.

curl "https://nofert.net/api/v1/categories"

{
  "data": [
    {
      "id": 1,
      "name": "Electronics",
      "slug": "electronics",
      "product_count": 142,
      "children": [
        { "id": 5, "name": "Phones", "product_count": 48 }
      ]
    }
  ]
}

Paginated list of approved vendors. Filter by name or verification status.

curl "https://nofert.net/api/v1/vendors?verified=true&per_page=10"

Get a vendor's full profile, bio, ratings, and their most recent products.

curl "https://nofert.net/api/v1/vendors/my-shop"

Reviews for all products sold by this vendor, with aggregate stats (total count and average rating).

curl "https://nofert.net/api/v1/vendors/my-shop/reviews?per_page=5"

{
  "data": [
    {
      "id": 1,
      "rating": 5,
      "comment": "Great seller!",
      "user": "Jane D.",
      "product": "Running Shoes",
      "created_at": "2026-02-20T10:00:00Z"
    }
  ],
  "meta": {
    "total_reviews": 24,
    "average_rating": 4.6,
    "current_page": 1,
    "last_page": 5
  }
}

List published blog posts with excerpts (no full content). Filterable by category.

curl "https://nofert.net/api/v1/blog?per_page=5"

Get a single blog post with full HTML content.

curl "https://nofert.net/api/v1/blog/my-post-slug"

Returns active flash deals with products and active promotional banners.

curl "https://nofert.net/api/v1/deals"

Validate a coupon code and get discount details. Rate limited to 30 req/min to prevent brute-force.

curl -X POST "https://nofert.net/api/v1/coupons/validate" \
  -H "Content-Type: application/json" \
  -d '{ "code": "SUMMER20" }'

{
  "valid": true,
  "code": "SUMMER20",
  "type": "percentage",
  "value": 20,
  "min_order": 50
}

Create a pending order and receive a checkout_url — redirect your customer there to complete payment on nOfert.

curl -X POST "https://nofert.net/api/v1/orders" \
  -H "Authorization: Bearer nofert_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "Jane Doe",
    "customer_email": "jane@example.com",
    "shipping_address": "123 Main St",
    "shipping_city": "Pristina",
    "shipping_country": "Kosovo",
    "items": [
      { "product_id": 42, "quantity": 2 },
      { "product_id": 7, "variant_id": 15, "quantity": 1 }
    ]
  }'

{
  "data": {
    "order_number": "ORD-20260219-XK42",
    "status": "pending",
    "payment_status": "pending",
    "total": 169.97,
    "currency": "EUR"
  },
  "checkout_url": "https://nofert.net/order/ORD-20260219-XK42/confirmation",
  "message": "Order created. Redirect your customer to checkout_url."
}

Get the current status and details of an order created through your API key.

curl "https://nofert.net/api/v1/orders/ORD-20260219-XK42" \
  -H "Authorization: Bearer nofert_your_key"

{
  "data": {
    "order_number": "ORD-20260219-XK42",
    "status": "shipped",
    "payment_status": "paid",
    "total": 169.97,
    "tracking_number": "1Z999AA1",
    "tracking_carrier": "DHL",
    "items": [ ... ]
  }
}

Returns information about the current API key — great for verifying your key works and checking your rate limit status.

curl "https://nofert.net/api/v1/me" \
  -H "Authorization: Bearer nofert_your_key"

{
  "name": "My Mobile App",
  "owner": "Herolind",
  "permissions": ["all"],
  "rate_limit": "1000/hour",
  "last_used_at": "2026-02-19T21:00:00.000Z",
  "expires_at": null
}

Exchange email and password for a 30-day user token. Rate-limited to 10 attempts per minute per IP.

curl -X POST "https://nofert.net/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "secret",
    "device_name": "My App"
  }'

{
  "token": "nofert_u_4a8b2c...",
  "expires_at": "2026-03-20T10:00:00.000Z",
  "user": {
    "id": 5,
    "name": "Jane Doe",
    "email": "user@example.com",
    "role": "buyer"
  }
}

Create a new buyer account and receive a 30-day user token.

curl -X POST "https://nofert.net/api/v1/auth/register" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane",
    "email": "jane@example.com",
    "password": "secret123",
    "password_confirmation": "secret123"
  }'

Send a password reset link to the user's email.

curl -X POST "https://nofert.net/api/v1/auth/forgot-password" \
  -d "email=jane@example.com"

Reset a user's password using the token from the email link. Revokes all existing user tokens.

curl -X POST "https://nofert.net/api/v1/auth/reset-password" \
  -H "Content-Type: application/json" \
  -d '{ "email": "jane@example.com", "token": "abc123...", "password": "newpass!", "password_confirmation": "newpass!" }'

Social login via Google or Facebook. Exchange a provider access token for a user token. Creates the account automatically on first login.

curl -X POST "https://nofert.net/api/v1/auth/social/google" \
  -H "Content-Type: application/json" \
  -d '{ "access_token": "ya29.a0AfH6SM..." }'

Permanently revokes the current user token.

curl -X POST "https://nofert.net/api/v1/auth/logout" \
  -H "Authorization: Bearer nofert_u_4a8b2c..."

# Response: { "message": "Logged out successfully." }

Extend the current token's expiry by 30 days.

curl -X POST "https://nofert.net/api/v1/auth/refresh" \
  -H "Authorization: Bearer nofert_u_4a8b2c..."

# Response: { "message": "Token refreshed.", "expires_at": "2026-04-20T..." }

Returns the authenticated user's profile.

curl "https://nofert.net/api/v1/user" \
  -H "Authorization: Bearer nofert_u_..."

Update the authenticated user's profile fields. Only send the fields you want to change.

curl -X PUT "https://nofert.net/api/v1/user" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "phone=+38349123456" -d "city=Pristina"

Change the user's password. Requires the current password for verification.

curl -X PUT "https://nofert.net/api/v1/user/password" \
  -H "Authorization: Bearer nofert_u_..." \
  -H "Content-Type: application/json" \
  -d '{ "current_password": "old", "password": "new123!", "password_confirmation": "new123!" }'

Returns the authenticated user's order history. Filterable by status.

curl "https://nofert.net/api/v1/user/orders?status=shipped" \
  -H "Authorization: Bearer nofert_u_..."

Cancel a pending or processing order. Orders that are already shipped/delivered cannot be cancelled.

curl -X POST "https://nofert.net/api/v1/user/orders/ORD-ABC123/cancel" \
  -H "Authorization: Bearer nofert_u_..."

Request a return for a delivered order. Only one open return request per order.

curl -X POST "https://nofert.net/api/v1/user/orders/ORD-ABC123/return" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "reason=Item arrived damaged"

Returns full invoice data as JSON — items with variants, shipping address, tax, discount, and store info. Designed for mobile apps to render invoices natively.

curl "https://nofert.net/api/v1/user/orders/ORD-ABC123/invoice" \
  -H "Authorization: Bearer nofert_u_..."

Returns order tracking timeline with status steps. Each step shows whether it's completed and when. Includes tracking number and carrier if available.

curl "https://nofert.net/api/v1/user/orders/ORD-ABC123/tracking" \
  -H "Authorization: Bearer nofert_u_..."

{
  "order_number": "ORD-ABC123",
  "current_status": "shipped",
  "tracking_number": "1Z999AA10123456784",
  "tracking_carrier": "UPS",
  "timeline": [
    { "status": "placed", "label": "Order Placed", "completed": true, "date": "2026-02-25T10:00:00Z" },
    { "status": "processing", "label": "Processing", "completed": true, "date": "2026-02-25T14:00:00Z" },
    { "status": "shipped", "label": "Shipped", "completed": true, "date": "2026-02-26T09:00:00Z" },
    { "status": "delivered", "label": "Delivered", "completed": false, "date": null }
  ]
}

Permanently delete the authenticated user's account. Requires password verification. You cannot delete your account while you have active (pending/processing/shipped) orders.

What happens: API tokens revoked, push tokens deleted, personal data anonymized (name → "Deleted User", email → deleted_ID@removed.invalid), account soft-deleted.

curl -X DELETE "https://nofert.net/api/v1/user" \
  -H "Authorization: Bearer nofert_u_..." \
  -H "Content-Type: application/json" \
  -d '{ "password": "your-current-password" }'

List all conversations. Returns the latest message from each chat partner, sorted by most recent.

curl "https://nofert.net/api/v1/user/messages" \
  -H "Authorization: Bearer nofert_u_..."

Get message history with a specific user. Use ?after= for efficient polling — only returns messages newer than the given timestamp.

curl "https://nofert.net/api/v1/user/messages/42?after=2026-02-27T10:00:00Z" \
  -H "Authorization: Bearer nofert_u_..."

Send a message to another user. Supports up to 5 file attachments (images, documents — max 5MB each). Rate limited to 30 requests per minute.

curl -X POST "https://nofert.net/api/v1/user/messages/42" \
  -H "Authorization: Bearer nofert_u_..." \
  -F "message=Hello, is this product still available?" \
  -F "attachments[]=@photo.jpg"

Send a typing indicator. The indicator expires after 30 seconds. Call this periodically while the user is typing.

curl -X POST "https://nofert.net/api/v1/user/messages/42/typing" \
  -H "Authorization: Bearer nofert_u_..."

Get cart contents with product details, images, subtotal, and item count.

curl "https://nofert.net/api/v1/cart" \
  -H "Authorization: Bearer nofert_u_..."

{
  "data": [
    {
      "key": "42:0",
      "product_id": 42,
      "product_name": "Running Shoes",
      "variant_id": null,
      "quantity": 2,
      "price": 49.99,
      "total": 99.98,
      "image": "https://...",
      "vendor": "Sport Store"
    }
  ],
  "meta": {
    "item_count": 1,
    "subtotal": 99.98,
    "currency": "EUR"
  }
}

Add an item to cart. Quantity is automatically capped at available stock.

curl -X POST "https://nofert.net/api/v1/cart" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "product_id=42" -d "quantity=2"

Update item quantity. Key format: productId:variantId.

curl -X PATCH "https://nofert.net/api/v1/cart/42:0" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "quantity=3"

Remove a single item from cart.

curl -X DELETE "https://nofert.net/api/v1/cart/42:0" \
  -H "Authorization: Bearer nofert_u_..."

Clear the entire cart.

curl -X DELETE "https://nofert.net/api/v1/cart" \
  -H "Authorization: Bearer nofert_u_..."

List all products in the user's wishlist with details and pagination.

curl "https://nofert.net/api/v1/user/wishlist" \
  -H "Authorization: Bearer nofert_u_..."

Add a product to wishlist. Adding a product that's already in the wishlist returns 200 (no duplicates).

curl -X POST "https://nofert.net/api/v1/user/wishlist" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "product_id=42"

Remove a product from wishlist.

curl -X DELETE "https://nofert.net/api/v1/user/wishlist/42" \
  -H "Authorization: Bearer nofert_u_..."

List all saved addresses. Default address appears first.

curl "https://nofert.net/api/v1/user/addresses" \
  -H "Authorization: Bearer nofert_u_..."

Create a new saved address. Setting is_default: true will unset any existing default.

curl -X POST "https://nofert.net/api/v1/user/addresses" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "label=Home" -d "name=Jane Doe" -d "phone=+38349123456" \
  -d "address=Rr. UCK nr 5" -d "city=Pristina" -d "country=Kosovo" \
  -d "is_default=1"

Update an existing address. Send only the fields you want to change.

curl -X PUT "https://nofert.net/api/v1/user/addresses/1" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "city=Deqan" -d "zip=30000"

Delete a saved address.

curl -X DELETE "https://nofert.net/api/v1/user/addresses/1" \
  -H "Authorization: Bearer nofert_u_..."

List notifications with unread count in meta. Paginated.

curl "https://nofert.net/api/v1/user/notifications" \
  -H "Authorization: Bearer nofert_u_..."

# Response meta includes: "unread_count": 3

Mark a single notification as read.

curl -X POST "https://nofert.net/api/v1/user/notifications/abc-123/read" \
  -H "Authorization: Bearer nofert_u_..."

Mark all notifications as read at once.

curl -X POST "https://nofert.net/api/v1/user/notifications/read-all" \
  -H "Authorization: Bearer nofert_u_..."

Create an order from the user's cart. Returns payment details for the native SDK to complete.

curl -X POST "https://nofert.net/api/v1/checkout" \
  -H "Authorization: Bearer nofert_u_..." \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method": "stripe",
    "shipping_address_id": 1
  }'

{
  "order_number": "ORD-20260225-XK42",
  "payment_method": "stripe",
  "client_secret": "pi_3abc_secret_xyz",
  "total": 99.98,
  "currency": "eur"
}

Get available shipping methods and costs for the user's cart and address.

curl -X POST "https://nofert.net/api/v1/checkout/shipping-rates" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "shipping_address_id=1"

Confirm a Stripe payment after the native SDK completes. Call this after confirmPayment() succeeds in the Stripe mobile SDK.

curl -X POST "https://nofert.net/api/v1/payment/stripe/confirm" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "payment_intent_id=pi_3abc123"

Confirm a PayPal payment after the user approves. Call this after the PayPal SDK flow completes.

curl -X POST "https://nofert.net/api/v1/payment/paypal/confirm" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "paypal_order_id=4MW805572N795704B"

List all registered push tokens for the authenticated user.

curl "https://nofert.net/api/v1/user/push-tokens" \
  -H "Authorization: Bearer nofert_u_..."

Register a new push token. If the token already exists, it updates the platform/device info.

curl -X POST "https://nofert.net/api/v1/user/push-tokens" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "token=fcm_abc123..." -d "platform=android" -d "device_name=Pixel 8"

Unregister a push token (e.g. on logout or app uninstall).

curl -X DELETE "https://nofert.net/api/v1/user/push-tokens/fcm_abc123" \
  -H "Authorization: Bearer nofert_u_..."

Get the user's current preferences. Returns defaults if none have been set.

curl "https://nofert.net/api/v1/user/preferences" \
  -H "Authorization: Bearer nofert_u_..."

{
  "push_orders": true,
  "push_promotions": true,
  "push_messages": true,
  "email_orders": true,
  "email_promotions": false,
  "language": "en"
}

Update preferences. Only send the fields you want to change.

curl -X PUT "https://nofert.net/api/v1/user/preferences" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "push_promotions=false" -d "language=sq"

List the user's return requests with order details and status.

curl "https://nofert.net/api/v1/user/returns" \
  -H "Authorization: Bearer nofert_u_..."

{
  "data": [
    {
      "id": 1,
      "order_number": "ORD-20260219-XK42",
      "reason": "Item arrived damaged",
      "status": "pending",
      "created_at": "2026-02-20T10:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 2
  }
}

List the user's support tickets. Filterable by status.

curl "https://nofert.net/api/v1/user/tickets?status=open" \
  -H "Authorization: Bearer nofert_u_..."

Create a support ticket. Rate limited to 5 per minute.

curl -X POST "https://nofert.net/api/v1/user/tickets" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "subject=Order not received" \
  -d "message=My order ORD-123 has not arrived" \
  -d "category=order_issue" -d "priority=medium"

View ticket details including message and admin reply.

curl "https://nofert.net/api/v1/user/tickets/1" \
  -H "Authorization: Bearer nofert_u_..."

Reply to a ticket. If the ticket was resolved, it will be re-opened. Closed tickets cannot be replied to.

curl -X POST "https://nofert.net/api/v1/user/tickets/1/reply" \
  -H "Authorization: Bearer nofert_u_..." \
  -d "message=Any update on this?"

Returns dashboard overview: order counts by status, total revenue, product stats, and recent orders.

curl "https://nofert.net/api/v1/vendor/dashboard" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

List all products belonging to the authenticated vendor. Supports pagination, search, and status filtering.

curl "https://nofert.net/api/v1/vendor/products?status=active&per_page=20" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Create a new product. Accepts name, description, price, category, stock, variants, and other product fields.

Get full details of a single product owned by the vendor.

Update an existing product. All updatable fields accepted.

Delete a product. Soft-deletes so order history is preserved.

Upload images for a product. Accepts multipart file uploads.

Delete a specific image from a product.

List all orders for the vendor. Supports filtering by status, date range, and pagination.

curl "https://nofert.net/api/v1/vendor/orders?status=processing&per_page=20" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Get detailed order information including items, shipping address, and payment details.

Update order status. Valid transitions are enforced (e.g., processing → shipped → delivered).

Add or update tracking information (carrier, tracking number, tracking URL).

Returns earnings summary: total earnings, available balance, pending payouts, and recent transactions.

curl "https://nofert.net/api/v1/vendor/earnings" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

List all payout requests with status (pending, approved, paid, rejected).

Request a new payout. Specify amount and payout method. Subject to minimum payout threshold.

Get the vendor's shop profile including shop name, description, logo, banner, and settings.

curl "https://nofert.net/api/v1/vendor/profile" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Update shop profile fields: name, description, logo, banner, social links, policies.

Toggle vacation mode on/off. When active, products are hidden from the storefront.

List all coupons created by the vendor with usage stats.

curl "https://nofert.net/api/v1/vendor/coupons" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Create a new coupon. Fields: code, type (percentage/fixed), value, min_order, max_uses, expires_at.

Get details of a specific coupon including usage history.

Update an existing coupon's settings.

Delete a coupon. Active coupons in use will be invalidated.

List all questions on the vendor's products. Filter by answered/unanswered status.

curl "https://nofert.net/api/v1/vendor/questions?status=unanswered" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Post an answer to a buyer's question. The answer will be visible on the product page.

List all reviews on the vendor's products. Supports filtering by rating and reply status.

curl "https://nofert.net/api/v1/vendor/reviews?per_page=20" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Post a reply to a buyer's review. One reply per review.

List all return requests for the vendor's orders. Supports status filtering.

curl "https://nofert.net/api/v1/vendor/returns?status=pending" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Get detailed return request information including photos and buyer reason.

Approve a return request. Triggers refund processing.

Reject a return request with a reason.

List all shipping zones with their rates.

curl "https://nofert.net/api/v1/vendor/shipping/zones" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Create a new shipping zone with name and country list.

Update a shipping zone.

Delete a shipping zone and all its rates.

Add a shipping rate to a zone (flat, weight-based, or order-total-based).

Update a shipping rate.

Delete a shipping rate from a zone.

Returns wallet balance and recent transaction history.

curl "https://nofert.net/api/v1/vendor/wallet/balance" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Top up wallet via Stripe payment. Returns a Stripe client_secret for native SDK flow.

Returns onboarding progress: completed steps, current step, and remaining requirements.

curl "https://nofert.net/api/v1/vendor/onboarding/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Submit Step 1: Shop information (name, description, category).

Submit Step 2: Business details (address, tax ID, phone).

Submit Step 3: Payment setup (bank account or Stripe Connect).

Submit Step 4: Verification documents upload and agreement acceptance.

Returns dropshipping dashboard: imported product count, sync status, and recent activity.

curl "https://nofert.net/api/v1/vendor/dropshipping/dashboard" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Search AliExpress products by keyword, category, or price range.

Preview full product details before importing (title, images, variants, pricing).

Import an AliExpress product to your store with optional price markup and category mapping.

Trigger inventory and price sync for all imported dropshipping products.

View and manage AliExpress API credentials and sync settings.

Update AliExpress API credentials and sync preferences.

Browse available supplier products with search, category filtering, and pagination.

curl "https://nofert.net/api/v1/vendor/supplier-catalog?search=headphones&per_page=20" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Get full details of a supplier product including variants, images, and wholesale pricing.

Import a supplier product to your store with custom pricing and category.

Download the CSV template with headers and example rows.

curl "https://nofert.net/api/v1/vendor/import/template" \
  -H "Authorization: Bearer YOUR_USER_TOKEN" \
  -o products-template.csv

Upload a CSV file to import products. Returns import job status with success/error counts.

List all API keys for the vendor with last-used timestamps and permissions.

curl "https://nofert.net/api/v1/vendor/api-keys" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Create a new API key. The key value is returned only once — store it securely.

Enable or disable an API key.

Permanently revoke and delete an API key.

List all registered webhook endpoints with delivery stats.

curl "https://nofert.net/api/v1/vendor/webhooks" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Register a new webhook URL with event subscriptions. Returns the webhook secret.

Enable or disable a webhook endpoint.

Send a test payload to the webhook URL to verify it's working.

Delete a webhook endpoint. All pending deliveries will be cancelled.

Returns current domain configuration: subdomain, custom domain, SSL status, and DNS verification.

curl "https://nofert.net/api/v1/vendor/domains/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Set or change the vendor's subdomain (e.g., myshop.nofert.net).

Set a custom domain (e.g., shop.example.com). Returns DNS records to configure.

Trigger DNS verification for the custom domain.

Remove the custom domain and revert to subdomain only.

Returns current verification status: unverified, pending, verified, or rejected with reason.

curl "https://nofert.net/api/v1/vendor/verification/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Submit verification documents (ID, business registration). Accepts multipart file uploads.

Returns Stripe Connect account status: not_connected, pending, active, or restricted.

curl "https://nofert.net/api/v1/vendor/stripe-connect/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Initiate Stripe Connect onboarding. Returns an onboarding URL to redirect the vendor to.

Get a Stripe Express Dashboard login link for the vendor to manage their payout settings.

Generate and download a PDF invoice for the order.

curl "https://nofert.net/api/v1/vendor/orders/ORD-20260301-XK42/invoice" \
  -H "Authorization: Bearer YOUR_USER_TOKEN" \
  -o invoice.pdf

Generate and download a shipping label PDF for the order.

Returns affiliate status: active, pending, or not_enrolled. Includes commission rate and total earned.

curl "https://nofert.net/api/v1/user/affiliate/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Apply to join the affiliate program.

Generate a referral link for a specific product or the homepage.

List commission history with status (pending, approved, paid) and pagination.

Returns whether 2FA is enabled, pending confirmation, or disabled for the user.

curl "https://nofert.net/api/v1/user/2fa/status" \
  -H "Authorization: Bearer YOUR_USER_TOKEN"

Start 2FA setup. Returns a TOTP secret and QR code URL for the authenticator app.

Confirm 2FA setup by providing a valid TOTP code from the authenticator app. Returns recovery codes.

Disable 2FA. Requires current password for security.

Report a product for policy violation. Provide a reason (counterfeit, inappropriate, spam, other) and optional details.

curl -X POST "https://nofert.net/api/v1/products/42/report" \
  -H "Authorization: Bearer YOUR_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "counterfeit", "details": "This appears to be a fake product." }'

Report a vendor for policy violation. Same reason/details fields as product reports.

Vote on a review. Send vote: "helpful" or vote: "unhelpful". Voting again with the same value removes the vote (toggle).

curl -X POST "https://nofert.net/api/v1/reviews/15/vote" \
  -H "Authorization: Bearer YOUR_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "vote": "helpful" }'

Subscribe an email address to the newsletter. Rate limited to prevent abuse.

curl -X POST "https://nofert.net/api/v1/newsletter/subscribe" \
  -H "Content-Type: application/json" \
  -d '{ "email": "user@example.com" }'