Netopia Notify Webhook

Receive signed payment status updates from Netopia and confirm payment sessions.

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

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

200 OK

{ "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.