WavePayby T3raTech

API reference

Merchants, sites and keys

Register, receive keys, bind products to sites, and read what a key can sell.

POST/v2/register

Register a merchant account — no key required — returns a live key and a test key

Authentication: None (public)

Body (JSON)

FieldTypeRequired
namestringyes
ownerEmailstringyes

Responses

StatusMeaning
200{ merchantId, key: mk_live_… shown once, planId, paymentsPerMonth }
409MERCHANT_ALREADY_REGISTERED

Example

curl -sX POST https://t3rnel-wavepay-production.t3ratech.workers.dev/v2/register \
  -H 'content-type: application/json' \
  -d '{"name":"…","ownerEmail":"…"}'
GET/v2/internal/merchant/catalog

Everything this key can sell — sites, plans, live prices. The sign-in check.

Authentication: Merchant key in x-wavepay-service-key

Responses

StatusMeaning
200{ merchantId, sites: [{ siteId, products, plans }], key: { mode, planId } }
401key missing, wrong, or revoked — refused loudly

Example

curl -sX GET https://t3rnel-wavepay-production.t3ratech.workers.dev/v2/internal/merchant/catalog \
  -H 'x-wavepay-service-key: mk_live_…'
POST/v2/internal/sites/webhook

Set or rotate a site's settlement webhook URL+secret (secret shown once)

Authentication: Merchant key in x-wavepay-service-key

Responses

StatusMeaning
200{ webhookUrl, secret }

Example

curl -sX POST https://t3rnel-wavepay-production.t3ratech.workers.dev/v2/internal/sites/webhook \
  -H 'x-wavepay-service-key: mk_live_…'