1. Set FORGE_API_KEY on the merchant server. The SDK uses Forge’s collector automatically.
  2. Inspect diagnostics. Node: forge.diagnostics().enabled === true and configErrors is empty. Python: forge.diagnostics()["enabled"] is true and config_errors is empty.
  3. Deploy and make an unpaid request to a paid route. Confirm the existing 402 response and an ordinary route still behave as expected. Inspect your OpenAPI response if configured.
  4. Let the background event queue flush, then select Test connection on the service’s Activity page. It checks whether Forge received an SDK event for the active key.
Test connection does not establish service ownership or prove a completed payment. An unpaid request is enough to generate a challenge event; do not spend funds just to test the SDK. If no contact appears, check the key, SDK diagnostics, server egress, and whether your request reached Forge’s adapter. For Node, await forge.shutdown() flushes pending events after the server drains.