Stripe

Get an invoice by ID. Args: - invoice_id: The Invoice ID (in_...) Returns: The invoice details.

Delete a product. Args: - product_id: The Product ID Returns: Confirmation of deletion.

Delete a connected account. Args: - account_id: The Account ID Returns: Confirmation of deletion.

Get the current account balance. Returns the balance currently available in the Stripe account, including available and pending amounts by currency. Returns: Balance with available and pending amounts.

List balance transactions with pagination. Balance transactions show funds moving through your Stripe account, including payments, transfers, fees, and adjustments. Args: - limit: Number of results (1-100) - starting_after: Balance transaction ID for pagination - type: Filter by type (charge, refund, adjustment, etc.) Returns: List of balance transactions

Get a balance transaction by ID. Args: - transaction_id: The Balance Transaction ID (txn_...) Returns: The balance transaction details.

Update a transfer. Args: - transfer_id: The Transfer ID - description: New description - metadata: New metadata Returns: The updated transfer.

List events (webhooks) with pagination. Events represent things that happened in your account, like payment succeeded, subscription created, etc. Args: - limit: Number of results (1-100) - starting_after: Event ID for pagination - type: Filter by event type (e.g., "payment_intent.succeeded") - created_gte: Filter by created timestamp (Unix, greater than or equal) - created_lte: Filter by created timestamp (Unix, less than or equal) Returns: List of events

Get an event by ID. Args: - event_id: The Event ID (evt_...) Returns: The event details including the associated data object.

List coupons with pagination. Args: - limit: Number of results (1-100) - starting_after: Coupon ID for pagination Returns: List of coupons

Get a coupon by ID. Args: - coupon_id: The Coupon ID Returns: The coupon details.

Create a new coupon. Args: - id: Custom coupon ID (optional) - percent_off: Percentage discount (use this OR amount_off) - amount_off: Fixed amount discount in cents (use this OR percent_off) - currency: Currency for amount_off - duration: "forever", "once", or "repeating" - duration_in_months: Months for repeating coupons - max_redemptions: Maximum times coupon can be used - name: Coupon name - redeem_by: Unix timestamp expiration date - metadata: Custom metadata Returns: The created coupon.

Update a coupon. Args: - coupon_id: The Coupon ID - name: New name - metadata: New metadata Returns: The updated coupon.

Delete a coupon. Args: - coupon_id: The Coupon ID Returns: Confirmation of deletion.

List promotion codes with pagination. Args: - limit: Number of results - starting_after: Promotion code ID for pagination - active: Filter by active status - coupon: Filter by coupon ID - code: Filter by exact code Returns: List of promotion codes

Get a promotion code by ID. Args: - promotion_code_id: The Promotion Code ID (promo_...) Returns: The promotion code details.

List transfers with pagination. Args: - limit: Number of results - starting_after: Transfer ID for pagination - destination: Filter by destination account ID Returns: List of transfers

Create a promotion code for a coupon. Args: - coupon: Coupon ID (required) - code: Custom code string (optional, auto-generated if not provided) - active: Whether the code is active - customer: Restrict to specific customer - expires_at: Unix timestamp expiration - max_redemptions: Maximum redemptions - metadata: Custom metadata Returns: The created promotion code.

Update a promotion code. Args: - promotion_code_id: The Promotion Code ID - active: New active status - metadata: New metadata Returns: The updated promotion code.

List tax rates with pagination. Args: - limit: Number of results - starting_after: Tax rate ID for pagination - active: Filter by active status Returns: List of tax rates

Get a tax rate by ID. Args: - tax_rate_id: The Tax Rate ID (txr_...) Returns: The tax rate details.

Create a new tax rate. Args: - display_name: Display name (required) - percentage: Tax percentage (required) - inclusive: Whether tax is inclusive (required) - active: Whether tax rate is active - country: Country code - description: Description - jurisdiction: Jurisdiction name - state: State code - metadata: Custom metadata Returns: The created tax rate.

