Skip to main content

​
Method

POST /v1/integrations/netopia/notify

​
Body Parameters

The payload mirrors Netopia’s JSON webhook structure. At minimum it contains:

​
Headers

None (endpoint is unauthenticated). Protect it via provider IP allow lists and signature verification.

​
Request Example

curl -X POST https://api.voyantcloud.com/v1/integrations/netopia/notify \
  -H "content-type: application/json" \
  -d '{
    "order": { "orderID": "ORDER-20250301-0001" },
    "payment": {
      "status": 3,
      "ntpID": "9876543210",
      "amount": 8450,
      "currency": "RON",
      "message": "Payment authorized"
    }
  }'

​
Response

{ "ok": true }
Netopia statuses 3 and 5 mark the session as confirmed and trigger the Trigger.dev orchestrator for invoices/contracts. All webhook payloads are stored in payments.webhook_events for auditing.