deploy

skills/charges/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: charges-routes
+description: Handle 14 OpenAPI operation(s) under /v1/charges for the charges route group.
+---
+
+# charges API Routes
+
+Handle 14 OpenAPI operation(s) under /v1/charges for the charges route group.
+
+Use the generated operation tools to make real API calls. Do not invent API responses.
+If a tool reports missing setup, return the exact setup field name to the caller.
+For write, update, or delete operations, state the intended action before calling the tool.
+
+## Operations
+
+### get_charges
+
+- Operation ID: `get_charges`
+- Route: `GET /v1/charges`
+- Mode: READ
+- Summary: List all charges
+- Parameters:
+  - `created` in `query`
+  - `customer` in `query`
+  - `ending_before` in `query`
+  - `expand` in `query`
+  - `limit` in `query`
+  - `payment_intent` in `query`
+  - `starting_after` in `query`
+  - `transfer_group` in `query`
+- Body: JSON request body accepted.
+
+### post_charges
+
+- Operation ID: `post_charges`
+- Route: `POST /v1/charges`
+- Mode: WRITE
+- Summary: <p>This method is no longer recommended—use the <a href="/docs/api/payment_intents">Payment Intents API</a>
+to initiate a new payment instead. Confirmation of the PaymentIntent creates the <code>Charge</code>
+object used to request payment.</p>
+- Body: JSON request body accepted.
+
+### get_charges_search
+
+- Operation ID: `get_charges_search`
+- Route: `GET /v1/charges/search`
+- Mode: READ
+- Summary: Search charges
+- Parameters:
+  - `expand` in `query`
+  - `limit` in `query`
+  - `page` in `query`
+  - `query` in `query` required
+- Body: JSON request body accepted.
+
+### get_charges_charge
+
+- Operation ID: `get_charges_charge`
+- Route: `GET /v1/charges/{charge}`
+- Mode: READ
+- Summary: Retrieve a charge
+- Parameters:
+  - `charge` in `path` required
+  - `expand` in `query`
+- Body: JSON request body accepted.
+
+### post_charges_charge
+
+- Operation ID: `post_charges_charge`
+- Route: `POST /v1/charges/{charge}`
+- Mode: WRITE
+- Summary: Update a charge
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### post_charges_charge_capture
+
+- Operation ID: `post_charges_charge_capture`
+- Route: `POST /v1/charges/{charge}/capture`
+- Mode: WRITE
+- Summary: Capture a payment
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### get_charges_charge_dispute
+
+- Operation ID: `get_charges_charge_dispute`
+- Route: `GET /v1/charges/{charge}/dispute`
+- Mode: READ
+- Summary: <p>Retrieve a dispute for a specified charge.</p>
+- Parameters:
+  - `charge` in `path` required
+  - `expand` in `query`
+- Body: JSON request body accepted.
+
+### post_charges_charge_dispute
+
+- Operation ID: `post_charges_charge_dispute`
+- Route: `POST /v1/charges/{charge}/dispute`
+- Mode: WRITE
+- Summary: PostChargesChargeDispute
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### post_charges_charge_dispute_close
+
+- Operation ID: `post_charges_charge_dispute_close`
+- Route: `POST /v1/charges/{charge}/dispute/close`
+- Mode: WRITE
+- Summary: PostChargesChargeDisputeClose
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### post_charges_charge_refund
+
+- Operation ID: `post_charges_charge_refund`
+- Route: `POST /v1/charges/{charge}/refund`
+- Mode: WRITE
+- Summary: Create a refund
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### get_charges_charge_refunds
+
+- Operation ID: `get_charges_charge_refunds`
+- Route: `GET /v1/charges/{charge}/refunds`
+- Mode: READ
+- Summary: List all refunds
+- Parameters:
+  - `charge` in `path` required
+  - `ending_before` in `query`
+  - `expand` in `query`
+  - `limit` in `query`
+  - `starting_after` in `query`
+- Body: JSON request body accepted.
+
+### post_charges_charge_refunds
+
+- Operation ID: `post_charges_charge_refunds`
+- Route: `POST /v1/charges/{charge}/refunds`
+- Mode: WRITE
+- Summary: Create customer balance refund
+- Parameters:
+  - `charge` in `path` required
+- Body: JSON request body accepted.
+
+### get_charges_charge_refunds_refund
+
+- Operation ID: `get_charges_charge_refunds_refund`
+- Route: `GET /v1/charges/{charge}/refunds/{refund}`
+- Mode: READ
+- Summary: <p>Retrieves the details of an existing refund.</p>
+- Parameters:
+  - `charge` in `path` required
+  - `expand` in `query`
+  - `refund` in `path` required
+- Body: JSON request body accepted.
+
+### post_charges_charge_refunds_refund
+
+- Operation ID: `post_charges_charge_refunds_refund`
+- Route: `POST /v1/charges/{charge}/refunds/{refund}`
+- Mode: WRITE
+- Summary: <p>Update a specified refund.</p>
+- Parameters:
+  - `charge` in `path` required
+  - `refund` in `path` required
+- Body: JSON request body accepted.