Skip to content

Internal Endpoints

Warning: The endpoints documented on this page are for VRP Billing internal operations only. Merchants must not call these APIs from production or sandbox integrations. Abuse may result in API key suspension.

Console Event Stream (Internal Only)

GET /internal/console/events

Provides a server-sent event stream of merchant actions in the VRP Console for support teams. Responses include sensitive audit data and must never be exposed outside VRP Billing.

Constraints

  • Accessible only from VRP Billing corporate networks.
  • Requires internal service account credentials with the console.read scope.
  • Event retention is limited to seven days.

Log Aggregation (Internal Only)

POST /internal/logs/search

Allows customer support to run scoped searches over ingestion pipelines when triaging incidents.

Constraints

  • Payloads must include a ticket_id to ensure accountability.
  • Queries run against mirrored log indices to avoid impacting production traffic.
  • Maximum response size is 5 MB; requests exceeding this limit return 413 Payload Too Large.

Manual Mandate Adjustments (Internal Only)

POST /internal/mandates/{id}/adjust

Support engineers use this endpoint to correct mandate limits when authorised by compliance.

Constraints

  • Requires elevated mandates.override scope and multi-factor approval.
  • Adjustments are captured in the internal audit ledger.
  • Customers receive a proactive notification via the Merchant Console.

Release Deployment Trigger (Internal Only)

POST /internal/releases/deploy

Triggers continuous deployment pipelines for VRP Billing services.

Constraints

  • Only accessible to the platform engineering team.
  • Validates change approvals in the release management system before execution.
  • Returns deployment identifiers for traceability.

These endpoints support operational workflows and must not appear in generated client SDKs or customer-facing documentation.