Reseller

Reseller program

Activate reseller pricing, fund your wallet, and resell domains and mailboxes through the API.

The reseller program lets you sell domains and business mailboxes to your own customers. Resellers get lower prices on every domain and mailbox, in the dashboard and through the API, and unlock the reseller endpoints under /v1/developer/domains, /v1/developer/email and /v1/developer/wallet.

How activation works

There is no application form and no manual review. Activation only needs a funded wallet.

Open the Reseller page in the dashboard and choose Become a reseller.
If your wallet balance is already $50 or more, you are activated instantly.
Otherwise you are sent to a top-up checkout for the amount needed to reach $50 (minimum top-up $10). You are activated automatically as soon as the payment lands in your wallet.
Create an API key under Settings → API keys and call the reseller endpoints with the X-API-Key header.

The $50 is not a fee

The activation balance stays in your wallet as spendable credit. It pays for your first domains and mailboxes like any other top-up.

Suspension

Msgera can suspend reseller access. While suspended, every reseller endpoint returns 403 RESELLER_NOT_ACTIVE and the account falls back to standard pricing.

Pricing and the wallet

Prepaid wallet. Every purchase is paid from your USD wallet at the moment it is made. Top up from the dashboard; there is no invoicing.
Buy and renew are priced separately. A domain has a register price and a renew price per year; a mailbox plan has a first-term price and a renewal price.
Final totals. Every price the API returns is the exact amount debited from your wallet, in cents, with nothing added on top. A multi-year registration costs the yearly price times the number of years.
Automatic refunds. If the registrar or mail provider fails after your wallet was charged, the charge is refunded automatically.

Read your balance at any time with the Wallet API.

Domain price list

GET /v1/developer/domains/tlds returns every extension you can sell, with your reseller register and renew prices per year.

Field	Type	Description
`q`	`string`	Filter by extension, e.g. "co". Max 63 characters.
`page`	`integer`	Page number, starting at 1. Defaults to 1.
`pageSize`	`integer`	Items per page, 1-200. Defaults to 50.

curl "https://api.msgera.io/v1/developer/domains/tlds?q=co&page=1&pageSize=50" \
  -H "X-API-Key: $MSGERA_KEY"

Weekly summary email

Every Monday active resellers receive a summary of the previous week:

Domains registered and renewed, and mailboxes created and renewed.
What you spent, your running totals, and your wallet balance.
Renewals due in the next 14 days and what they will cost, with a warning when your balance will not cover them.

You can turn the email off on the Reseller page in the dashboard.

Error codes

Reseller endpoints return the standard error body with a code field you can branch on:

{
  "statusCode": 402,
  "code": "INSUFFICIENT_FUNDS",
  "message": "Wallet balance is too low. Add funds to continue.",
  "balanceCents": 1200,
  "requiredCents": 2399
}

Code	Status	Meaning
`RESELLER_NOT_ACTIVE`	403	The API key belongs to an account without active reseller access: not enrolled, still waiting for the activation top-up, or suspended.
`RESELLER_SUSPENDED`	403	Returned by activation in the dashboard when the account has been suspended. Contact support to restore access.
`INSUFFICIENT_FUNDS`	402	The wallet cannot cover the purchase. The body includes balanceCents and requiredCents so you can top up the difference.
`DOMAIN_UNAVAILABLE`	400	The domain is already registered or cannot be registered.
`DOMAIN_PRICE_UNAVAILABLE`	400	The extension cannot be sold right now. Nothing is charged; try another extension or retry later.
`DOMAIN_INVALID`	400	The domain name is malformed.
`DOMAIN_NOT_FOUND`	404	The domain does not exist on your account.
`DNS_NOT_MANAGED`	400	DNS can only be edited while the domain uses Msgera nameservers, and records managed by a connected service are read-only.
`DNS_INVALID_RECORD`	400	One or more DNS records are missing a value or are invalid.
`MAILBOX_INVALID`	400	The mailbox address or plan is invalid, or the domain is not an active Msgera domain on your account. Returned as 404 when a mailbox id is unknown.
`PROVIDER_UNAVAILABLE`	503	The registrar or mail provider could not complete the request. Any wallet charge for that request is refunded automatically; retry shortly.

Next steps

Domains API: check, register, renew, and manage DNS.
Email API: create, list, and delete mailboxes, and send email from them.
Wallet API: read your wallet balance.
API reference: every reseller endpoint with parameters, responses, and status codes.