ProvelyProve that the money returned to the payment card of the buyer. A PaymentRefund object does not prove that money moved. This level proves the COMPLETED state on the refund and an event that carries it.
| Fact | Value |
|---|---|
| Contract id | square.refund.completed |
| Version | 1.0.0 |
| Hash | 996beade3905b671 |
| Completion level | refunded |
| Publisher | Built and signed by Provely. |
| Certification | Provisional |
| Skill | Square 0.1.0 |
| Valid for provider API versions | 2026-08-19 |
What is the intent?
Return the amount of the payment to the buyer.
What is the subject and the action?
| Member | Value |
|---|---|
| Subject type | square.payment_refund |
| Canonical effect | payments.card_refund |
| Provider operation | POST /v2/refunds |
| Idempotency | idempotency_key, retry is safe |
Which false successes give CONTRADICTED?
- duplicate side effect
- pre existing state
- wrong amount
- wrong subject
The signed contract states the exact conditions, the evidence and the timing. The runtime reads them. The page states the promise.
Where do these rules come from?
square.openapi#/paths/~1v2~1refunds/post: square.openapi, retrieved 2026-09-08square.openapi#/components/schemas/PaymentRefund/properties/status: square.openapi, retrieved 2026-09-08square.docs.refunds#refunds/p1: square.docs.refunds, retrieved 2026-09-08square.docs.refunds#refunds/the-status-of-a-refund/p2: square.docs.refunds, retrieved 2026-09-08square.docs.refunds#refunds/the-status-of-a-refund/p5: square.docs.refunds, retrieved 2026-09-08square.openapi#/components/schemas/PaymentRefund/properties/amount_money: square.openapi, retrieved 2026-09-08square.openapi#/components/schemas/Money/properties/amount: square.openapi, retrieved 2026-09-08square.openapi#/components/schemas/PaymentRefund/properties/payment_id: square.openapi, retrieved 2026-09-08square.docs.refunds#refunds/identifiers-and-times/p1: square.docs.refunds, retrieved 2026-09-08square.openapi#/components/schemas/PaymentRefund/properties/created_at: square.openapi, retrieved 2026-09-08square.events#/events/refund.updated: square.events, retrieved 2026-09-08square.docs.webhooks#webhooks/the-event-types/p5: square.docs.webhooks, retrieved 2026-09-08
Can square.refund.completed return VERIFIED from the action response alone?
No. The action response is E1, and an acknowledgement is never terminal success. The contract needs evidence of level E2 or higher from Square.
What happens after the timeout?
The verdict is UNVERIFIABLE. The operation goes to a person for review.