Documentation

API
Documentation

Seller API documentation and hosted payment usage guidelines. Custom invoices are generated from the seller dashboard and proxied through a hosted white-label payment page branded to the selected merchant.

Base URL

All seller API requests should be made to the marketplace API base below.

https://esmarket.cc/api/

Authentication

Each merchant gets its own API keys inside the seller dashboard. Keys are grouped by merchant, can be copied or regenerated independently, and should be treated like production credentials.

Required header
Authorization: Bearer esk_live_xxxxxxxxxxxxxxxxxxxxxxxx
Key behavior

Regenerating a key invalidates the previous value immediately for that merchant key label, so update any integrations using it.

API Keys

The seller dashboard API Access page separates keys by merchant. Each row shows the API key label, current key, and direct copy or regenerate actions without mixing them up with merchant or storefront identifiers.

Merchant: @w5z
Label: Primary
Key: esk_live_********************************

Merchant: @secondstore
Label: Primary
Key: esk_live_********************************

Hosted Invoices

Hosted invoice links create a public OxaPay white-label payment session branded to the selected merchant. No customer sign-in is required, and the hosted page can be opened in a new tab or sent directly to the customer.

POST /api/seller/custom-invoices
{
  "merchantId": "merchant_id",
  "title": "Priority invoice",
  "description": "Manual payment request",
  "amountUsd": 50,
  "customerName": "Client",
  "customerEmail": "client@example.com"
}

Payment Lifecycle

The hosted invoice flow follows the same reusable Litecoin white-label session used across deposit and verification pages. Once the provider marks the invoice as paid, the seller wallet receives the credited amount automatically.

1. Create invoice

Generate a custom invoice from the seller dashboard by choosing a merchant, amount, title, and optional customer details.

2. Share link

Open the public invoice page in a new tab or send the hosted link directly to a customer. No marketplace sign-in is required.

3. Buyer pays in LTC

The buyer lands on a white-label payment page branded to the selected merchant and completes payment through OxaPay.

4. Wallet credited

OxaPay callback hits the platform, the invoice status becomes paid, the seller wallet transaction is created, and invoice history updates automatically.