API reference

Marketplace

Airtime-to-cash and marketplace orders.

Overview

The marketplace covers peer/partner conversions — today primarily airtime to cash. A developer creates an order, Century prices it (a 10% service fee applies to airtime-to-cash), and the order moves through review to payout.

Order states mirror the underlying transaction: pending → processing → success | failed.
Payout goes to the wallet, not to a bank account, unless a cash-out is approved.

Not implemented

Do not build against these

Product catalogue and categories
Cart / checkout sessions

Endpoints

3 operations available to your account.

listMyMarketplaceOrders

Bearer token required

Caller's marketplace orders.

Endpoint

GET/_serverFn/listMyMarketplaceOrders

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/listMyMarketplaceOrders \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Runs against Production using your own signed-in session. No shared or secret credential is used.

createMarketplaceOrder

Bearer token required

Create a marketplace order.

Endpoint

POST/_serverFn/createMarketplaceOrder

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X POST https://centuryvtu.com/_serverFn/createMarketplaceOrder \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

getMarketplaceOrder

Bearer token required

Fetch one order.

Endpoint

GET/_serverFn/getMarketplaceOrder

Request body

Field	Type	Required
id	uuid	Yes

Response codes

401	Unauthorized – missing or invalid bearer token.
400	Validation failed – input did not match the schema.
429	Rate limited – slow down and retry.
500	Server error – reported and logged with an error ID.

curl -X GET https://centuryvtu.com/_serverFn/getMarketplaceOrder \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -G

Example response

{ ok: true }