API ReferenceWooCommerceSDKssoonWebhookssoon

Integrations

WooCommerce order webhook

POST/beltempo/check

The endpoint our WooCommerce plugin POSTs to when an order completes. Documented so integrators wiring up non-WooCommerce stacks can mirror its contract.

Authentication

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

Body parameters

woo_user_idstringrequired

WooCommerce customer ID (or your equivalent stable customer key)

emailstringoptional

used as a fallback identifier if user_id is unknown

order_idstringrequired
order_totalnumberrequired

fiat amount in minor units (cents)

currencystringoptional
payment_methodstringoptional
POST/beltempo/check
curl --request POST "https://api.trevi.cash/beltempo/check" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $BTPAY_API_KEY" \
  --data '{
    "woo_user_id": "12345",
    "email": "buyer@example.com",
    "order_id": "WC-1042",
    "order_total": 4999,
    "currency": "CHF"
  }'