Update a tax rate. Args: - tax_rate_id: The Tax Rate ID - active: New active status - description: New description - display_name: New display name - metadata: New metadata Returns: The updated tax rate.

List checkout sessions with pagination. Args: - limit: Number of results - starting_after: Session ID for pagination - customer: Filter by customer ID - payment_intent: Filter by PaymentIntent ID - subscription: Filter by subscription ID Returns: List of checkout sessions

Get a checkout session by ID. Args: - session_id: The Checkout Session ID (cs_...) Returns: The checkout session details.

Create a checkout session for hosted payment page. Args: - mode: "payment", "setup", or "subscription" (required) - success_url: Redirect URL after success - cancel_url: Redirect URL after cancel - line_items: Array of items to purchase - customer: Existing customer ID - customer_email: Customer email (for new customers) - metadata: Custom metadata - payment_method_types: Allowed payment methods - allow_promotion_codes: Allow promo codes Returns: The created checkout session with URL.

Expire a checkout session. Args: - session_id: The Checkout Session ID Returns: The expired session.

List connected accounts with pagination. Args: - limit: Number of results (1-100) - starting_after: Account ID for pagination Returns: List of connected accounts

Get a connected account by ID. Args: - account_id: The Account ID (acct_...) Returns: The account details.

Create a connected account. Args: - type: Account type ("custom", "express", or "standard") - country: Two-letter country code - email: Account holder email - capabilities: Requested capabilities - business_type: "company", "individual", etc. - metadata: Custom metadata Returns: The created account.

Update a connected account. Args: - account_id: The Account ID - email: New email - metadata: New metadata - business_profile: Business profile updates Returns: The updated account.

Get a transfer by ID. Args: - transfer_id: The Transfer ID (tr_...) Returns: The transfer details.

Create a transfer to a connected account. Args: - amount: Amount in cents (required) - currency: Currency code (required) - destination: Destination account ID (required) - description: Description - metadata: Custom metadata - source_transaction: Source charge/payment - transfer_group: Transfer group ID Returns: The created transfer.

List payouts with pagination. Args: - limit: Number of results - starting_after: Payout ID for pagination - status: Filter by status (pending, paid, failed, canceled) Returns: List of payouts

Get a payout by ID. Args: - payout_id: The Payout ID (po_...) Returns: The payout details.

Create a payout to your bank account. Args: - amount: Amount in cents (required) - currency: Currency code (required) - description: Description - destination: Destination bank account/card ID - metadata: Custom metadata - method: "standard" or "instant" Returns: The created payout.

Cancel a pending payout. Args: - payout_id: The Payout ID Returns: The canceled payout.

Reverse a payout (returns funds to Stripe balance). Args: - payout_id: The Payout ID - metadata: Custom metadata Returns: The reversed payout.

List customers from Stripe with pagination. Returns a paginated list of customers. Use starting_after from the last customer to fetch the next page. Args: - limit: Number of customers to return (1-100, default: 10) - starting_after: Customer ID to start after for pagination - email: Filter by email address Returns: List of customers with pagination info

Get a single customer by ID. Args: - customer_id: The Stripe customer ID (cus_...) Returns: The customer record with all available fields.

Create a new customer in Stripe. Args: - email: Email address - name: Customer name - phone: Phone number - description: Description of the customer - metadata: Key-value pairs for custom data Returns: The created customer record.

Update an existing customer. Args: - customer_id: The Stripe customer ID to update - email: New email address - name: New name - phone: New phone number - description: New description - metadata: New metadata (replaces existing) Returns: The updated customer record.

Delete a customer from Stripe. Args: - customer_id: The Stripe customer ID to delete Returns: Confirmation of deletion.

Search for customers using Stripe's search syntax. Query syntax examples: - email:"test@example.com" - name~"John" - metadata["key"]:"value" - created>1609459200 Args: - query: Search query string - limit: Maximum results to return Returns: List of matching customers.

