Exercise a provider capability on a test account

Purpose

Administrators check a provider operation using an account identified by the provider as a test account.

How It Works

An administrator opens a usable test connection and chooses Try a call. The provider’s account description supplies the test boundary. The panel sends a real gateway operation on that selected account. Activity and connection history then provide the same investigation surfaces as ordinary calls. A fresh request identity distinguishes repeated test attempts. A live or unclassified account does not receive this control. Readers can inspect results without initiating a test. The product should retain the provider-reported boundary when adding more test operations.

Relationships

Requires run provider operations safely through the gateway to supply the prerequisite configuration or operation.
Requires maintain a verified provider account connection to supply the prerequisite configuration or operation.
Connects with explain and select the connection for a call through shared integration records.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: Provider-reported live or unknown accounts cannot receive Library test calls.Test operations identify their initiating person and retain real gateway history.
Surfaces: consoleapi
Intent sources: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1aservices-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1bservices-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1c

Controls

22 controls apply, from the corpus control catalogue.

TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-002 TC-PI-005 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`platform.integrations.manage`	api	tenant
`platform.integrations.manage`	console	tenant

Business Rules

7 rules, 7 to be proved before approval. A rule's product intent is derived from its origin: 0 confirmed by a product decision, the rest inheriting this capability's proposed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Proposed	Library test invocation requires a provider-reported test account; live and unreported account environments are refused before execution recording. origin: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1c proved by `ATS-PFM-INT-012-01`, `TST-PFM-INT-484`	policy	api, service	test services-platform:modules/integrations/tests/e2e/connection-try.e2e.spec.js#is refused 409 connection_not_test when the provider reported a live account, and no execution is recorded
`02`must prove Proposed	Existing integration-manage authority permits a person to try a call, with no additional permission and no records for unauthorized attempts. origin: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1b proved by `ATS-PFM-INT-012-02`, `TST-PFM-INT-484`	permission	api, console	test services-platform:modules/integrations/tests/e2e/connection-try.e2e.spec.js#is refused 403 and no execution or audit row is recorded
`03`must prove Proposed	The selected connection must be active or degraded and verified for the capability, with suspended and unsupported cases refused distinctly. proved by `ATS-PFM-INT-012-03`, `TST-PFM-INT-484`	validation	service	test services-platform:modules/integrations/tests/e2e/connection-try.e2e.spec.js#is refused 409 connection_unavailable when it is suspended
`04`must prove Proposed	The Library invokes through the gateway directly on the selected connection without a binding, as its test application for the person and with a new idempotency key each time. origin: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1a proved by `ATS-PFM-INT-008-11`, `ATS-PFM-INT-009-18`, `ATS-PFM-INT-012-04`, `ATS-PFM-INT-012-07`, `ATS-PFM-INT-012-08`, `TST-PFM-INT-340`, `TST-PFM-INT-484`	policy	service	test services-platform:modules/integrations/tests/e2e/connection-try.e2e.spec.js#records an execution of that connection by the calling application library_try on behalf of the person, with no binding
`05`must prove Proposed	Test-call history identifies the person, capability and resulting execution. proved by `ATS-PFM-INT-012-05`, `TST-PFM-INT-484`	invariant	service	test services-platform:modules/integrations/tests/e2e/connection-try.e2e.spec.js#writes a connection.test_call audit row naming the capability, the execution and the person
`06`must prove Proposed	Account checks replace a prior environment with the provider’s valid test or live report; missing or other values leave environment unknown without failing verification. origin: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1c proved by `ATS-PFM-INT-012-06`, `TST-PFM-INT-516`	calculation	service	test services-platform:modules/integrations/tests/integration/services/connections/connection-account-environment.integration.spec.js#records test when the provider reports a test account
`07`must prove Proposed	Try a call is shown on connection detail only to integration managers for usable provider-reported test accounts. origin: services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D1a no proof recorded yet	policy	console	observed react-console:components/integrations/try-a-call.tsx:accountEnvironment !== "test"

Scenarios

Id	Given	When	Then	Provenance
`01`	The provider describes its connected account as test.	An administrator authorizes twelve dollars through Try a call.	Activity retains the test execution with the initiating person.	test react-console:acceptance/integrations/playwright/journeys/providers/INT-ACC-0706.spec.ts#INT-ACC-0706

Planning

Implementation

Exercise a provider capability on a test account ​

Purpose ​

How It Works ​

Relationships ​