> This page is for Workforce. > 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