ProvelyNo. Shopify Admin API returns a success response when it accepts the request. Provely proves created and financially_completed as separate promises.
| Fact | Value |
|---|---|
| Skill version | 0.1.0 |
| Publisher | Built and signed by Provely. |
| Certification | Provisional |
| Last conformance run | 2026-09-05T12:00:00Z: 30 of 30 cases passed, 0 critical false VERIFIED |
| Provider API versions | 2025-07 |
| Default provider API version | 2025-07 |
| Compiled | 2026-09-05 |
| Manifest hash | 6a05a71c10b5f923 |
| Manifest hash check | the document hashes to the value the manifest states |
| Signature | valid, key provely-skill-2026-09, trusted by this build |
What does this page prove?
| Claim | Proven by | Evidence | Status |
|---|---|---|---|
| The created level proves that the Refund record exists with the requested amount and a refunds/create webhook. It does not prove that money moved. | shopify.refund.created | E2 + E3 | proven |
| A Refund record does not prove money movement. This level proves the SUCCESS status on the refund transaction with the requested amount. | shopify.refund.financially_completed | E2 | proven |
| An outcome outside Shopify Admin API, such as a bank credit or a person who read a message | not proven | no E5 channel | not proven |
| The meaning of a Shopify Admin API state that no source states | not proven | no source states it | not proven |
| The agent report that the action worked | never counts | E0 | not proven |
Which completion levels does the Shopify Admin API skill expose?
Each level is one promise with one contract. An agent picks the level that matches the promise it makes. It cannot upgrade a level. Read the completion level definition.
| Level | Contract | Promise | Evidence | Certification |
|---|---|---|---|---|
created | shopify.refund.created v1.0.0 | The created level proves that the Refund record exists with the requested amount and a refunds/create webhook. It does not prove that money moved. | E2 + E3 | Provisional |
financially_completed | shopify.refund.financially_completed v1.0.0 | A Refund record does not prove money movement. This level proves the SUCCESS status on the refund transaction with the requested amount. | E2 | Provisional |
Which ways can a Shopify Admin API action look done and not be?
| Contract | Case | Verdict |
|---|---|---|
| shopify.refund.created | duplicate side effect | CONTRADICTED |
| shopify.refund.created | pre existing state | CONTRADICTED |
| shopify.refund.created | wrong amount | CONTRADICTED |
| shopify.refund.created | wrong subject | CONTRADICTED |
| shopify.refund.financially_completed | duplicate side effect | CONTRADICTED |
| shopify.refund.financially_completed | partial completion | CONTRADICTED |
| shopify.refund.financially_completed | pre existing state | CONTRADICTED |
| shopify.refund.financially_completed | wrong amount | CONTRADICTED |
| shopify.refund.financially_completed | wrong subject | CONTRADICTED |
What did the last conformance run show?
The last conformance run on 2026-09-05T12:00:00Z passed 30 of 30 cases with 0 critical false VERIFIED. One critical false VERIFIED rejects a skill.
| Contract | Certification |
|---|---|
shopify.refund.created | Provisional |
shopify.refund.financially_completed | Provisional |
The weakest contract is shopify.refund.created. It reaches Provisional. The package level is Provisional, because a package level never rises above its weakest contract. Read the level of the contract you use.
| Case class | Passed | Total |
|---|---|---|
| duplicate side effect | 2 | 2 |
| error after execution | 2 | 2 |
| error before execution | 2 | 2 |
| evidence unavailable | 2 | 2 |
| pre existing state | 2 | 2 |
| stale readback | 2 | 2 |
| still transitional | 2 | 2 |
| terminal failure | 2 | 2 |
| terminal success | 2 | 2 |
| timeout after commit | 2 | 2 |
| version mismatch | 2 | 2 |
| webhook duplicate | 2 | 2 |
| webhook out of order | 2 | 2 |
| wrong amount | 2 | 2 |
| wrong subject | 2 | 2 |
The conformance artifact digest is b5ccb71f7127be53. The harness signs the run, so a reader can check that these numbers come from that run.
What remains uncertain?
The level is Provisional because of it. Provely does not guess a rule that a source does not state.
What happens to a Shopify Admin API verdict when Shopify Admin API is down?
Nothing changes about the verdict. Provely records whether Shopify Admin API answered when it read it, and it reads what Shopify Admin API publishes about itself. Both explain an answer. Neither decides one. Read how Provely records integration uptime.
Shopify Admin API publishes a machine-readable status document at https://www.shopifystatus.com/api/v2/summary.json. Provely reads it on a schedule and stores what it says. An Atlassian Statuspage v2 summary document with page, status, components and incidents.
Source: Shopify Admin API status page · retrieved 2026-09-07
A Shopify Admin API status page is second-hand. It is often late, and it is often narrower than the outage. A verdict never rests on it.
Where do these facts come from?
Every claim above cites a source assertion in the skill provenance. The compiler records the source, its hash, and the retrieval date. A page never states a provider rule without one.
| Source | Kind | Retrieved | Excerpt |
|---|---|---|---|
| shopify.docs.refunds | docs | 2026-09-05 | authored |
| shopify.graphql | graphql | 2026-09-05 | authored |
How do I verify a Shopify Admin API action?
Verify a Shopify Admin API action with Provely
- Begin the operation.Call
beginwith the contractshopify.refund.financially_completedand the input. Keep the operation id. - Make the Shopify Admin API call you make today.Send the request with the correlation metadata that
beginreturned. - Submit the acknowledgement.Call
action_resultwith the Shopify Admin API response. This is evidence level E1. It is not completion. - Verify.Call
verify. The runtime reads the evidence that the contract names, from Shopify Admin API and not from the agent, and evaluates the contract. - Report the verdict exactly as returned.VERIFIED comes with a signed receipt. PENDING comes with the operation id. CONTRADICTED and UNVERIFIABLE are not success.
Questions developers ask
Does the created level prove the financially_completed level?
No. The created level proves that the Refund record exists with the requested amount and a refunds/create webhook. It does not prove that money moved. A Refund record does not prove money movement. This level proves the SUCCESS status on the refund transaction with the requested amount. Use shopify.refund.financially_completed to prove financially_completed.
What does the agent say while the Shopify Admin API action is still in progress?
It says: "The action is accepted but not yet verified. Operation: <id>." The verdict is PENDING. The runtime observes again on the contract timing policy.
Which Shopify Admin API API versions does the skill support?
2025-07. An operation on another version returns UNVERIFIABLE with the reason version_unsupported. The runtime never guesses.
Does Provely need write access to Shopify Admin API?
No. The agent keeps its write key. The verifier reads with a separate read-only credential where Shopify Admin API permits it, and it never shares that credential with the agent.