List payment intents with pagination. Args: - limit: Number of results (1-100, default: 10) - starting_after: PaymentIntent ID for pagination - customer: Filter by customer ID Returns: List of payment intents

List invoices with pagination. Args: - limit: Number of results (1-100) - starting_after: Invoice ID for pagination - customer: Filter by customer ID - subscription: Filter by subscription ID - status: Filter by status (draft, open, paid, uncollectible, void) Returns: List of invoices

Create a new invoice. Args: - customer: Customer ID (required) - subscription: Subscription ID (optional) - description: Invoice description - metadata: Custom metadata - auto_advance: Auto-finalize after 1 hour - collection_method: "charge_automatically" or "send_invoice" - days_until_due: Days until due (for send_invoice) Returns: The created invoice.

Update an invoice (draft only for some fields). Args: - invoice_id: The Invoice ID - description: New description - metadata: New metadata - auto_advance: Whether to auto-advance Returns: The updated invoice.

Delete a draft invoice. Args: - invoice_id: The Invoice ID Returns: Confirmation of deletion.

Finalize a draft invoice (makes it ready to pay). Args: - invoice_id: The Invoice ID Returns: The finalized invoice.

Pay an open invoice. Args: - invoice_id: The Invoice ID - payment_method: Payment method ID (optional) Returns: The paid invoice.

Send an invoice to the customer (for manual collection). Args: - invoice_id: The Invoice ID Returns: The sent invoice.

Void an open invoice. Args: - invoice_id: The Invoice ID Returns: The voided invoice.

Mark an invoice as uncollectible. Args: - invoice_id: The Invoice ID Returns: The uncollectible invoice.

Search invoices using Stripe search syntax. Query examples: - status:"paid" - customer:"cus_xxx" - total>1000 Args: - query: Search query - limit: Maximum results Returns: List of matching invoices.

List invoice items with pagination. Args: - limit: Number of results - starting_after: Invoice item ID for pagination - customer: Filter by customer ID - invoice: Filter by invoice ID Returns: List of invoice items

Get an invoice item by ID. Args: - invoice_item_id: The Invoice Item ID (ii_...) Returns: The invoice item details.

Create an invoice item (line item for a future invoice). Args: - customer: Customer ID (required) - amount: Amount in cents - currency: Currency code - description: Description - invoice: Add to specific invoice - price: Use a price ID instead of amount - quantity: Quantity (for price-based) - metadata: Custom metadata Returns: The created invoice item.

Update an invoice item. Args: - invoice_item_id: The Invoice Item ID - amount: New amount - description: New description - metadata: New metadata - quantity: New quantity Returns: The updated invoice item.

Delete an invoice item. Args: - invoice_item_id: The Invoice Item ID Returns: Confirmation of deletion.

Get a payment intent by ID. Args: - payment_intent_id: The PaymentIntent ID (pi_...) Returns: The payment intent details.

Create a new payment intent. Args: - amount: Amount in smallest currency unit (e.g., cents for USD) - currency: Three-letter ISO currency code (e.g., "usd") - customer: Customer ID to attach payment to - description: Description for the payment - metadata: Custom key-value data - payment_method_types: Allowed payment methods (default: ["card"]) - capture_method: "automatic" or "manual" Returns: The created PaymentIntent with client_secret for frontend.

Update a payment intent. Args: - payment_intent_id: The PaymentIntent ID - amount: New amount - currency: New currency - customer: New customer ID - description: New description - metadata: New metadata Returns: The updated PaymentIntent.

Confirm a payment intent to proceed with payment. Args: - payment_intent_id: The PaymentIntent ID Returns: The confirmed PaymentIntent.

Capture a PaymentIntent that was created with capture_method=manual. Args: - payment_intent_id: The PaymentIntent ID - amount_to_capture: Amount to capture (optional, defaults to full amount) Returns: The captured PaymentIntent.

