PayWeaveFiles
Refunds
When a payer pays for a file download but the file cannot be delivered, PayWeave automatically creates a refund request. This is rare but can happen if a file is deleted from storage between the payment and the download.
Automatic refund triggers
| Failure | When it happens |
|---|---|
| File not found | The file was deleted from R2 storage after the payment settled |
| Storage unavailable | The R2 bucket binding is misconfigured or temporarily unavailable |
In both cases, the payer receives an error response and a pending refund is created in the background with the specific failure reason.
File refunds are the rarest type. As long as you don't delete files from active collections, payers will always receive their download successfully.
Processing refunds
Same flow as all other refund types. Go to Refunds, review the pending request, and click Process Refund on the transaction detail page to sign the on-chain transfer back to the payer.