跳到正文
cccskills
免费在 GitHub 公开

refund-and-dispute

Handle Stripe refunds and payment disputes by checking the original charge, remaining refundable amount, currency, and account mode. Follow human confirmation for refunds, distinguish disputes from refunds, and report the actual payment status.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Move money back to a customer in Stripe, or respond to a dispute, with the checks that belong in front of an irreversible write — read the charge first, fix the exact amount, and clear Stripe's human confirmation step. Use when the user asks to refund a payment, cancel and refund a subscription, or handle a chargeback or dispute.

集成工具Stripe

实测评分 未实测

查看安装方法

适用场景

  • Issuing a full refund
  • Refunding part of a payment
  • Canceling and refunding a subscription
  • Submitting evidence or accepting a payment dispute

包含的文件(1)

  • SKILL.md4.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

A refund is not a retryable call

Every other Stripe read can be run again for free. A refund cannot. Treat the write as the last step of a short checklist, never as the first attempt at understanding the request.

1. Read the charge before you touch it

The checks live on the charge, so a pi_ id is not where this starts: read the PaymentIntent, follow latest_charge, and read that charge. Skipping the hop is how an agent misses an open dispute, because refunded, amount_refunded, and disputed are not PaymentIntent fields and reading them off one yields undefined rather than an error.

A latest_charge of null ends the job rather than starting it: the PaymentIntent was never confirmed, or no attempt produced a charge, so there is nothing to refund. Say that and stop.

On the charge, check four fields:

  • amount and currency: the only authority for what can be refunded.
  • amount_refunded: a charge refunded in part looks fully refundable from a dashboard glance.
  • status and refunded: a failed or already-refunded charge needs a different answer, not a write.
  • disputed: if a dispute is open, refunding is the wrong instrument. See step 5.

Confirm the mode with get_stripe_account_info first. A live-mode refund issued because the id was assumed to be a sandbox id cannot be undone.

2. Fix the amount in the smallest currency unit, explicitly

Omitting amount refunds the whole charge. A partial refund takes an integer in the smallest unit of the charge's currency, so a $12.34 refund is 1234 and a 1234 yen refund is 1234. Never derive the figure from a human-readable total in the conversation when the charge object is one read away, and say the figure and currency back to the user before writing.

3. State the intent, then write once

Before calling stripe_api_write, tell the user in one line what you are about to do: the charge id, the amount, the currency, the mode, and the reason (duplicate, fraudulent, or requested_by_customer). The reason is not decoration; fraudulent affects how Stripe treats the customer later, so do not pick it for a routine cancellation.

4. Expect Stripe's confirmation step and let the human do it

Stripe requires human confirmation before it performs certain writes, refunds among them. The call comes back with a confirmation URL instead of a refund. When that happens:

  • Pass the URL to the user and stop. They review the real amount on Stripe's own page and approve it there.
  • The approval expires after 24 hours.
  • After they approve, retry the same call once. Approval alone does not perform the refund.

Do not loop retrying while you wait, and do not route around the step by asking for an API key. The confirmation is the control that makes an agent with write access safe.

If a write errors ambiguously, list the charge's refunds before retrying and check whether one already landed. Reporting a refund that did not happen and issuing a second one are both worse than a slow answer.

5. A dispute is not a refund

A chargeback is the issuer taking the money back on the customer's word. Opening a refund on a disputed charge can cost you the amount twice and still lose the dispute. Read the dispute, then either submit evidence through its evidence fields or accept it deliberately. Say which one you did and why.

6. Report what actually changed

The refund id, the amount and currency, the status (pending and succeeded mean different things to the customer), and the mode. Tell the user the money typically reaches the customer in five to ten business days, because the next question is always when it arrives.

Anti-patterns

  • Refunding to make a dispute go away. It does not, and it can double the loss.
  • "Refund the last payment." Name the charge you picked and why, or the user cannot catch you picking the wrong one.
  • Guessing a partial amount from the thread. Read the charge.
  • Running the checklist against a PaymentIntent. The refund and dispute fields live on the charge; a PaymentIntent answers those questions with undefined, which reads like "no".
  • Treating a confirmation URL as an error. It is the system working.
  • Refunding when the user asked to cancel. Cancelling a subscription stops future invoices and refunds nothing. Do the one that was asked for, and say which.

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

10x

免费

Review how you use Superset and identify unused features that fit your workflow. Get a short list of suggestions, learn about each option, and set up selected features such as scheduled agents, parallel workspaces, or shared tasks.

中文简介正在准备中。当前显示英语简介。

  • Find unused Superset features worth exploring
  • Set up scheduled agent tasks
  • Start parallel work in separate workspaces
superset-sh/superset1.6万2026年10月23日 更新

automate

免费

Set up recurring tasks in Superset with an agent prompt, a schedule or event trigger, and a chosen execution workspace. After explicit confirmation, create the automation, check its saved settings, and review a real first run.

中文简介正在准备中。当前显示英语简介。

  • Scheduling a daily or weekly agent task
  • Starting agent work when a GitHub pull request opens
  • Triggering tasks from selected Slack reactions
superset-sh/superset1.6万2026年10月23日 更新

browser

免费

Browse pages, click controls, fill fields, and inspect screenshots or console messages through Superset's browser pane. Use it to preview a running web app, check interface behavior, and work through browser tasks in a visible session.

中文简介正在准备中。当前显示英语简介。

  • Preview a locally running web app
  • Capture screenshots of a page
  • Inspect console errors
superset-sh/superset1.6万2026年10月23日 更新

Build Stripe payments, subscriptions, and invoicing using verified documentation and API parameter definitions. The skill guides product selection, sandbox testing, and webhook handling, where server notifications determine payment and subscription state.

中文简介正在准备中。当前显示英语简介。

  • Choose Stripe products for payments or recurring billing
  • Implement Checkout or invoice flows
  • Investigate Stripe code that compiles but behaves incorrectly
superset-sh/superset1.6万2026年10月23日 更新

Verify desktop UI changes through the Chrome DevTools Protocol, a connection for controlling the running app. Reproduce the user’s actual steps and compare screenshots, measured state, and console errors to establish evidence before and after a fix.

中文简介正在准备中。当前显示英语简介。

  • Reproducing reported bugs in the running app
  • Comparing UI behavior before and after a fix
  • Checking state across navigation and reopening
superset-sh/superset1.6万2026年10月23日 更新

ci-triage

免费

Diagnose failed GitHub Actions runs by finding the first meaningful error, separating code problems from infrastructure issues and intermittent failures, and comparing the base branch. Get a focused report explaining the PR’s involvement and recommended next steps.

中文简介正在准备中。当前显示英语简介。

  • Investigating failed PR checks
  • Separating intermittent test failures from code defects
  • Checking whether the base branch already fails
superset-sh/superset1.6万2026年10月23日 更新

查看 superset-sh 的全部技能

报告此技能的问题