Cancel a payment intent. Args: - payment_intent_id: The PaymentIntent ID Returns: The canceled PaymentIntent.

Search payment intents using Stripe search syntax. Query examples: - status:"succeeded" - customer:"cus_xxx" - amount>1000 Args: - query: Search query - limit: Maximum results Returns: List of matching payment intents.

List setup intents for saving payment methods. Args: - limit: Number of results (1-100) - starting_after: SetupIntent ID for pagination - customer: Filter by customer ID Returns: List of setup intents

Get a setup intent by ID. Args: - setup_intent_id: The SetupIntent ID (seti_...) Returns: The setup intent details.

Create a setup intent for saving a payment method. Args: - customer: Customer ID to save payment method for - description: Description - metadata: Custom metadata - payment_method_types: Allowed payment method types - usage: "off_session" or "on_session" Returns: The created SetupIntent with client_secret.

Cancel a setup intent. Args: - setup_intent_id: The SetupIntent ID Returns: The canceled SetupIntent.

List charges with pagination. Args: - limit: Number of results (1-100) - starting_after: Charge ID for pagination - customer: Filter by customer ID - payment_intent: Filter by PaymentIntent ID Returns: List of charges

Get a charge by ID. Args: - charge_id: The Charge ID (ch_...) Returns: The charge details.

Update a charge's description or metadata. Args: - charge_id: The Charge ID - description: New description - metadata: New metadata Returns: The updated charge.

Search charges using Stripe search syntax. Query examples: - status:"succeeded" - customer:"cus_xxx" - amount>1000 Args: - query: Search query - limit: Maximum results Returns: List of matching charges.

List refunds with pagination. Args: - limit: Number of results (1-100) - starting_after: Refund ID for pagination - charge: Filter by charge ID - payment_intent: Filter by PaymentIntent ID Returns: List of refunds

Get a refund by ID. Args: - refund_id: The Refund ID (re_...) Returns: The refund details.

Create a refund for a charge or payment intent. Args: - charge: Charge ID to refund (or use payment_intent) - payment_intent: PaymentIntent ID to refund (or use charge) - amount: Amount to refund in cents (optional, full amount if not specified) - reason: Reason for refund (duplicate, fraudulent, requested_by_customer) - metadata: Custom metadata Returns: The created refund.

Cancel a refund (only possible if not yet processed). Args: - refund_id: The Refund ID Returns: The canceled refund.

List payment methods for a customer. Args: - customer: Customer ID (required) - type: Payment method type (e.g., "card") - limit: Number of results Returns: List of payment methods

Get a payment method by ID. Args: - payment_method_id: The PaymentMethod ID (pm_...) Returns: The payment method details.

Attach a payment method to a customer. Args: - payment_method_id: The PaymentMethod ID - customer: Customer ID to attach to Returns: The attached payment method.

Detach a payment method from its customer. Args: - payment_method_id: The PaymentMethod ID Returns: The detached payment method.

List disputes with pagination. Args: - limit: Number of results (1-100) - starting_after: Dispute ID for pagination - charge: Filter by charge ID - payment_intent: Filter by PaymentIntent ID Returns: List of disputes

Get a dispute by ID. Args: - dispute_id: The Dispute ID (dp_...) Returns: The dispute details.

Close a dispute (accept the dispute and stop contesting). Args: - dispute_id: The Dispute ID Returns: The closed dispute.

List products with pagination. Args: - limit: Number of results (1-100) - starting_after: Product ID for pagination - active: Filter by active status Returns: List of products

Get a product by ID. Args: - product_id: The Product ID (prod_...) Returns: The product details.

Create a new product. Args: - name: Product name (required) - description: Product description - active: Whether the product is active - metadata: Custom metadata - images: Array of image URLs - url: Product URL Returns: The created product.

