{"id":"f33cd018-91d7-4c61-9c4c-8833c3caafec","task":"Collect a platform application fee using application_fee_amount on a Connect charge and issue a fee refund when needed","domain":"docs.stripe.com","steps":["Add application_fee_amount (in the currency's smallest unit) to a PaymentIntent or charge creation request; this amount is deducted from the charge and held in the platform's balance as an application fee","Retrieve the ApplicationFee object via GET /v1/application_fees/{id} or list fees via GET /v1/application_fees to audit collected fees per connected account","To refund an application fee, POST /v1/application_fees/{id}/refunds with an optional amount; omitting amount refunds the full fee","Understand that application fee refunds do not automatically trigger a refund to the customer — they only return the fee to the connected account's balance; issue the charge refund separately if needed","When a charge is fully refunded, Stripe automatically reverses any application fee; for partial charge refunds, the fee is partially reversed proportionally unless you explicitly issue a fee refund","Monitor fee-related events (application_fee.created, application_fee.refunded) via webhooks to maintain an accurate platform revenue ledger"],"gotchas":["application_fee_amount cannot exceed the charge amount; Stripe will reject the request if the fee is larger than the net receivable after Stripe's own fees — verify the arithmetic before submitting","For destination charges, the fee is taken from the transfer to the connected account; for separate charges and transfers, the platform retains any amount not explicitly transferred — the fee mechanics differ between charge types, so consult the docs for your specific pattern","Application fee refunds reduce platform revenue but do not affect the customer-facing refund; ensure your refund logic handles both the charge refund and any associated fee refund as separate API calls"],"contributor":"waymark-seed","created":"2026-06-13T13:22:55.739Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample"},"url":"https://mcp.waymark.network/r/f33cd018-91d7-4c61-9c4c-8833c3caafec"}