> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Stripe **Authentication:** secret API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * List failed payments in the last 7 days over \$500 and group by failure code. * Issue a refund for charge `ch_12345` for the full amount and email the customer. * Pull MRR by plan as of the end of last month. ## Available Tools #### retrieve\_balance Retrieve the current balance of your Stripe account showing available and pending amounts by currency. Shows funds available for payout and funds pending from recent transactions. #### list\_balance\_transactions List all balance transactions with pagination and filtering by date, currency, payout, or transaction type. Shows detailed history of all funds movement including charges, refunds, payouts, and fees. #### retrieve\_balance\_transaction Retrieve complete details of a specific balance transaction including fees, net amount, and source information #### create\_charge Create a charge to process an immediate payment from a customer using a saved payment source. #### retrieve\_charge Retrieve complete details of a specific charge by ID including amount, status, receipt URL, and refund information #### update\_charge Update charge metadata, description, receipt email, or shipping information after the charge has been created #### capture\_charge Capture a previously authorized charge to complete the payment and transfer funds from customer account to your account #### list\_charges List all charges with cursor-based pagination and filtering by customer, payment intent, or creation date #### search\_charges Search charges using Stripe's query syntax to find charges by amount, customer, status, or metadata fields #### create\_coupon Create a new coupon for discounts and promotions. #### retrieve\_coupon Retrieve complete details of a specific coupon including usage statistics and validity. #### update\_coupon Update coupon properties including name and metadata. #### delete\_coupon Delete a coupon permanently to prevent future use. #### list\_coupons List all coupons with pagination and optional filtering by creation date. #### create\_customer Create a new Stripe customer with email, payment details, and custom metadata for subscription and payment management #### retrieve\_customer Retrieve complete details of a specific Stripe customer by ID including balance, payment methods, and subscription status #### update\_customer Update an existing Stripe customer's information including email, address, metadata, and default payment source #### delete\_customer Permanently delete a Stripe customer and cancel all active subscriptions associated with the account #### list\_customers List all Stripe customers with cursor-based pagination, filtering by email or creation date, up to 100 per page #### search\_customers Search Stripe customers using query syntax to find customers by email, name, phone, or custom metadata fields #### list\_customer\_balance\_transactions Retrieve all balance transactions for a Stripe customer showing account credits, debits, and balance changes over time #### create\_customer\_balance\_transaction Create a balance transaction to add credit or debit to a customer's Stripe account for future invoice payments #### retrieve\_dispute Retrieve complete details of a specific dispute including evidence, status, and charge information #### update\_dispute Update dispute evidence and metadata to respond to a chargeback or inquiry #### close\_dispute Close a dispute as lost, accepting the chargeback and preventing further evidence submission #### list\_disputes List all disputes with pagination and optional filtering by charge, payment intent, or creation date #### retrieve\_event Retrieve complete details of a specific webhook event including the triggering object and request information #### list\_events List all webhook events with pagination and optional filtering by creation date, delivery status, or event type #### create\_invoice Create a new invoice for a customer. #### retrieve\_invoice Retrieve complete details of a specific invoice including status, line items, and payment information. #### update\_invoice Update invoice properties including description, metadata, payment settings, and due date. #### pay\_invoice Pay an invoice using the customer's default payment method or specified payment method. #### finalize\_invoice Finalize a draft invoice to make it ready for payment and prevent further modifications. #### send\_invoice Send an invoice to the customer via email with a link to pay online. #### void\_invoice Void an open invoice to mark it as uncollectible and prevent further collection attempts. #### list\_invoices List all invoices with pagination and optional filtering by customer, subscription, status, or other criteria. #### search\_invoices Search invoices using powerful query syntax to find invoices by customer, amount, status, metadata, or other properties. #### delete\_invoice Delete a draft invoice permanently to prevent it from being finalized or sent to customers. #### mark\_invoice\_uncollectible Mark an invoice as uncollectible to indicate that collection attempts should cease. #### retrieve\_upcoming\_invoice Retrieve a preview of the upcoming invoice for a customer or subscription before it is created. #### create\_payment\_intent Create a payment intent to track the complete payment lifecycle from creation through confirmation and settlement. #### retrieve\_payment\_intent Retrieve complete details of an existing payment intent including status, amount, payment method, and next required actions #### update\_payment\_intent Update payment intent properties including amount, currency, payment method, description, or metadata before confirmation. #### confirm\_payment\_intent Confirm a payment intent to attempt payment using the attached payment method and advance through authentication if required. #### capture\_payment\_intent Capture a payment intent that was created with manual capture method to finalize payment and transfer funds. #### cancel\_payment\_intent Cancel a payment intent to prevent payment processing and release any authorized funds back to the customer immediately #### list\_payment\_intents List all payment intents with pagination and optional filtering by customer, status, or creation date #### search\_payment\_intents Search payment intents using powerful query syntax to find payments by amount, customer, status, metadata, or other properties #### create\_payment\_method Create a new payment method. #### retrieve\_payment\_method Retrieve complete details of a specific payment method including card information and billing details #### update\_payment\_method Update payment method billing information, metadata, or card details for an existing payment method. #### list\_payment\_methods List all payment methods for a specific customer with pagination and filtering by payment method type. Prefer list\_customer\_payment\_methods as the canonical customer payment method discovery flow. #### attach\_payment\_method Attach a payment method to a customer for use in future payments and recurring subscription billing. #### detach\_payment\_method Detach a payment method from a customer to remove it from their available payment options #### list\_customer\_payment\_methods List all payment methods attached to a specific customer with type filtering and pagination support. #### create\_payout Create a payout to transfer funds from your Stripe balance to your bank account or debit card #### retrieve\_payout Retrieve complete details of a specific payout including status, amount, and destination information #### update\_payout Update payout metadata for record keeping and tracking purposes #### cancel\_payout Cancel a pending payout before it is processed to prevent funds from being transferred #### reverse\_payout Reverse a completed payout to return funds back to your Stripe balance #### list\_payouts List all payouts with pagination and optional filtering by arrival date, creation date, destination, or status #### create\_price Create a new price for a product with specified currency, amount, and billing configuration #### retrieve\_price Retrieve complete details of a specific price including billing configuration and product association #### update\_price Update price properties including active status, metadata, and currency options #### list\_prices List all prices with pagination and optional filtering by product, currency, type, or other criteria #### search\_prices Search prices using powerful query syntax to find prices by product, currency, amount, metadata, or other properties #### create\_product Create a new product in your catalog with name, description, pricing, and metadata #### retrieve\_product Retrieve complete details of a specific product including pricing, images, and metadata #### update\_product Update product properties including name, description, images, pricing, and metadata #### delete\_product Delete a product from your catalog to prevent it from being used in new purchases #### list\_products List all products with pagination and optional filtering by active status, type, or other criteria #### search\_products Search products using powerful query syntax to find products by name, description, metadata, or other properties #### create\_refund Create a refund for a charge or payment intent to return funds to the customer #### retrieve\_refund Retrieve complete details of a specific refund including status, amount, and failure information #### update\_refund Update refund metadata for record keeping and tracking purposes #### list\_refunds List all refunds with pagination and optional filtering by charge, payment intent, or creation date #### cancel\_refund Cancel a pending refund before it is processed to prevent funds from being returned to the customer #### create\_subscription\_item Create a new subscription item to add products or services to an existing subscription #### retrieve\_subscription\_item Retrieve complete details of a specific subscription item including price, quantity, and billing information #### update\_subscription\_item Update subscription item properties including price, quantity, billing thresholds, and metadata #### delete\_subscription\_item Delete a subscription item to remove it from the subscription and stop billing for that item #### list\_subscription\_items List all subscription items for a specific subscription with pagination support #### create\_subscription Create a new subscription for a customer with specified items, billing cycle, and payment settings. #### retrieve\_subscription Retrieve complete details of a specific subscription including status, items, and billing information #### update\_subscription Update subscription properties including items, payment method, billing settings, and metadata. #### cancel\_subscription Cancel a subscription immediately or at the end of the current billing period. #### list\_subscriptions List all subscriptions with pagination and optional filtering by customer, status, or other criteria #### search\_subscriptions Search subscriptions using powerful query syntax to find subscriptions by customer, status, metadata, or other properties #### resume\_subscription Resume a paused subscription to restart billing and service delivery