Update a product. Args: - product_id: The Product ID - name: New name - description: New description - active: New active status - metadata: New metadata - images: New image URLs Returns: The updated product.

Search products using Stripe search syntax. Query examples: - name~"Premium" - active:"true" - metadata["type"]:"subscription" Args: - query: Search query - limit: Maximum results Returns: List of matching products.

List prices with pagination. Args: - limit: Number of results (1-100) - starting_after: Price ID for pagination - active: Filter by active status - product: Filter by product ID - type: Filter by type ("one_time" or "recurring") Returns: List of prices

Get a price by ID. Args: - price_id: The Price ID (price_...) Returns: The price details.

Create a new price for a product. Args: - product: Product ID (required) - currency: Three-letter currency code (required) - unit_amount: Price in cents - recurring: For subscriptions - { interval: "day"|"week"|"month"|"year", interval_count?: number } - active: Whether the price is active - nickname: A brief description - metadata: Custom metadata Returns: The created price.

Update a price (only active, nickname, and metadata can be updated). Args: - price_id: The Price ID - active: New active status - nickname: New nickname - metadata: New metadata Returns: The updated price.

Search prices using Stripe search syntax. Query examples: - product:"prod_xxx" - active:"true" - type:"recurring" Args: - query: Search query - limit: Maximum results Returns: List of matching prices.

List subscriptions with pagination. Args: - limit: Number of results (1-100) - starting_after: Subscription ID for pagination - customer: Filter by customer ID - price: Filter by price ID - status: Filter by status (active, past_due, canceled, etc.) Returns: List of subscriptions

Get a subscription by ID. Args: - subscription_id: The Subscription ID (sub_...) Returns: The subscription details.

Create a new subscription. Args: - customer: Customer ID (required) - items: Array of { price: "price_id", quantity?: number } (required) - default_payment_method: Payment method ID - collection_method: "charge_automatically" or "send_invoice" - days_until_due: Days until invoice is due (for send_invoice) - metadata: Custom metadata - trial_period_days: Number of trial days - cancel_at_period_end: Whether to cancel at period end Returns: The created subscription.

Update a subscription. Args: - subscription_id: The Subscription ID - items: New items array (to change plans/quantities) - default_payment_method: New payment method - metadata: New metadata - cancel_at_period_end: Whether to cancel at period end - proration_behavior: "create_prorations", "none", or "always_invoice" Returns: The updated subscription.

Cancel a subscription. Args: - subscription_id: The Subscription ID - invoice_now: Generate final invoice immediately - prorate: Prorate the cancellation Returns: The canceled subscription.

Resume a paused subscription. Args: - subscription_id: The Subscription ID Returns: The resumed subscription.

Search subscriptions using Stripe search syntax. Query examples: - status:"active" - customer:"cus_xxx" - metadata["plan"]:"premium" Args: - query: Search query - limit: Maximum results Returns: List of matching subscriptions.

List items in a subscription. Args: - subscription: Subscription ID (required) - limit: Number of results Returns: List of subscription items

Get a subscription item by ID. Args: - subscription_item_id: The Subscription Item ID (si_...) Returns: The subscription item details.

Add an item to an existing subscription. Args: - subscription: Subscription ID (required) - price: Price ID (required) - quantity: Quantity - metadata: Custom metadata Returns: The created subscription item.

Update a subscription item. Args: - subscription_item_id: The Subscription Item ID - price: New price ID - quantity: New quantity - metadata: New metadata Returns: The updated subscription item.

Remove an item from a subscription. Args: - subscription_item_id: The Subscription Item ID Returns: Confirmation of deletion.

List plans (legacy, use prices instead). Args: - limit: Number of results - starting_after: Plan ID for pagination - active: Filter by active status - product: Filter by product ID Returns: List of plans

Get a plan by ID (legacy, use prices instead). Args: - plan_id: The Plan ID Returns: The plan details.