@kentcdodds/stripe

@kentcdodds/stripe

Intent

Full-surface Stripe helpers so Kody agents can read and manage customers, payments, invoices, subscriptions, products, prices, payment links, refunds, payouts, and balance on the owner's Stripe account without hand-rolling API calls. Reads are free-form; money-moving and destructive mutations are guarded behind an explicit confirm: true input.

Required setup

• stripeSecretKey secret (user scope) — a Stripe secret key (sk_...) or restricted key (rk_...) from dashboard.stripe.com/apikeys with the scopes you want available
• Host approvals for api.stripe.com and files.stripe.com in the account security UI
• Approval for this package to use the stripeSecretKey secret (account secrets UI)

Exports

• kody:@kentcdodds/stripe — action dispatcher (defaults to smoke-test); also re-exports every helper below
• kody:@kentcdodds/stripe/account — getAccount, getBalance, listBalanceTransactions, listPayouts, listEvents
• kody:@kentcdodds/stripe/customers — listCustomers, searchCustomers, getCustomer, createCustomer, updateCustomer, deleteCustomer
• kody:@kentcdodds/stripe/payments — listPaymentIntents, getPaymentIntent, searchPaymentIntents, listCharges, getCharge, searchCharges, listRefunds, createRefund
• kody:@kentcdodds/stripe/invoices — listInvoices, getInvoice, searchInvoices, createInvoice, finalizeInvoice, sendInvoice, voidInvoice, deleteDraftInvoice
• kody:@kentcdodds/stripe/subscriptions — listSubscriptions, getSubscription, searchSubscriptions, createSubscription, cancelSubscription
• kody:@kentcdodds/stripe/products — listProducts, getProduct, createProduct, archiveProduct, listPrices, createPrice, listPaymentLinks, createPaymentLink, deactivatePaymentLink
• kody:@kentcdodds/stripe/smoke-test — read-only account/balance/sample smoke test

The root export also exposes the low-level transport (stripeRequest, stripeList, stripeSearch, stripeParams, stripeUploadFile, StripeApiError, formatStripeAmount, stripeDate) for any endpoint the typed helpers do not cover. stripeRequest accepts { path, method, query, body, idempotencyKey } and stays pinned to https://api.stripe.com/v1.

Safety model

• Reads and searches never require confirmation.
• createRefund, createSubscription, cancelSubscription, finalizeInvoice, sendInvoice, voidInvoice, deleteDraftInvoice, deleteCustomer, archiveProduct, and deactivatePaymentLink throw unless called with confirm: true.
• POST helpers accept an optional idempotencyKey and only retry automatically when one is provided.
• Amounts are Stripe integer amounts in the smallest currency unit (cents for USD); summaries include a human-readable display string.

Example

import stripe from 'kody:@kentcdodds/stripe'

export default async function main() {
	return await stripe({
		action: 'search-charges',
		searchQuery: "billing_details.email:'ada@example.com'",
		maxItems: 10,
	})
}