The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
import { adminAuth, createClient, type InferClient } from "@mercurjs/client"
import type { MedusaResponse } from "@medusajs/framework"
import type { PayoutReversalDTO } from "@mercurjs/types"
import type {
AdminAdjustmentListResponse,
AdminAdjustmentResponse,
AdminPayoutAccountListResponse,
AdminPayoutAccountResponse,
AdminPayoutJobListResponse,
AdminPayoutJobRunListResponse,
AdminPayoutJobRunResponse,
AdminPayoutListResponse,
AdminPayoutNotificationListResponse,
AdminPayoutResponse,
AdminPayoutStatusResponse,
AdminSettlementListResponse,
AdminSettlementResponse,
AdminStripeCaptureListResponse,
AdminStripeCaptureResponse,
} from "../../types/http"
export type {
AdminPayoutAccountListResponse,
AdminStripeCapture,
AdminPayoutJob,
AdminPayoutStatusResponse,
AdminSettlementListResponse,
} from "../../types/http"
export type ListQuery = Record<string, unknown> & { limit?: number; offset?: number }
type Route<Input, Output> = (req: { validatedBody: Input }, res: MedusaResponse<Output>) => Promise<void>
type Empty = { fields?: string }
type SellerRef = { id: string; name: string; handle: string; metadata?: Record<string, unknown> | null }
export type PayoutAccountRow = AdminPayoutAccountListResponse["payout_accounts"][number] & {
seller?: SellerRef | null
onboarding?: { id: string; data: Record<string, unknown> | null } | null
}
export type PayoutRow = AdminPayoutListResponse["payouts"][number] & {
seller?: SellerRef | null
reversals?: PayoutReversalDTO[]
}
export type SettlementRow = AdminSettlementListResponse["settlements"][number]
export type SettlementDetail = AdminSettlementResponse["settlement"]
export type AdjustmentRow = AdminAdjustmentListResponse["adjustments"][number]
export type JobRunRow = AdminPayoutJobRunListResponse["runs"][number]
export type NotificationRow = AdminPayoutNotificationListResponse["notifications"][number]
export type SellerListResponse = {
sellers: { id: string; name: string }[]
count: number
offset: number
limit: number
}
export const PAYOUT_IGNORED_KEY = "payout_ignored"
export const isIgnored = (account: PayoutAccountRow) =>
String(account.seller?.metadata?.[PAYOUT_IGNORED_KEY] ?? "") === "true"
type Routes = {
admin: {
sellers: {
GET: Route<ListQuery, SellerListResponse>
}
"payout-accounts": {
GET: Route<ListQuery, AdminPayoutAccountListResponse>
POST: Route<{ seller_id: string; external_id: string }, AdminPayoutAccountResponse>
$id: {
GET: Route<Empty, AdminPayoutAccountResponse>
"refresh-link": { POST: Route<Empty, AdminPayoutAccountResponse> }
sync: { POST: Route<Empty, AdminPayoutAccountResponse> }
}
}
payouts: {
GET: Route<ListQuery, AdminPayoutListResponse>
$id: { retry: { POST: Route<Empty, AdminPayoutResponse> } }
}
stripe: {
status: { GET: Route<Empty, AdminPayoutStatusResponse> }
accounts: {
$id: { ignore: { POST: Route<{ ignored: boolean }, AdminPayoutAccountResponse> } }
}
settlements: {
GET: Route<ListQuery, AdminSettlementListResponse>
$id: {
GET: Route<Empty, AdminSettlementResponse>
retry: { POST: Route<Empty, AdminSettlementResponse> }
}
}
adjustments: {
GET: Route<ListQuery, AdminAdjustmentListResponse>
POST: Route<
{ seller_id: string; type: string; amount: number; currency_code: string; reason?: string | null },
AdminAdjustmentResponse
>
}
jobs: {
GET: Route<Empty, AdminPayoutJobListResponse>
$job: {
runs: { GET: Route<ListQuery, AdminPayoutJobRunListResponse> }
run: { POST: Route<Empty, AdminPayoutJobRunResponse> }
}
}
captures: {
GET: Route<ListQuery, AdminStripeCaptureListResponse>
$order_group_id: {
capture: { POST: Route<Empty, AdminStripeCaptureResponse> }
cancel: { POST: Route<Empty, AdminStripeCaptureResponse> }
}
}
notifications: {
GET: Route<ListQuery, AdminPayoutNotificationListResponse>
test: { POST: Route<Empty, { notification: unknown }> }
}
}
}
}
export const client: InferClient<Routes> = createClient({
baseUrl: import.meta.env.VITE_MERCUR_BACKEND_URL || "http://localhost:9000",
fetchOptions: { credentials: "omit" },
auth: adminAuth(),
})