Home / Servers / Stripe API / post_customers_customer_balance_transactions

Create a customer balance transaction

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Create a customer balance transaction Creates an immutable transaction that updates the customer’s credit balance . [POST /v1/customers/{customer}/balance_transactions]

Name on the gateway: stripe_api__post_customers_customer_balance_transactions · may change things.

Parameters

NameTypeDescription
customer requiredstringcustomer parameter
amount requiredintegerThe integer amount in **cents (or local equivalent)** to apply to the…
currency requiredstringThree-letter ISO currency code, in lowercase. Must be a supported currency.…
descriptionstringAn arbitrary string attached to the object. Often useful for displaying to…
expandarraySpecifies which fields in the response should be expanded.
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__post_customers_customer_balance_transactions",
  "arguments": {
    "customer": "…",
    "amount": 0,
    "currency": "…"
  }
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the create a customer balance transaction tool with customer set to ….

More from Stripe API