Referrals

Record a referral visit

POST/beltempo/referral/visit

Increment the visit counter on a referral code. Called by your storefront plugin when a visitor lands via /?ref=…

Returns 404 if the code does not belong to your merchant.

Authentication

Requires an API key in the X-API-Key header.

Body parameters

referral_codestringrequired

POST/beltempo/referral/visit

curl --request POST "https://api.trevi.cash/beltempo/referral/visit" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $BTPAY_API_KEY" \
  --data '{ "referral_code": "alice2026" }'

Was this page helpful?

List referral codes

Validate a referral code