stripe-openapi-agent/skills/charges/SKILL.md

name, description

name	description
charges-routes	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:

  This method is no longer recommended—use the Payment Intents API to initiate a new payment instead. Confirmation of the PaymentIntent creates the Charge object used to request payment.

• 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:

  Retrieve a dispute for a specified charge.

• 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:

  Retrieves the details of an existing refund.

• 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:

  Update a specified refund.

• Parameters:
  • charge in path required
  • refund in path required
• Body: JSON request body accepted.