pp-stripe

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Stripe — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the

stripe-pp-cli

binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install stripe --cli-only

Verify:
```
stripe-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

bash

go install github.com/mvanhorn/printing-press-library/library/payments/stripe/cmd/stripe-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

stripe-pp-cli matches the official stripe-cli verb-for-verb and adds what it deliberately omits: a local mirror of customers, subscriptions, invoices, charges, payouts, and events with FTS5 search; cross-entity SQL queries (

sql

); and dossier commands (

health

dunning-queue

customer-360

subs-at-risk

payout-reconcile

). Built for agents — every command is one-shot, one-shot, and emits structured output.

本技能基于

stripe-pp-cli

二进制文件运行。在调用本技能的任何命令之前，必须确认CLI已安装。如果未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install stripe --cli-only

验证安装：
```
stripe-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等情况），可改用Go直接安装（要求Go 1.26.3或更高版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/payments/stripe/cmd/stripe-pp-cli@latest

如果安装后执行

--version

提示“command not found”，说明安装步骤未将二进制文件添加到

$PATH

中。请在验证成功前不要执行技能命令。

stripe-pp-cli与官方stripe-cli命令完全兼容，并额外提供了官方工具刻意省略的功能：客户、订阅、发票、收费、付款和事件的本地镜像（支持FTS5搜索）；跨实体SQL查询（

sql

命令）；以及档案命令（

health

、

dunning-queue

、

customer-360

、

subs-at-risk

、

payout-reconcile

）。专为Agent设计——每个命令都是一次性执行，输出结构化数据。

When to Use This CLI

何时使用本CLI

Reach for stripe-pp-cli when you need to (1) run analytics across customers/subs/invoices that Stripe's dashboard doesn't expose, (2) script payment ops in a CI/agent loop without daemon processes, (3) reconcile payouts and balance transactions, or (4) feed Stripe state into a non-Stripe system (CRM, accounting, outreach automation).

在以下场景中使用stripe-pp-cli：(1) 需要运行Stripe仪表板未公开的客户/订阅/发票跨维度分析；(2) 在CI/Agent循环中编写支付操作脚本，无需守护进程；(3) 对账付款和余额交易；(4) 将Stripe状态同步到非Stripe系统（CRM、会计系统、触达自动化工具）。

When NOT to Use This CLI (anti-triggers)

何时不应使用本CLI（反触发场景）

Do not use stripe-pp-cli for:

Live-mode bulk writes you have not audited. Mutating commands (POST/PUT/PATCH/DELETE) against an
```
sk_live_...
```
key are blocked by default with a clear error; pass
```
--confirm-live
```
(or set
```
STRIPE_CONFIRM_LIVE=1
```
) once you have audited the invocation. Prefer
```
sk_test_...
```
for development regardless.
In-person Terminal payments.
```
terminal
```
resource commands are present but Stripe Terminal SDK is not in scope. Use the Terminal iOS/Android SDK.
Stripe Issuing card management workflows.
```
issuing
```
commands are REST passthrough only; spending controls, dispute evidence packages not built. Use the Stripe Dashboard.
Stripe Tax registration.
```
tax-rates
```
CRUD only; jurisdiction registration not in scope. Use Stripe Tax in Dashboard.
Connect platform fan-out across many connected accounts. Single account at a time via
```
Stripe-Account
```
header. Multi-account loops via external script.
Local mock-server testing. Use stripe-mock directly via
```
STRIPE_BASE_URL=http://localhost:12111
```
.

请勿在以下场景中使用stripe-pp-cli：

未经审计的生产环境批量写入操作。默认情况下，使用
```
sk_live_...
```
密钥执行的变更命令（POST/PUT/PATCH/DELETE）会被阻止并显示明确错误；在审计调用内容后，可通过传递
```
--confirm-live
```
参数（或设置环境变量
```
STRIPE_CONFIRM_LIVE=1
```
）解除限制。无论如何，开发环境优先使用
```
sk_test_...
```
密钥。
线下终端支付。虽然包含
```
terminal
```
资源命令，但Stripe Terminal SDK不在本工具范围内，请使用Terminal iOS/Android SDK。
Stripe发卡卡管理流程。
```
issuing
```
命令仅作为REST接口透传；支出控制、争议证据包功能未实现，请使用Stripe仪表板。
Stripe税务注册。仅支持
```
tax-rates
```
的CRUD操作；辖区注册不在本工具范围内，请使用仪表板中的Stripe Tax功能。
Connect平台多账户批量操作。每次仅支持单个账户（通过
```
Stripe-Account
```
头指定）。多账户循环操作需通过外部脚本实现。
本地模拟服务器测试。通过设置
```
STRIPE_BASE_URL=http://localhost:12111
```
直接使用stripe-mock。

Not Yet Wired (deferred to v0.2)

尚未实现的功能（计划在v0.2版本中支持）

Area	Status	Workaround
Stripe Issuing (full workflow)	endpoint passthrough only	Use Stripe Dashboard
Stripe Terminal (in-person SDK)	endpoint passthrough only	Use Terminal SDK
Stripe Tax registration	`tax-rates` CRUD only	Use Stripe Tax in Dashboard
`localstripe` mock server	out of scope	Use `stripe-mock` via `STRIPE_BASE_URL`
Connect account fan-out	single-account at a time	External script loops

领域	状态	替代方案
Stripe发卡（完整流程）	仅接口透传	使用Stripe仪表板
Stripe Terminal（线下SDK）	仅接口透传	使用Terminal SDK
Stripe税务注册	仅支持 `tax-rates` 的CRUD	使用仪表板中的Stripe Tax功能
`localstripe` 模拟服务器	不在范围内	通过 `STRIPE_BASE_URL` 使用 `stripe-mock`
Connect平台多账户批量操作	每次仅支持单个账户	外部脚本循环实现

Unique Capabilities

独特功能

These capabilities aren't available in any other tool for this API.

这些功能是其他Stripe API工具所不具备的。

Local state that compounds

可累积的本地状态

health
— Compute a 0-100 health score for one or many customers from local SQLite, factoring in failed-payment count, dispute history, MRR contribution, subscription status, and account age.
Use this to feed customer-health signals into outreach, dunning, and renewal automation without burning hundreds of API calls per customer.
bash
```
stripe-pp-cli health cus_xyz --json --select score,failed_payments,mrr_contribution
```
dunning-queue
— List invoices in past_due/uncollectible state ranked by days-overdue, with last failure reason and customer email pulled from the local store.
When deciding which customers to follow up with about failed payments, this beats walking the Stripe dashboard or chaining 4+ API calls per row.
bash
```
stripe-pp-cli dunning-queue --json --select invoice,customer_email,days_overdue,last_failure_reason
```
sql
— Run read-only SQLite queries against the local Stripe mirror. All synced data lives in a generic 'resources' table — query with json_extract(data, '$.field') and filter by resource_type.
When a one-off question doesn't fit the canned commands, drop into SQL instead of writing a script that hits the API a thousand times.
bash
```
stripe-pp-cli sql "SELECT json_extract(data,'$.email') AS email, COUNT(*) AS active_subs FROM resources WHERE resource_type='subscriptions' AND json_extract(data,'$.status')='active' GROUP BY json_extract(data,'$.customer') HAVING active_subs > 1" --json
```
payout-reconcile
— Join payouts to balance_transactions to charges to customers from local store; flag missing balance_transactions and mismatches; CSV export.
Use this for end-of-period payout reconciliation against bank statements or accounting systems — replaces the manual CSV-pivot ritual.
bash
```
stripe-pp-cli payout-reconcile --since 7d --csv
```
subs-at-risk
— List subscriptions whose default payment method's card expires in a window, sorted by current MRR contribution.
Use this monthly to proactively email customers whose card is about to expire — prevents involuntary churn.
bash
```
stripe-pp-cli subs-at-risk --within 30d --json --select customer_email,mrr,card_exp
```
metadata-grep
— Search every synced resource's metadata bag for a key/value across resource types; returns (resource_type, id, matched_kv) rows.
When integrating Stripe with a CRM via metadata tags, this finds every related resource in one query.
bash
```
stripe-pp-cli metadata-grep 'crm_id=acme-001' --json
```

health
— 基于本地SQLite计算单个或多个客户的0-100健康评分，考量因素包括失败支付次数、争议历史、MRR贡献、订阅状态和账户存续时间。
使用此功能可将客户健康信号同步到触达、催款和续订自动化系统，无需为每个客户调用数百次API。
bash
```
stripe-pp-cli health cus_xyz --json --select score,failed_payments,mrr_contribution
```
dunning-queue
— 列出处于逾期/无法收回状态的发票，按逾期天数排序，并从本地存储中提取最后失败原因和客户邮箱。
在决定跟进哪些逾期付款客户时，此功能比手动浏览Stripe仪表板或为每一行数据链式调用4+次API更高效。
bash
```
stripe-pp-cli dunning-queue --json --select invoice,customer_email,days_overdue,last_failure_reason
```
sql
— 对本地Stripe镜像执行只读SQL查询。所有同步数据存储在通用的'resources'表中——使用json_extract(data, '$.field')查询字段，并按resource_type过滤。
当一次性查询需求无法通过预设命令满足时，直接使用SQL查询，无需编写调用上千次API的脚本。
bash
```
stripe-pp-cli sql "SELECT json_extract(data,'$.email') AS email, COUNT(*) AS active_subs FROM resources WHERE resource_type='subscriptions' AND json_extract(data,'$.status')='active' GROUP BY json_extract(data,'$.customer') HAVING active_subs > 1" --json
```
payout-reconcile
— 从本地存储关联付款、余额交易、收费和客户数据；标记缺失的余额交易和不匹配项；支持CSV导出。
使用此功能可在期末将付款与银行对账单或会计系统对账——替代手动CSV透视的繁琐流程。
bash
```
stripe-pp-cli payout-reconcile --since 7d --csv
```
subs-at-risk
— 列出默认支付方式卡片将在指定窗口期过期的订阅，按当前MRR贡献排序。
每月使用此功能主动向卡片即将过期的客户发送邮件——减少非自愿流失。
bash
```
stripe-pp-cli subs-at-risk --within 30d --json --select customer_email,mrr,card_exp
```
metadata-grep
— 跨资源类型搜索所有同步资源的metadata中的键/值对；返回(resource_type, id, matched_kv)行数据。
当通过metadata标签将Stripe与CRM集成时，此功能可通过一次查询找到所有相关资源。
bash
```
stripe-pp-cli metadata-grep 'crm_id=acme-001' --json
```

Agent-native plumbing

原生Agent适配

customer-360
— One-shot dossier: customer profile + active subs + recent invoices + payment methods + recent charges + open disputes + lifetime spend.
Use this as the first command when investigating a customer ticket, support escalation, or churn risk — full context in one call.
bash
```
stripe-pp-cli customer-360 alice@example.com --json --compact
```
events-since
— Fetch all Events since a cursor, persist new cursor in profile, no daemon. One-shot replacement for stripe-cli's listen daemon.
Use this in cron-driven agent loops to replay only new events since the last run — no daemon to babysit, no missed events.
bash
```
stripe-pp-cli events-since --type 'invoice.*' --json --select id,type,created,data.object.id
```

customer-360
— 一次性生成客户档案：客户信息 + 活跃订阅 + 近期发票 + 支付方式 + 近期收费 + 未解决争议 + 终身消费。
在处理客户工单、支持升级或流失风险调查时，将此作为第一个命令执行——一次调用获取完整上下文。
bash
```
stripe-pp-cli customer-360 alice@example.com --json --compact
```
events-since
— 获取指定游标后的所有事件，在配置文件中保存新游标，无需守护进程。替代stripe-cli的listen守护进程的一次性解决方案。
在定时Agent循环中使用此功能，仅重放自上次运行以来的新事件——无需维护守护进程，不会遗漏事件。
bash
```
stripe-pp-cli events-since --type 'invoice.*' --json --select id,type,created,data.object.id
```

Command Reference

命令参考

account — Manage account

```
stripe-pp-cli account
```
— Retrieves the details of an account.

account-links — Manage account links

```
stripe-pp-cli account-links
```
— Creates an AccountLink object that includes a single-use Stripe URL that the platform can redirect their user to...

account-sessions — Manage account sessions

```
stripe-pp-cli account-sessions
```
— Creates a AccountSession object that includes a single-use token that the platform can use on their front-end to...

accounts — Manage accounts

```
stripe-pp-cli accounts delete
```
— With <a href='/connect'>Connect</a>, you can delete accounts you manage. Test-mode accounts can be deleted...
```
stripe-pp-cli accounts get
```
— Returns a list of accounts connected to your platform via <a href='/docs/connect'>Connect</a>. If you’re not a...
```
stripe-pp-cli accounts get-account
```
— Retrieves the details of an account.
```
stripe-pp-cli accounts post
```
— With <a href='/docs/connect'>Connect</a>, you can create Stripe accounts for your users. To do this, you’ll...
```
stripe-pp-cli accounts post-account
```
— Updates a <a href='/connect/accounts'>connected account</a> by setting the values of the parameters passed. Any...

apple-pay — Manage apple pay

stripe-pp-cli apple-pay delete-domains-domain

— Delete an apple pay domain.

```
stripe-pp-cli apple-pay get-domains
```
— List apple pay domains.

stripe-pp-cli apple-pay get-domains-domain

— Retrieve an apple pay domain.

```
stripe-pp-cli apple-pay post-domains
```
— Create an apple pay domain.

application-fees — Manage application fees

```
stripe-pp-cli application-fees get
```
— Returns a list of application fees you’ve previously collected. The application fees are returned in sorted...
```
stripe-pp-cli application-fees get-id
```
— Retrieves the details of an application fee that your account has collected. The same information is returned...

apps — Manage apps

```
stripe-pp-cli apps get-secrets
```
— List all secrets stored on the given scope.
```
stripe-pp-cli apps get-secrets-find
```
— Finds a secret in the secret store by name and scope.
```
stripe-pp-cli apps post-secrets
```
— Create or replace a secret in the secret store.
```
stripe-pp-cli apps post-secrets-delete
```
— Deletes a secret from the secret store by name and scope.

balance — Manage balance

```
stripe-pp-cli balance
```
— Retrieves the current account balance, based on the authentication that was used to make the request. For a...

balance-settings — Manage balance settings

```
stripe-pp-cli balance-settings get
```
— Retrieves balance settings for a given connected account. Related guide: <a href='/connect/authentication'>Making...
```
stripe-pp-cli balance-settings post
```
— Updates balance settings for a given connected account. Related guide: <a href='/connect/authentication'>Making...

balance-transactions — Manage balance transactions

```
stripe-pp-cli balance-transactions get
```
— Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and...
```
stripe-pp-cli balance-transactions get-id
```
— Retrieves the balance transaction with the given ID. Note that this endpoint previously used the path...

billing — Manage billing

```
stripe-pp-cli billing get-alerts
```
— Lists billing active and inactive alerts
```
stripe-pp-cli billing get-alerts-id
```
— Retrieves a billing alert given an ID
```
stripe-pp-cli billing get-credit-balance-summary
```
— Retrieves the credit balance summary for a customer.
```
stripe-pp-cli billing get-credit-balance-transactions
```
— Retrieve a list of credit balance transactions.

stripe-pp-cli billing get-credit-balance-transactions-id

— Retrieves a credit balance transaction.

```
stripe-pp-cli billing get-credit-grants
```
— Retrieve a list of credit grants.

stripe-pp-cli billing get-credit-grants-id

— Retrieves a credit grant.

```
stripe-pp-cli billing get-meters
```
— Retrieve a list of billing meters.
```
stripe-pp-cli billing get-meters-id
```
— Retrieves a billing meter given an ID.
```
stripe-pp-cli billing get-meters-id-event-summaries
```
— Retrieve a list of billing meter event summaries.
```
stripe-pp-cli billing post-alerts
```
— Creates a billing alert
```
stripe-pp-cli billing post-alerts-id-activate
```
— Reactivates this alert, allowing it to trigger again.
```
stripe-pp-cli billing post-alerts-id-archive
```
— Archives this alert, removing it from the list view and APIs. This is non-reversible.
```
stripe-pp-cli billing post-alerts-id-deactivate
```
— Deactivates this alert, preventing it from triggering.

stripe-pp-cli billing post-credit-grants

— Creates a credit grant.

stripe-pp-cli billing post-credit-grants-id

— Updates a credit grant.

stripe-pp-cli billing post-credit-grants-id-expire

— Expires a credit grant.

stripe-pp-cli billing post-credit-grants-id-void

— Voids a credit grant.

```
stripe-pp-cli billing post-meter-event-adjustments
```
— Creates a billing meter event adjustment.
```
stripe-pp-cli billing post-meter-events
```
— Creates a billing meter event.
```
stripe-pp-cli billing post-meters
```
— Creates a billing meter.
```
stripe-pp-cli billing post-meters-id
```
— Updates a billing meter.
```
stripe-pp-cli billing post-meters-id-deactivate
```
— When a meter is deactivated, no more meter events will be accepted for this meter. You can’t attach a...
```
stripe-pp-cli billing post-meters-id-reactivate
```
— When a meter is reactivated, events for this meter can be accepted and you can attach the meter to a price.

billing-portal — Manage billing portal

```
stripe-pp-cli billing-portal get-configurations
```
— Returns a list of configurations that describe the functionality of the customer portal.
```
stripe-pp-cli billing-portal get-configurations-configuration
```
— Retrieves a configuration that describes the functionality of the customer portal.
```
stripe-pp-cli billing-portal post-configurations
```
— Creates a configuration that describes the functionality and behavior of a PortalSession
```
stripe-pp-cli billing-portal post-configurations-configuration
```
— Updates a configuration that describes the functionality of the customer portal.
```
stripe-pp-cli billing-portal post-sessions
```
— Creates a session of the customer portal.

charges — Manage charges

```
stripe-pp-cli charges get
```
— Returns a list of charges you’ve previously created. The charges are returned in sorted order, with the most...
```
stripe-pp-cli charges get-charge
```
— Retrieves the details of a charge that has previously been created. Supply the unique charge ID that was returned...
```
stripe-pp-cli charges get-search
```
— Search for charges you’ve previously created using Stripe’s <a...
```
stripe-pp-cli charges post
```
— This method is no longer recommended—use the <a href='/docs/api/payment_intents'>Payment Intents API</a> to...
```
stripe-pp-cli charges post-charge
```
— Updates the specified charge by setting the values of the parameters passed. Any parameters not provided will be...

checkout — Manage checkout

```
stripe-pp-cli checkout get-sessions
```
— Returns a list of Checkout Sessions.
```
stripe-pp-cli checkout get-sessions-session
```
— Retrieves a Checkout Session object.
```
stripe-pp-cli checkout get-sessions-session-line-items
```
— When retrieving a Checkout Session, there is an includable line_items property containing the...
```
stripe-pp-cli checkout post-sessions
```
— Creates a Checkout Session object.
```
stripe-pp-cli checkout post-sessions-session
```
— Updates a Checkout Session object. Related guide: <a href='/payments/advanced/dynamic-updates'>Dynamically...
```
stripe-pp-cli checkout post-sessions-session-expire
```
— A Checkout Session can be expired when it is in one of these statuses: <code>open</code> After it...

climate — Manage climate

```
stripe-pp-cli climate get-orders
```
— Lists all Climate order objects. The orders are returned sorted by creation date, with the most recently created...
```
stripe-pp-cli climate get-orders-order
```
— Retrieves the details of a Climate order object with the given ID.
```
stripe-pp-cli climate get-products
```
— Lists all available Climate product objects.
```
stripe-pp-cli climate get-products-product
```
— Retrieves the details of a Climate product with the given ID.
```
stripe-pp-cli climate get-suppliers
```
— Lists all available Climate supplier objects.
```
stripe-pp-cli climate get-suppliers-supplier
```
— Retrieves a Climate supplier object.
```
stripe-pp-cli climate post-orders
```
— Creates a Climate order object for a given Climate product. The order will be processed immediately after...
```
stripe-pp-cli climate post-orders-order
```
— Updates the specified order by setting the values of the parameters passed.
```
stripe-pp-cli climate post-orders-order-cancel
```
— Cancels a Climate order. You can cancel an order within 24 hours of creation. Stripe refunds the reservation...

confirmation-tokens — Manage confirmation tokens

```
stripe-pp-cli confirmation-tokens <confirmation_token>
```
— Retrieves an existing ConfirmationToken object

country-specs — Manage country specs

```
stripe-pp-cli country-specs get
```
— Lists all Country Spec objects available in the API.
```
stripe-pp-cli country-specs get-country
```
— Returns a Country Spec for a given Country code.

coupons — Manage coupons

```
stripe-pp-cli coupons delete
```
— You can delete coupons via the <a href='https://dashboard.stripe.com/coupons'>coupon management</a> page of the...
```
stripe-pp-cli coupons get
```
— Returns a list of your coupons.
```
stripe-pp-cli coupons get-coupon
```
— Retrieves the coupon with the given ID.
```
stripe-pp-cli coupons post
```
— You can create coupons easily via the <a href='https://dashboard.stripe.com/coupons'>coupon management</a> page...
```
stripe-pp-cli coupons post-coupon
```
— Updates the metadata of a coupon. Other coupon details (currency, duration, amount_off) are, by design, not...

credit-notes — Manage credit notes

```
stripe-pp-cli credit-notes get
```
— Returns a list of credit notes.
```
stripe-pp-cli credit-notes get-id
```
— Retrieves the credit note object with the given identifier.
```
stripe-pp-cli credit-notes get-preview
```
— Get a preview of a credit note without creating it.
```
stripe-pp-cli credit-notes get-preview-lines
```
— When retrieving a credit note preview, you’ll get a lines property containing the first...
```
stripe-pp-cli credit-notes post
```
— Issue a credit note to adjust the amount of a finalized invoice. A credit note will first reduce the invoice’s...
```
stripe-pp-cli credit-notes post-id
```
— Updates an existing credit note.

customer-sessions — Manage customer sessions

```
stripe-pp-cli customer-sessions
```
— Creates a Customer Session object that includes a single-use client secret that you can use on your front-end to...

customers — Manage customers

```
stripe-pp-cli customers delete
```
— Permanently deletes a customer. It cannot be undone. Also immediately cancels any active subscriptions on the...
```
stripe-pp-cli customers get
```
— Returns a list of your customers. The customers are returned sorted by creation date, with the most recent...
```
stripe-pp-cli customers get-customer
```
— Retrieves a Customer object.
```
stripe-pp-cli customers get-search
```
— Search for customers you’ve previously created using Stripe’s <a...
```
stripe-pp-cli customers post
```
— Creates a new customer object.
```
stripe-pp-cli customers post-customer
```
— Updates the specified customer by setting the values of the parameters passed. Any parameters not provided are...

disputes — Manage disputes

```
stripe-pp-cli disputes get
```
— Returns a list of your disputes.
```
stripe-pp-cli disputes get-dispute
```
— Retrieves the dispute with the given ID.
```
stripe-pp-cli disputes post
```
— When you get a dispute, contacting your customer is always the best first step. If that doesn’t work, you can...

entitlements — Manage entitlements

```
stripe-pp-cli entitlements get-active
```
— Retrieve a list of active entitlements for a customer

stripe-pp-cli entitlements get-active-id

— Retrieve an active entitlement

```
stripe-pp-cli entitlements get-features
```
— Retrieve a list of features

stripe-pp-cli entitlements get-features-id

— Retrieves a feature

stripe-pp-cli entitlements post-features

— Creates a feature

```
stripe-pp-cli entitlements post-features-id
```
— Update a feature’s metadata or permanently deactivate it.

ephemeral-keys — Manage ephemeral keys

```
stripe-pp-cli ephemeral-keys delete-key
```
— Invalidates a short-lived API key for a given resource.
```
stripe-pp-cli ephemeral-keys post
```
— Creates a short-lived API key for a given resource.

events — Manage events

```
stripe-pp-cli events get
```
— List events, going back up to 30 days. Each event data is rendered according to Stripe API version at its...
```
stripe-pp-cli events get-id
```
— Retrieves the details of an event if it was created in the last 30 days. Supply the unique identifier of the...

exchange-rates — Manage exchange rates

```
stripe-pp-cli exchange-rates get
```
— [Deprecated] The <code>ExchangeRate</code> APIs are deprecated. Please use the <a...
```
stripe-pp-cli exchange-rates get-rate-id
```
— [Deprecated] The <code>ExchangeRate</code> APIs are deprecated. Please use the <a...

file-links — Manage file links

```
stripe-pp-cli file-links get
```
— Returns a list of file links.
```
stripe-pp-cli file-links get-link
```
— Retrieves the file link with the given ID.
```
stripe-pp-cli file-links post
```
— Creates a new file link object.
```
stripe-pp-cli file-links post-link
```
— Updates an existing file link object. Expired links can no longer be updated.

files — Manage files

```
stripe-pp-cli files get
```
— Returns a list of the files that your account has access to. Stripe sorts and returns the files by their creation...
```
stripe-pp-cli files get-file
```
— Retrieves the details of an existing file object. After you supply a unique file ID, Stripe returns the...
```
stripe-pp-cli files post
```
— To upload a file to Stripe, you need to send a request of type <code>multipart/form-data</code>. Include the file...

financial-connections — Manage financial connections

```
stripe-pp-cli financial-connections get-accounts
```
— Returns a list of Financial Connections <code>Account</code> objects.
```
stripe-pp-cli financial-connections get-accounts-account
```
— Retrieves the details of an Financial Connections <code>Account</code>.

stripe-pp-cli financial-connections get-accounts-account-owners

— Lists all owners for a given <code>Account</code>

```
stripe-pp-cli financial-connections get-sessions-session
```
— Retrieves the details of a Financial Connections <code>Session</code>
```
stripe-pp-cli financial-connections get-transactions
```
— Returns a list of Financial Connections <code>Transaction</code> objects.
```
stripe-pp-cli financial-connections get-transactions-transaction
```
— Retrieves the details of a Financial Connections <code>Transaction</code>
```
stripe-pp-cli financial-connections post-accounts-account-disconnect
```
— Disables your access to a Financial Connections <code>Account</code>. You will no longer be able to access data...
```
stripe-pp-cli financial-connections post-accounts-account-refresh
```
— Refreshes the data associated with a Financial Connections <code>Account</code>.
```
stripe-pp-cli financial-connections post-accounts-account-subscribe
```
— Subscribes to periodic refreshes of data associated with a Financial Connections <code>Account</code>. When the...
```
stripe-pp-cli financial-connections post-accounts-account-unsubscribe
```
— Unsubscribes from periodic refreshes of data associated with a Financial Connections <code>Account</code>.
```
stripe-pp-cli financial-connections post-sessions
```
— To launch the Financial Connections authorization flow, create a <code>Session</code>. The session’s...

forwarding — Manage forwarding

```
stripe-pp-cli forwarding get-requests
```
— Lists all ForwardingRequest objects.
```
stripe-pp-cli forwarding get-requests-id
```
— Retrieves a ForwardingRequest object.
```
stripe-pp-cli forwarding post-requests
```
— Creates a ForwardingRequest object.

identity — Manage identity

stripe-pp-cli identity get-verification-reports

— List all verification reports.

stripe-pp-cli identity get-verification-reports-report

— Retrieves an existing VerificationReport

stripe-pp-cli identity get-verification-sessions

— Returns a list of VerificationSessions

```
stripe-pp-cli identity get-verification-sessions-session
```
— Retrieves the details of a VerificationSession that was previously created. When the session status is...
```
stripe-pp-cli identity post-verification-sessions
```
— Creates a VerificationSession object. After the VerificationSession is created, display a verification...
```
stripe-pp-cli identity post-verification-sessions-session
```
— Updates a VerificationSession object. When the session status is <code>requires_input</code>, you can use...
```
stripe-pp-cli identity post-verification-sessions-session-cancel
```
— A VerificationSession object can be canceled when it is in <code>requires_input</code> <a...
```
stripe-pp-cli identity post-verification-sessions-session-redact
```
— Redact a VerificationSession to remove all collected information from Stripe. This will redact the...

invoice-payments — Manage invoice payments

```
stripe-pp-cli invoice-payments get
```
— When retrieving an invoice, there is an includable payments property containing the first handful of those items....
```
stripe-pp-cli invoice-payments get-invoicepayments
```
— Retrieves the invoice payment with the given ID.

invoice-rendering-templates — Manage invoice rendering templates

```
stripe-pp-cli invoice-rendering-templates get
```
— List all templates, ordered by creation date, with the most recently created template appearing first.
```
stripe-pp-cli invoice-rendering-templates get-template
```
— Retrieves an invoice rendering template with the given ID. It by default returns the latest version of the...

invoiceitems — Manage invoiceitems

```
stripe-pp-cli invoiceitems delete
```
— Deletes an invoice item, removing it from an invoice. Deleting invoice items is only possible when they’re not...
```
stripe-pp-cli invoiceitems get
```
— Returns a list of your invoice items. Invoice items are returned sorted by creation date, with the most recently...
```
stripe-pp-cli invoiceitems get-invoiceitem
```
— Retrieves the invoice item with the given ID.
```
stripe-pp-cli invoiceitems post
```
— Creates an item to be added to a draft invoice (up to 250 items per invoice). If no invoice is specified, the...
```
stripe-pp-cli invoiceitems post-invoiceitem
```
— Updates the amount or description of an invoice item on an upcoming invoice. Updating an invoice item is only...

invoices — Manage invoices

```
stripe-pp-cli invoices delete
```
— Permanently deletes a one-off invoice draft. This cannot be undone. Attempts to delete invoices that are no...
```
stripe-pp-cli invoices get
```
— You can list all invoices, or list the invoices for a specific customer. The invoices are returned sorted by...
```
stripe-pp-cli invoices get-invoice
```
— Retrieves the invoice with the given ID.
```
stripe-pp-cli invoices get-search
```
— Search for invoices you’ve previously created using Stripe’s <a...
```
stripe-pp-cli invoices post
```
— This endpoint creates a draft invoice for a given customer. The invoice remains a draft until you <a...
```
stripe-pp-cli invoices post-create-preview
```
— At any time, you can preview the upcoming invoice for a subscription or subscription schedule. This will show you...
```
stripe-pp-cli invoices post-invoice
```
— Draft invoices are fully editable. Once an invoice is <a href='/docs/billing/invoices/workflow#finalized'>finalize...

issuing — Manage issuing

```
stripe-pp-cli issuing get-authorizations
```
— Returns a list of Issuing <code>Authorization</code> objects. The objects are sorted in descending order by...
```
stripe-pp-cli issuing get-authorizations-authorization
```
— Retrieves an Issuing <code>Authorization</code> object.
```
stripe-pp-cli issuing get-cardholders
```
— Returns a list of Issuing <code>Cardholder</code> objects. The objects are sorted in descending order by creation...
```
stripe-pp-cli issuing get-cardholders-cardholder
```
— Retrieves an Issuing <code>Cardholder</code> object.
```
stripe-pp-cli issuing get-cards
```
— Returns a list of Issuing <code>Card</code> objects. The objects are sorted in descending order by creation date,...
```
stripe-pp-cli issuing get-cards-card
```
— Retrieves an Issuing <code>Card</code> object.
```
stripe-pp-cli issuing get-disputes
```
— Returns a list of Issuing <code>Dispute</code> objects. The objects are sorted in descending order by creation...
```
stripe-pp-cli issuing get-disputes-dispute
```
— Retrieves an Issuing <code>Dispute</code> object.
```
stripe-pp-cli issuing get-personalization-designs
```
— Returns a list of personalization design objects. The objects are sorted in descending order by creation date,...

stripe-pp-cli issuing get-personalization-designs-personalization-design

— Retrieves a personalization design object.

```
stripe-pp-cli issuing get-physical-bundles
```
— Returns a list of physical bundle objects. The objects are sorted in descending order by creation date, with the...

stripe-pp-cli issuing get-physical-bundles-physical-bundle

— Retrieves a physical bundle object.

```
stripe-pp-cli issuing get-tokens
```
— Lists all Issuing <code>Token</code> objects for a given card.
```
stripe-pp-cli issuing get-tokens-token
```
— Retrieves an Issuing <code>Token</code> object.
```
stripe-pp-cli issuing get-transactions
```
— Returns a list of Issuing <code>Transaction</code> objects. The objects are sorted in descending order by...
```
stripe-pp-cli issuing get-transactions-transaction
```
— Retrieves an Issuing <code>Transaction</code> object.
```
stripe-pp-cli issuing post-authorizations-authorization
```
— Updates the specified Issuing <code>Authorization</code> object by setting the values of the parameters passed....
```
stripe-pp-cli issuing post-authorizations-authorization-approve
```
— [Deprecated] Approves a pending Issuing <code>Authorization</code> object. This request should be made within the...
```
stripe-pp-cli issuing post-authorizations-authorization-decline
```
— [Deprecated] Declines a pending Issuing <code>Authorization</code> object. This request should be made within the...
```
stripe-pp-cli issuing post-cardholders
```
— Creates a new Issuing <code>Cardholder</code> object that can be issued cards.
```
stripe-pp-cli issuing post-cardholders-cardholder
```
— Updates the specified Issuing <code>Cardholder</code> object by setting the values of the parameters passed. Any...
```
stripe-pp-cli issuing post-cards
```
— Creates an Issuing <code>Card</code> object.
```
stripe-pp-cli issuing post-cards-card
```
— Updates the specified Issuing <code>Card</code> object by setting the values of the parameters passed. Any...
```
stripe-pp-cli issuing post-disputes
```
— Creates an Issuing <code>Dispute</code> object. Individual pieces of evidence within the <code>evidence</code>...
```
stripe-pp-cli issuing post-disputes-dispute
```
— Updates the specified Issuing <code>Dispute</code> object by setting the values of the parameters passed. Any...
```
stripe-pp-cli issuing post-disputes-dispute-submit
```
— Submits an Issuing <code>Dispute</code> to the card network. Stripe validates that all evidence fields required...

stripe-pp-cli issuing post-personalization-designs

— Creates a personalization design object.

stripe-pp-cli issuing post-personalization-designs-personalization-design

— Updates a card personalization object.

```
stripe-pp-cli issuing post-tokens-token
```
— Attempts to update the specified Issuing <code>Token</code> object to the status specified.
```
stripe-pp-cli issuing post-transactions-transaction
```
— Updates the specified Issuing <code>Transaction</code> object by setting the values of the parameters passed. Any...

mandates — Manage mandates

```
stripe-pp-cli mandates
```
— Retrieves a Mandate object.

payment-attempt-records — Manage payment attempt records

```
stripe-pp-cli payment-attempt-records get
```
— List all the Payment Attempt Records attached to the specified Payment Record.
```
stripe-pp-cli payment-attempt-records get-id
```
— Retrieves a Payment Attempt Record with the given ID

payment-intents — Manage payment intents

```
stripe-pp-cli payment-intents get
```
— Returns a list of PaymentIntents.
```
stripe-pp-cli payment-intents get-intent
```
— Retrieves the details of a PaymentIntent that has previously been created. You can retrieve a...
```
stripe-pp-cli payment-intents get-search
```
— Search for PaymentIntents you’ve previously created using Stripe’s <a...
```
stripe-pp-cli payment-intents post
```
— Creates a PaymentIntent object. After the PaymentIntent is created, attach a payment method and <a...
```
stripe-pp-cli payment-intents post-intent
```
— Updates properties on a PaymentIntent object without confirming. Depending on which properties you update,...

payment-links — Manage payment links

```
stripe-pp-cli payment-links get
```
— Returns a list of your payment links.

stripe-pp-cli payment-links get-paymentlinks

— Retrieve a payment link.

```
stripe-pp-cli payment-links post
```
— Creates a payment link.

stripe-pp-cli payment-links post-paymentlinks

— Updates a payment link.

payment-method-configurations — Manage payment method configurations

stripe-pp-cli payment-method-configurations get

— List payment method configurations

stripe-pp-cli payment-method-configurations get-configuration

— Retrieve payment method configuration

stripe-pp-cli payment-method-configurations post

— Creates a payment method configuration

stripe-pp-cli payment-method-configurations post-configuration

— Update payment method configuration

payment-method-domains — Manage payment method domains

```
stripe-pp-cli payment-method-domains get
```
— Lists the details of existing payment method domains.
```
stripe-pp-cli payment-method-domains get-paymentmethoddomains
```
— Retrieves the details of an existing payment method domain.
```
stripe-pp-cli payment-method-domains post
```
— Creates a payment method domain.

stripe-pp-cli payment-method-domains post-paymentmethoddomains

— Updates an existing payment method domain.

payment-methods — Manage payment methods

```
stripe-pp-cli payment-methods get
```
— Returns a list of all PaymentMethods.
```
stripe-pp-cli payment-methods get-paymentmethods
```
— Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a...
```
stripe-pp-cli payment-methods post
```
— Creates a PaymentMethod object. Read the <a href='/docs/stripe-js/reference#stripe-create-payment-method'>Stripe.j...
```
stripe-pp-cli payment-methods post-paymentmethods
```
— Updates a PaymentMethod object. A PaymentMethod must be attached to a customer to be updated.

payment-records — Manage payment records

```
stripe-pp-cli payment-records get-id
```
— Retrieves a Payment Record with the given ID
```
stripe-pp-cli payment-records post-report-payment
```
— Report a new Payment Record. You may report a Payment Record as it is initialized and later report updates...

payouts — Manage payouts

```
stripe-pp-cli payouts get
```
— Returns a list of existing payouts sent to third-party bank accounts or payouts that Stripe sent to you. The...
```
stripe-pp-cli payouts get-payout
```
— Retrieves the details of an existing payout. Supply the unique payout ID from either a payout creation request or...
```
stripe-pp-cli payouts post
```
— To send funds to your own bank account, create a new payout object. Your <a href='#balance'>Stripe balance</a>...
```
stripe-pp-cli payouts post-payout
```
— Updates the specified payout by setting the values of the parameters you pass. We don’t change parameters that...

plans — Manage plans

```
stripe-pp-cli plans delete
```
— Deleting plans means new subscribers can’t be added. Existing subscribers aren’t affected.
```
stripe-pp-cli plans get
```
— Returns a list of your plans.
```
stripe-pp-cli plans get-plan
```
— Retrieves the plan with the given ID.
```
stripe-pp-cli plans post
```
— You can now model subscriptions more flexibly using the <a href='#prices'>Prices API</a>. It replaces the Plans...
```
stripe-pp-cli plans post-plan
```
— Updates the specified plan by setting the values of the parameters passed. Any parameters not provided are left...

prices — Manage prices

```
stripe-pp-cli prices get
```
— Returns a list of your active prices, excluding <a href='/docs/products-prices/pricing-models#inline-pricing'>inli...
```
stripe-pp-cli prices get-price
```
— Retrieves the price with the given ID.
```
stripe-pp-cli prices get-search
```
— Search for prices you’ve previously created using Stripe’s <a...
```
stripe-pp-cli prices post
```
— Creates a new <a href='https://docs.stripe.com/api/prices'>Price</a> for an existing <a...
```
stripe-pp-cli prices post-price
```
— Updates the specified price by setting the values of the parameters passed. Any parameters not provided are left...

products — Manage products

```
stripe-pp-cli products delete-id
```
— Delete a product. Deleting a product is only possible if it has no prices associated with it. Additionally,...
```
stripe-pp-cli products get
```
— Returns a list of your products. The products are returned sorted by creation date, with the most recently...
```
stripe-pp-cli products get-id
```
— Retrieves the details of an existing product. Supply the unique product ID from either a product creation request...
```
stripe-pp-cli products get-search
```
— Search for products you’ve previously created using Stripe’s <a...
```
stripe-pp-cli products post
```
— Creates a new product object.
```
stripe-pp-cli products post-id
```
— Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be...

promotion-codes — Manage promotion codes

```
stripe-pp-cli promotion-codes get
```
— Returns a list of your promotion codes.
```
stripe-pp-cli promotion-codes get-promotioncodes
```
— Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing...
```
stripe-pp-cli promotion-codes post
```
— A promotion code points to an underlying promotion. You can optionally restrict the code to a specific customer,...
```
stripe-pp-cli promotion-codes post-promotioncodes
```
— Updates the specified promotion code by setting the values of the parameters passed. Most fields are, by design,...

quotes — Manage quotes

```
stripe-pp-cli quotes get
```
— Returns a list of your quotes.
```
stripe-pp-cli quotes get-quote
```
— Retrieves the quote with the given ID.
```
stripe-pp-cli quotes post
```
— A quote models prices and services for a customer. Default options for <code>header</code>,...
```
stripe-pp-cli quotes post-quote
```
— A quote models prices and services for a customer.

radar — Manage radar

```
stripe-pp-cli radar delete-value-list-items-item
```
— Deletes a <code>ValueListItem</code> object, removing it from its parent value list.
```
stripe-pp-cli radar delete-value-lists-value-list
```
— Deletes a <code>ValueList</code> object, also deleting any items contained within the value list. To be deleted,...
```
stripe-pp-cli radar get-early-fraud-warnings
```
— Returns a list of early fraud warnings.
```
stripe-pp-cli radar get-early-fraud-warnings-early-fraud-warning
```
— Retrieves the details of an early fraud warning that has previously been created. Please refer to the <a...
```
stripe-pp-cli radar get-value-list-items
```
— Returns a list of <code>ValueListItem</code> objects. The objects are sorted in descending order by creation...
```
stripe-pp-cli radar get-value-list-items-item
```
— Retrieves a <code>ValueListItem</code> object.
```
stripe-pp-cli radar get-value-lists
```
— Returns a list of <code>ValueList</code> objects. The objects are sorted in descending order by creation date,...
```
stripe-pp-cli radar get-value-lists-value-list
```
— Retrieves a <code>ValueList</code> object.
```
stripe-pp-cli radar post-payment-evaluations
```
— Request a Radar API fraud risk score from Stripe for a payment before sending it for external processor...
```
stripe-pp-cli radar post-value-list-items
```
— Creates a new <code>ValueListItem</code> object, which is added to the specified parent value list.
```
stripe-pp-cli radar post-value-lists
```
— Creates a new <code>ValueList</code> object, which can then be referenced in rules.
```
stripe-pp-cli radar post-value-lists-value-list
```
— Updates a <code>ValueList</code> object by setting the values of the parameters passed. Any parameters not...

refunds — Manage refunds

```
stripe-pp-cli refunds get
```
— Returns a list of all refunds you created. We return the refunds in sorted order, with the most recent refunds...
```
stripe-pp-cli refunds get-refund
```
— Retrieves the details of an existing refund.
```
stripe-pp-cli refunds post
```
— When you create a new refund, you must specify a Charge or a PaymentIntent object on which to create it....
```
stripe-pp-cli refunds post-refund
```
— Updates the refund that you specify by setting the values of the passed parameters. Any parameters that you...

reporting — Manage reporting

```
stripe-pp-cli reporting get-report-runs
```
— Returns a list of Report Runs, with the most recent appearing first.
```
stripe-pp-cli reporting get-report-runs-report-run
```
— Retrieves the details of an existing Report Run.
```
stripe-pp-cli reporting get-report-types
```
— Returns a full list of Report Types.
```
stripe-pp-cli reporting get-report-types-report-type
```
— Retrieves the details of a Report Type. (Certain report types require a <a...
```
stripe-pp-cli reporting post-report-runs
```
— Creates a new object and begin running the report. (Certain report types require a <a...

reviews — Manage reviews

```
stripe-pp-cli reviews get
```
— Returns a list of <code>Review</code> objects that have <code>open</code> set to <code>true</code>. The objects...
```
stripe-pp-cli reviews get-review
```
— Retrieves a <code>Review</code> object.

setup-attempts — Manage setup attempts

```
stripe-pp-cli setup-attempts
```
— Returns a list of SetupAttempts that associate with a provided SetupIntent.

setup-intents — Manage setup intents

```
stripe-pp-cli setup-intents get
```
— Returns a list of SetupIntents.
```
stripe-pp-cli setup-intents get-intent
```
— Retrieves the details of a SetupIntent that has previously been created. Client-side retrieval using a...
```
stripe-pp-cli setup-intents post
```
— Creates a SetupIntent object. After you create the SetupIntent, attach a payment method and <a...
```
stripe-pp-cli setup-intents post-intent
```
— Updates a SetupIntent object.

shipping-rates — Manage shipping rates

```
stripe-pp-cli shipping-rates get
```
— Returns a list of your shipping rates.
```
stripe-pp-cli shipping-rates get-token
```
— Returns the shipping rate object with the given ID.
```
stripe-pp-cli shipping-rates post
```
— Creates a new shipping rate object.
```
stripe-pp-cli shipping-rates post-token
```
— Updates an existing shipping rate object.

sigma — Manage sigma

```
stripe-pp-cli sigma get-scheduled-query-runs
```
— Returns a list of scheduled query runs.

stripe-pp-cli sigma get-scheduled-query-runs-scheduled-query-run

— Retrieves the details of an scheduled query run.

sources — Manage sources

```
stripe-pp-cli sources get
```
— Retrieves an existing source object. Supply the unique source ID from a source creation request and Stripe will...
```
stripe-pp-cli sources post
```
— Creates a new source object.
```
stripe-pp-cli sources post-source
```
— Updates the specified source by setting the values of the parameters passed. Any parameters not provided will be...

subscription-items — Manage subscription items

```
stripe-pp-cli subscription-items delete-item
```
— Deletes an item from the subscription. Removing a subscription item from a subscription will not cancel the...
```
stripe-pp-cli subscription-items get
```
— Returns a list of your subscription items for a given subscription.
```
stripe-pp-cli subscription-items get-item
```
— Retrieves the subscription item with the given ID.
```
stripe-pp-cli subscription-items post
```
— Adds a new item to an existing subscription. No existing items will be changed or replaced.
```
stripe-pp-cli subscription-items post-item
```
— Updates the plan or quantity of an item on a current subscription.

subscription-schedules — Manage subscription schedules

```
stripe-pp-cli subscription-schedules get
```
— Retrieves the list of your subscription schedules.
```
stripe-pp-cli subscription-schedules get-schedule
```
— Retrieves the details of an existing subscription schedule. You only need to supply the unique subscription...
```
stripe-pp-cli subscription-schedules post
```
— Creates a new subscription schedule object. Each customer can have up to 500 active or scheduled subscriptions.
```
stripe-pp-cli subscription-schedules post-schedule
```
— Updates an existing subscription schedule.

subscriptions — Manage subscriptions

```
stripe-pp-cli subscriptions delete-exposed-id
```
— Cancels a customer’s subscription immediately. The customer won’t be charged again for the subscription....
```
stripe-pp-cli subscriptions get
```
— By default, returns a list of subscriptions that have not been canceled. In order to list canceled subscriptions,...
```
stripe-pp-cli subscriptions get-exposed-id
```
— Retrieves the subscription with the given ID.
```
stripe-pp-cli subscriptions get-search
```
— Search for subscriptions you’ve previously created using Stripe’s <a...
```
stripe-pp-cli subscriptions post
```
— Creates a new subscription on an existing customer. Each customer can have up to 500 active or scheduled...
```
stripe-pp-cli subscriptions post-exposed-id
```
— Updates an existing subscription to match the specified parameters. When changing prices or quantities, we...

tax — Manage tax

```
stripe-pp-cli tax get-associations-find
```
— Finds a tax association object by PaymentIntent id.
```
stripe-pp-cli tax get-calculations-calculation
```
— Retrieves a Tax <code>Calculation</code> object, if the calculation hasn’t expired.
```
stripe-pp-cli tax get-calculations-calculation-line-items
```
— Retrieves the line items of a tax calculation as a collection, if the calculation hasn’t expired.
```
stripe-pp-cli tax get-registrations
```
— Returns a list of Tax <code>Registration</code> objects.
```
stripe-pp-cli tax get-registrations-id
```
— Returns a Tax <code>Registration</code> object.
```
stripe-pp-cli tax get-settings
```
— Retrieves Tax <code>Settings</code> for a merchant.
```
stripe-pp-cli tax get-transactions-transaction
```
— Retrieves a Tax <code>Transaction</code> object.
```
stripe-pp-cli tax get-transactions-transaction-line-items
```
— Retrieves the line items of a committed standalone transaction as a collection.
```
stripe-pp-cli tax post-calculations
```
— Calculates tax based on the input and returns a Tax <code>Calculation</code> object.
```
stripe-pp-cli tax post-registrations
```
— Creates a new Tax <code>Registration</code> object.
```
stripe-pp-cli tax post-registrations-id
```
— Updates an existing Tax <code>Registration</code> object. A registration cannot be deleted after it has...
```
stripe-pp-cli tax post-settings
```
— Updates Tax <code>Settings</code> parameters used in tax calculations. All parameters are editable but none can...
```
stripe-pp-cli tax post-transactions-create-from-calculation
```
— Creates a Tax Transaction from a calculation, if that calculation hasn’t expired. Calculations expire after 90...
```
stripe-pp-cli tax post-transactions-create-reversal
```
— Partially or fully reverses a previously created <code>Transaction</code>.

tax-codes — Manage tax codes

```
stripe-pp-cli tax-codes get
```
— A list of <a href='https://stripe.com/docs/tax/tax-categories'>all tax codes available</a> to add to Products in...
```
stripe-pp-cli tax-codes get-id
```
— Retrieves the details of an existing tax code. Supply the unique tax code ID and Stripe will return the...

tax-ids — Manage tax ids

```
stripe-pp-cli tax-ids delete-id
```
— Deletes an existing account or customer <code>tax_id</code> object.
```
stripe-pp-cli tax-ids get
```
— Returns a list of tax IDs.
```
stripe-pp-cli tax-ids get-id
```
— Retrieves an account or customer <code>tax_id</code> object.
```
stripe-pp-cli tax-ids post
```
— Creates a new account or customer <code>tax_id</code> object.

tax-rates — Manage tax rates

```
stripe-pp-cli tax-rates get
```
— Returns a list of your tax rates. Tax rates are returned sorted by creation date, with the most recently created...
```
stripe-pp-cli tax-rates get-taxrates
```
— Retrieves a tax rate with the given ID
```
stripe-pp-cli tax-rates post
```
— Creates a new tax rate.
```
stripe-pp-cli tax-rates post-taxrates
```
— Updates an existing tax rate.

terminal — Manage terminal

stripe-pp-cli terminal delete-configurations-configuration

— Deletes a <code>Configuration</code> object.

stripe-pp-cli terminal delete-locations-location

— Deletes a <code>Location</code> object.

```
stripe-pp-cli terminal delete-readers-reader
```
— Deletes a <code>Reader</code> object.
```
stripe-pp-cli terminal get-configurations
```
— Returns a list of <code>Configuration</code> objects.

stripe-pp-cli terminal get-configurations-configuration

— Retrieves a <code>Configuration</code> object.

```
stripe-pp-cli terminal get-locations
```
— Returns a list of <code>Location</code> objects.
```
stripe-pp-cli terminal get-locations-location
```
— Retrieves a <code>Location</code> object.
```
stripe-pp-cli terminal get-readers
```
— Returns a list of <code>Reader</code> objects.
```
stripe-pp-cli terminal get-readers-reader
```
— Retrieves a <code>Reader</code> object.
```
stripe-pp-cli terminal post-configurations
```
— Creates a new <code>Configuration</code> object.

stripe-pp-cli terminal post-configurations-configuration

— Updates a new <code>Configuration</code> object.

```
stripe-pp-cli terminal post-connection-tokens
```
— To connect to a reader the Stripe Terminal SDK needs to retrieve a short-lived connection token from Stripe,...
```
stripe-pp-cli terminal post-locations
```
— Creates a new <code>Location</code> object. For further details, including which address fields are required in...
```
stripe-pp-cli terminal post-locations-location
```
— Updates a <code>Location</code> object by setting the values of the parameters passed. Any parameters not...
```
stripe-pp-cli terminal post-onboarding-links
```
— Creates a new <code>OnboardingLink</code> object that contains a redirect_url used for onboarding onto Tap to Pay...
```
stripe-pp-cli terminal post-readers
```
— Creates a new <code>Reader</code> object.
```
stripe-pp-cli terminal post-readers-reader
```
— Updates a <code>Reader</code> object by setting the values of the parameters passed. Any parameters not provided...
```
stripe-pp-cli terminal post-readers-reader-cancel-action
```
— Cancels the current reader action. See <a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platform...
```
stripe-pp-cli terminal post-readers-reader-collect-inputs
```
— Initiates an <a href='/docs/terminal/features/collect-inputs'>input collection flow</a> on a Reader to display...
```
stripe-pp-cli terminal post-readers-reader-collect-payment-method
```
— Initiates a payment flow on a Reader and updates the PaymentIntent with card details before manual confirmation....
```
stripe-pp-cli terminal post-readers-reader-confirm-payment-intent
```
— Finalizes a payment on a Reader. See <a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platform=s...
```
stripe-pp-cli terminal post-readers-reader-process-payment-intent
```
— Initiates a payment flow on a Reader. See <a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platf...
```
stripe-pp-cli terminal post-readers-reader-process-setup-intent
```
— Initiates a SetupIntent flow on a Reader. See <a href='/docs/terminal/features/saving-payment-details/save-directl...
```
stripe-pp-cli terminal post-readers-reader-refund-payment
```
— Initiates an in-person refund on a Reader. See <a href='/docs/terminal/payments/regional?integration-country=CA#re...
```
stripe-pp-cli terminal post-readers-reader-set-reader-display
```
— Sets the reader display to show <a href='/docs/terminal/features/display'>cart details</a>.

test-helpers — Manage test helpers

stripe-pp-cli test-helpers delete-test-clocks-test-clock

— Deletes a test clock.

```
stripe-pp-cli test-helpers get-test-clocks
```
— Returns a list of your test clocks.

stripe-pp-cli test-helpers get-test-clocks-test-clock

— Retrieves a test clock.

```
stripe-pp-cli test-helpers post-confirmation-tokens
```
— Creates a test mode Confirmation Token server side for your integration tests.

stripe-pp-cli test-helpers post-customers-customer-fund-cash-balance

— Create an incoming testmode bank transfer

stripe-pp-cli test-helpers post-issuing-authorizations

— Create a test-mode authorization.

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-capture

— Capture a test-mode authorization.

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-expire

— Expire a test-mode Authorization.

```
stripe-pp-cli test-helpers post-issuing-authorizations-authorization-finalize-amount
```
— Finalize the amount on an Authorization prior to capture, when the initial authorization was for an estimated...
```
stripe-pp-cli test-helpers post-issuing-authorizations-authorization-fraud-challenges-respond
```
— Respond to a fraud challenge on a testmode Issuing authorization, simulating either a confirmation of fraud or a...

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-increment

— Increment a test-mode Authorization.

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-reverse

— Reverse a test-mode Authorization.

```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-deliver
```
— Updates the shipping status of the specified Issuing <code>Card</code> object to <code>delivered</code>.
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-fail
```
— Updates the shipping status of the specified Issuing <code>Card</code> object to <code>failure</code>.
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-return
```
— Updates the shipping status of the specified Issuing <code>Card</code> object to <code>returned</code>.
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-ship
```
— Updates the shipping status of the specified Issuing <code>Card</code> object to <code>shipped</code>.
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-submit
```
— Updates the shipping status of the specified Issuing <code>Card</code> object to <code>submitted</code>. This...
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-activate
```
— Updates the <code>status</code> of the specified testmode personalization design object to <code>active</code>.
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-deactivate
```
— Updates the <code>status</code> of the specified testmode personalization design object to <code>inactive</code>.
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-reject
```
— Updates the <code>status</code> of the specified testmode personalization design object to <code>rejected</code>.
```
stripe-pp-cli test-helpers post-issuing-transactions-create-force-capture
```
— Allows the user to capture an arbitrary amount, also known as a forced capture.
```
stripe-pp-cli test-helpers post-issuing-transactions-create-unlinked-refund
```
— Allows the user to refund an arbitrary amount, also known as a unlinked refund.

stripe-pp-cli test-helpers post-issuing-transactions-transaction-refund

— Refund a test-mode Transaction.

```
stripe-pp-cli test-helpers post-refunds-refund-expire
```
— Expire a refund with a status of <code>requires_action</code>.
```
stripe-pp-cli test-helpers post-terminal-readers-reader-present-payment-method
```
— Presents a payment method on a simulated reader. Can be used to simulate accepting a payment, saving a card or...
```
stripe-pp-cli test-helpers post-terminal-readers-reader-succeed-input-collection
```
— Use this endpoint to trigger a successful input collection on a simulated reader.
```
stripe-pp-cli test-helpers post-terminal-readers-reader-timeout-input-collection
```
— Use this endpoint to complete an input collection with a timeout error on a simulated reader.
```
stripe-pp-cli test-helpers post-test-clocks
```
— Creates a new test clock that can be attached to new customers and quotes.
```
stripe-pp-cli test-helpers post-test-clocks-test-clock-advance
```
— Starts advancing a test clock to a specified time in the future. Advancement is done when status changes to...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-fail
```
— Transitions a test mode created InboundTransfer to the <code>failed</code> status. The InboundTransfer must...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-return
```
— Marks the test mode InboundTransfer object as returned and links the InboundTransfer to a ReceivedDebit. The...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-succeed
```
— Transitions a test mode created InboundTransfer to the <code>succeeded</code> status. The InboundTransfer must...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id
```
— Updates a test mode created OutboundPayment with tracking details. The OutboundPayment must not be cancelable,...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-fail
```
— Transitions a test mode created OutboundPayment to the <code>failed</code> status. The OutboundPayment must...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-post
```
— Transitions a test mode created OutboundPayment to the <code>posted</code> status. The OutboundPayment must...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-return
```
— Transitions a test mode created OutboundPayment to the <code>returned</code> status. The OutboundPayment must...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer
```
— Updates a test mode created OutboundTransfer with tracking details. The OutboundTransfer must not be cancelable,...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-fail
```
— Transitions a test mode created OutboundTransfer to the <code>failed</code> status. The OutboundTransfer must...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-post
```
— Transitions a test mode created OutboundTransfer to the <code>posted</code> status. The OutboundTransfer must...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-return
```
— Transitions a test mode created OutboundTransfer to the <code>returned</code> status. The OutboundTransfer must...
```
stripe-pp-cli test-helpers post-treasury-received-credits
```
— Use this endpoint to simulate a test mode ReceivedCredit initiated by a third party. In live mode, you can’t...
```
stripe-pp-cli test-helpers post-treasury-received-debits
```
— Use this endpoint to simulate a test mode ReceivedDebit initiated by a third party. In live mode, you can’t...

tokens — Manage tokens

```
stripe-pp-cli tokens get
```
— Retrieves the token with the given ID.
```
stripe-pp-cli tokens post
```
— Creates a single-use token that represents a bank account’s details. You can use this token with any v1 API...

topups — Manage topups

```
stripe-pp-cli topups get
```
— Returns a list of top-ups.
```
stripe-pp-cli topups get-topup
```
— Retrieves the details of a top-up that has previously been created. Supply the unique top-up ID that was returned...
```
stripe-pp-cli topups post
```
— Top up the balance of an account
```
stripe-pp-cli topups post-topup
```
— Updates the metadata of a top-up. Other top-up details are not editable by design.

transfers — Manage transfers

```
stripe-pp-cli transfers get
```
— Returns a list of existing transfers sent to connected accounts. The transfers are returned in sorted order, with...
```
stripe-pp-cli transfers get-transfer
```
— Retrieves the details of an existing transfer. Supply the unique transfer ID from either a transfer creation...
```
stripe-pp-cli transfers post
```
— To send funds from your Stripe account to a connected account, you create a new transfer object. Your <a...
```
stripe-pp-cli transfers post-transfer
```
— Updates the specified transfer by setting the values of the parameters passed. Any parameters not provided will...

treasury — Manage treasury

```
stripe-pp-cli treasury get-credit-reversals
```
— Returns a list of CreditReversals.
```
stripe-pp-cli treasury get-credit-reversals-credit-reversal
```
— Retrieves the details of an existing CreditReversal by passing the unique CreditReversal ID from either the...
```
stripe-pp-cli treasury get-debit-reversals
```
— Returns a list of DebitReversals.

stripe-pp-cli treasury get-debit-reversals-debit-reversal

— Retrieves a DebitReversal object.

```
stripe-pp-cli treasury get-financial-accounts
```
— Returns a list of FinancialAccounts.

stripe-pp-cli treasury get-financial-accounts-financial-account

— Retrieves the details of a FinancialAccount.

```
stripe-pp-cli treasury get-financial-accounts-financial-account-features
```
— Retrieves Features information associated with the FinancialAccount.
```
stripe-pp-cli treasury get-inbound-transfers
```
— Returns a list of InboundTransfers sent from the specified FinancialAccount.
```
stripe-pp-cli treasury get-inbound-transfers-id
```
— Retrieves the details of an existing InboundTransfer.
```
stripe-pp-cli treasury get-outbound-payments
```
— Returns a list of OutboundPayments sent from the specified FinancialAccount.
```
stripe-pp-cli treasury get-outbound-payments-id
```
— Retrieves the details of an existing OutboundPayment by passing the unique OutboundPayment ID from either the...
```
stripe-pp-cli treasury get-outbound-transfers
```
— Returns a list of OutboundTransfers sent from the specified FinancialAccount.
```
stripe-pp-cli treasury get-outbound-transfers-outbound-transfer
```
— Retrieves the details of an existing OutboundTransfer by passing the unique OutboundTransfer ID from either the...
```
stripe-pp-cli treasury get-received-credits
```
— Returns a list of ReceivedCredits.
```
stripe-pp-cli treasury get-received-credits-id
```
— Retrieves the details of an existing ReceivedCredit by passing the unique ReceivedCredit ID from the...
```
stripe-pp-cli treasury get-received-debits
```
— Returns a list of ReceivedDebits.
```
stripe-pp-cli treasury get-received-debits-id
```
— Retrieves the details of an existing ReceivedDebit by passing the unique ReceivedDebit ID from the ReceivedDebit...
```
stripe-pp-cli treasury get-transaction-entries
```
— Retrieves a list of TransactionEntry objects.

stripe-pp-cli treasury get-transaction-entries-id

— Retrieves a TransactionEntry object.

```
stripe-pp-cli treasury get-transactions
```
— Retrieves a list of Transaction objects.
```
stripe-pp-cli treasury get-transactions-id
```
— Retrieves the details of an existing Transaction.
```
stripe-pp-cli treasury post-credit-reversals
```
— Reverses a ReceivedCredit and creates a CreditReversal object.
```
stripe-pp-cli treasury post-debit-reversals
```
— Reverses a ReceivedDebit and creates a DebitReversal object.
```
stripe-pp-cli treasury post-financial-accounts
```
— Creates a new FinancialAccount. Each connected account can have up to three FinancialAccounts by default.

stripe-pp-cli treasury post-financial-accounts-financial-account

— Updates the details of a FinancialAccount.

```
stripe-pp-cli treasury post-financial-accounts-financial-account-close
```
— Closes a FinancialAccount. A FinancialAccount can only be closed if it has a zero balance, has no pending...

stripe-pp-cli treasury post-financial-accounts-financial-account-features

— Updates the Features associated with a FinancialAccount.

stripe-pp-cli treasury post-inbound-transfers

— Creates an InboundTransfer.

stripe-pp-cli treasury post-inbound-transfers-inbound-transfer-cancel

— Cancels an InboundTransfer.

stripe-pp-cli treasury post-outbound-payments

— Creates an OutboundPayment.

stripe-pp-cli treasury post-outbound-payments-id-cancel

— Cancel an OutboundPayment.

stripe-pp-cli treasury post-outbound-transfers

— Creates an OutboundTransfer.

```
stripe-pp-cli treasury post-outbound-transfers-outbound-transfer-cancel
```
— An OutboundTransfer can be canceled if the funds have not yet been paid out.

webhook-endpoints — Manage webhook endpoints

```
stripe-pp-cli webhook-endpoints delete
```
— You can also delete webhook endpoints via the <a href='https://dashboard.stripe.com/account/webhooks'>webhook...
```
stripe-pp-cli webhook-endpoints get
```
— Returns a list of your webhook endpoints.
```
stripe-pp-cli webhook-endpoints get-webhookendpoints
```
— Retrieves the webhook endpoint with the given ID.
```
stripe-pp-cli webhook-endpoints post
```
— A webhook endpoint must have a <code>url</code> and a list of <code>enabled_events</code>. You may optionally...
```
stripe-pp-cli webhook-endpoints post-webhookendpoints
```
— Updates the webhook endpoint. You may edit the <code>url</code>, the list of <code>enabled_events</code>, and the...

account — 管理账户

```
stripe-pp-cli account
```
— 获取账户详情。

account-links — 管理账户链接

```
stripe-pp-cli account-links
```
— 创建AccountLink对象，包含平台可重定向用户至的一次性Stripe URL...

account-sessions — 管理账户会话

```
stripe-pp-cli account-sessions
```
— 创建AccountSession对象，包含平台可在前端使用的一次性令牌...

accounts — 管理账户

```
stripe-pp-cli accounts delete
```
— 通过<a href='/connect'>Connect</a>，您可以删除管理的账户。 测试环境账户可被删除...
```
stripe-pp-cli accounts get
```
— 返回通过<a href='/docs/connect'>Connect</a>连接到平台的账户列表。如果您不是...
```
stripe-pp-cli accounts get-account
```
— 获取账户详情。
```
stripe-pp-cli accounts post
```
— 通过<a href='/docs/connect'>Connect</a>，您可以为用户创建Stripe账户。为此，您需要...
```
stripe-pp-cli accounts post-account
```
— 通过传递参数更新<a href='/connect/accounts'>关联账户</a>。任何未传递的参数将保持不变...

apple-pay — 管理Apple Pay

stripe-pp-cli apple-pay delete-domains-domain

— 删除Apple Pay域名。

```
stripe-pp-cli apple-pay get-domains
```
— 列出Apple Pay域名。

stripe-pp-cli apple-pay get-domains-domain

— 获取Apple Pay域名详情。

```
stripe-pp-cli apple-pay post-domains
```
— 创建Apple Pay域名。

application-fees — 管理应用费用

```
stripe-pp-cli application-fees get
```
— 返回您之前收取的应用费用列表。费用按创建时间倒序排列...
```
stripe-pp-cli application-fees get-id
```
— 获取您账户收取的应用费用详情。返回的信息与...

apps — 管理应用

```
stripe-pp-cli apps get-secrets
```
— 列出指定范围内存储的所有密钥。
```
stripe-pp-cli apps get-secrets-find
```
— 按名称和范围在密钥存储中查找密钥。
```
stripe-pp-cli apps post-secrets
```
— 在密钥存储中创建或替换密钥。
```
stripe-pp-cli apps post-secrets-delete
```
— 按名称和范围从密钥存储中删除密钥。

balance — 管理余额

```
stripe-pp-cli balance
```
— 基于请求使用的认证信息获取当前账户余额。对于...

balance-settings — 管理余额设置

```
stripe-pp-cli balance-settings get
```
— 获取指定关联账户的余额设置。相关指南：<a href='/connect/authentication'>发起...</a>
```
stripe-pp-cli balance-settings post
```
— 更新指定关联账户的余额设置。相关指南：<a href='/connect/authentication'>发起...</a>

balance-transactions — 管理余额交易

```
stripe-pp-cli balance-transactions get
```
— 返回对Stripe账户余额有贡献的交易列表（如收费、转账等...
```
stripe-pp-cli balance-transactions get-id
```
— 获取指定ID的余额交易详情。 注意：此端点之前使用的路径...

billing — 管理账单

```
stripe-pp-cli billing get-alerts
```
— 列出账单的活跃和非活跃警报
```
stripe-pp-cli billing get-alerts-id
```
— 根据ID获取账单警报详情

stripe-pp-cli billing get-credit-balance-summary

— 获取客户的信用余额摘要。

stripe-pp-cli billing get-credit-balance-transactions

— 获取信用余额交易列表。

stripe-pp-cli billing get-credit-balance-transactions-id

— 获取信用余额交易详情。

```
stripe-pp-cli billing get-credit-grants
```
— 获取信用授予列表。

stripe-pp-cli billing get-credit-grants-id

— 获取信用授予详情。

```
stripe-pp-cli billing get-meters
```
— 获取账单计量器列表。
```
stripe-pp-cli billing get-meters-id
```
— 根据ID获取账单计量器详情。
```
stripe-pp-cli billing get-meters-id-event-summaries
```
— 获取账单计量器事件摘要列表。
```
stripe-pp-cli billing post-alerts
```
— 创建账单警报
```
stripe-pp-cli billing post-alerts-id-activate
```
— 重新激活此警报，允许其再次触发。
```
stripe-pp-cli billing post-alerts-id-archive
```
— 归档此警报，将其从列表视图和API中移除。此操作不可逆。

stripe-pp-cli billing post-alerts-id-deactivate

— 停用此警报，阻止其触发。

stripe-pp-cli billing post-credit-grants

— 创建信用授予。

stripe-pp-cli billing post-credit-grants-id

— 更新信用授予。

stripe-pp-cli billing post-credit-grants-id-expire

— 使信用授予过期。

stripe-pp-cli billing post-credit-grants-id-void

— 作废信用授予。

stripe-pp-cli billing post-meter-event-adjustments

— 创建账单计量器事件调整。

```
stripe-pp-cli billing post-meter-events
```
— 创建账单计量器事件。
```
stripe-pp-cli billing post-meters
```
— 创建账单计量器。
```
stripe-pp-cli billing post-meters-id
```
— 更新账单计量器。
```
stripe-pp-cli billing post-meters-id-deactivate
```
— 当计量器被停用后，将不再接受此计量器的事件。您无法将...
```
stripe-pp-cli billing post-meters-id-reactivate
```
— 当计量器被重新激活后，可接受此计量器的事件，且您可以将计量器关联到价格。

billing-portal — 管理账单门户

```
stripe-pp-cli billing-portal get-configurations
```
— 返回描述客户门户功能的配置列表。

stripe-pp-cli billing-portal get-configurations-configuration

— 获取描述客户门户功能的配置详情。

```
stripe-pp-cli billing-portal post-configurations
```
— 创建描述PortalSession功能和行为的配置

stripe-pp-cli billing-portal post-configurations-configuration

— 更新描述客户门户功能的配置。

stripe-pp-cli billing-portal post-sessions

— 创建客户门户会话。

charges — 管理收费

```
stripe-pp-cli charges get
```
— 返回您之前创建的收费列表。收费按创建时间倒序排列，最新的...
```
stripe-pp-cli charges get-charge
```
— 获取之前创建的收费详情。提供创建收费时返回的唯一收费ID...
```
stripe-pp-cli charges get-search
```
— 使用Stripe的<a...搜索您之前创建的收费
```
stripe-pp-cli charges post
```
— 此方法不再推荐——使用<a href='/docs/api/payment_intents'>Payment Intents API</a>来...
```
stripe-pp-cli charges post-charge
```
— 通过传递参数更新指定收费。任何未提供的参数将保持不变...

checkout — 管理结账

```
stripe-pp-cli checkout get-sessions
```
— 返回Checkout会话列表。
```
stripe-pp-cli checkout get-sessions-session
```
— 获取Checkout会话对象详情。
```
stripe-pp-cli checkout get-sessions-session-line-items
```
— 获取Checkout会话时，可包含line_items属性，包含...
```
stripe-pp-cli checkout post-sessions
```
— 创建Checkout会话对象。
```
stripe-pp-cli checkout post-sessions-session
```
— 更新Checkout会话对象。 相关指南：<a href='/payments/advanced/dynamic-updates'>动态...</a>
```
stripe-pp-cli checkout post-sessions-session-expire
```
— 当Checkout会话处于<code>open</code>状态时可将其过期。 过期后...

climate — 管理气候相关服务

```
stripe-pp-cli climate get-orders
```
— 列出所有Climate订单对象。订单按创建时间倒序排列，最新创建的...
```
stripe-pp-cli climate get-orders-order
```
— 获取指定ID的Climate订单对象详情。
```
stripe-pp-cli climate get-products
```
— 列出所有可用的Climate产品对象。
```
stripe-pp-cli climate get-products-product
```
— 获取指定ID的Climate产品详情。
```
stripe-pp-cli climate get-suppliers
```
— 列出所有可用的Climate供应商对象。
```
stripe-pp-cli climate get-suppliers-supplier
```
— 获取Climate供应商对象详情。
```
stripe-pp-cli climate post-orders
```
— 为指定Climate产品创建Climate订单对象。订单将在创建后立即处理...
```
stripe-pp-cli climate post-orders-order
```
— 通过传递参数更新指定订单。
```
stripe-pp-cli climate post-orders-order-cancel
```
— 取消Climate订单。您可在创建后24小时内取消订单。Stripe将退还预订...

confirmation-tokens — 管理确认令牌

stripe-pp-cli confirmation-tokens <confirmation_token>

— 获取已存在的ConfirmationToken对象

country-specs — 管理国家规范

```
stripe-pp-cli country-specs get
```
— 列出API中可用的所有国家规范对象。
```
stripe-pp-cli country-specs get-country
```
— 返回指定国家代码的国家规范。

coupons — 管理优惠券

```
stripe-pp-cli coupons delete
```
— 您可通过<a href='https://dashboard.stripe.com/coupons'>优惠券管理</a>页面删除优惠券...
```
stripe-pp-cli coupons get
```
— 返回您的优惠券列表。
```
stripe-pp-cli coupons get-coupon
```
— 获取指定ID的优惠券详情。
```
stripe-pp-cli coupons post
```
— 您可通过<a href='https://dashboard.stripe.com/coupons'>优惠券管理</a>页面轻松创建优惠券...
```
stripe-pp-cli coupons post-coupon
```
— 更新优惠券的元数据。其他优惠券详情（货币、有效期、折扣金额）按设计不可修改...

credit-notes — 管理信用票据

```
stripe-pp-cli credit-notes get
```
— 返回信用票据列表。
```
stripe-pp-cli credit-notes get-id
```
— 获取指定标识符的信用票据对象详情。
```
stripe-pp-cli credit-notes get-preview
```
— 在创建信用票据前获取预览。
```
stripe-pp-cli credit-notes get-preview-lines
```
— 获取信用票据预览时，将包含lines属性，包含前...
```
stripe-pp-cli credit-notes post
```
— 开具信用票据以调整已完成发票的金额。信用票据将首先减少发票的...
```
stripe-pp-cli credit-notes post-id
```
— 更新已存在的信用票据。

customer-sessions — 管理客户会话

```
stripe-pp-cli customer-sessions
```
— 创建CustomerSession对象，包含前端可使用的一次性客户端密钥...

customers — 管理客户

```
stripe-pp-cli customers delete
```
— 永久删除客户。此操作不可逆。同时将立即取消客户的所有活跃订阅...
```
stripe-pp-cli customers get
```
— 返回您的客户列表。客户按创建时间倒序排列，最新的...
```
stripe-pp-cli customers get-customer
```
— 获取客户对象详情。
```
stripe-pp-cli customers get-search
```
— 使用Stripe的<a...搜索您之前创建的客户
```
stripe-pp-cli customers post
```
— 创建新客户对象。
```
stripe-pp-cli customers post-customer
```
— 通过传递参数更新指定客户。任何未提供的参数将保持不变...

disputes — 管理争议

```
stripe-pp-cli disputes get
```
— 返回您的争议列表。
```
stripe-pp-cli disputes get-dispute
```
— 获取指定ID的争议详情。
```
stripe-pp-cli disputes post
```
— 当收到争议时，联系客户始终是最佳第一步。如果无效，您可以...

entitlements — 管理权益

```
stripe-pp-cli entitlements get-active
```
— 获取客户的活跃权益列表

stripe-pp-cli entitlements get-active-id

— 获取活跃权益详情

```
stripe-pp-cli entitlements get-features
```
— 获取功能列表

stripe-pp-cli entitlements get-features-id

— 获取功能详情

stripe-pp-cli entitlements post-features

— 创建功能

```
stripe-pp-cli entitlements post-features-id
```
— 更新功能的元数据或永久停用它。

ephemeral-keys — 管理临时密钥

```
stripe-pp-cli ephemeral-keys delete-key
```
— 使指定资源的短期API密钥失效。
```
stripe-pp-cli ephemeral-keys post
```
— 为指定资源创建短期API密钥。

events — 管理事件

```
stripe-pp-cli events get
```
— 列出事件，最长可回溯30天。每个事件数据根据创建时的Stripe API版本渲染...
```
stripe-pp-cli events get-id
```
— 获取过去30天内创建的事件详情。提供事件的唯一标识符...

exchange-rates — 管理汇率

```
stripe-pp-cli exchange-rates get
```
— [已弃用]<code>ExchangeRate</code>API已弃用。请使用<a...
```
stripe-pp-cli exchange-rates get-rate-id
```
— [已弃用]<code>ExchangeRate</code>API已弃用。请使用<a...

file-links — 管理文件链接

```
stripe-pp-cli file-links get
```
— 返回文件链接列表。
```
stripe-pp-cli file-links get-link
```
— 获取指定ID的文件链接详情。
```
stripe-pp-cli file-links post
```
— 创建新文件链接对象。
```
stripe-pp-cli file-links post-link
```
— 更新已存在的文件链接对象。过期链接无法再更新。

files — 管理文件

```
stripe-pp-cli files get
```
— 返回您账户可访问的文件列表。Stripe按创建时间排序并返回文件...
```
stripe-pp-cli files get-file
```
— 获取已存在文件对象的详情。提供唯一文件ID后，Stripe将返回...
```
stripe-pp-cli files post
```
— 要向Stripe上传文件，您需要发送<code>multipart/form-data</code>类型的请求。包含文件...

financial-connections — 管理金融连接

```
stripe-pp-cli financial-connections get-accounts
```
— 返回Financial Connections<code>Account</code>对象列表。
```
stripe-pp-cli financial-connections get-accounts-account
```
— 获取Financial Connections<code>Account</code>的详情。

stripe-pp-cli financial-connections get-accounts-account-owners

— 列出指定<code>Account</code>的所有所有者

```
stripe-pp-cli financial-connections get-sessions-session
```
— 获取Financial Connections<code>Session</code>的详情
```
stripe-pp-cli financial-connections get-transactions
```
— 返回Financial Connections<code>Transaction</code>对象列表。
```
stripe-pp-cli financial-connections get-transactions-transaction
```
— 获取Financial Connections<code>Transaction</code>的详情
```
stripe-pp-cli financial-connections post-accounts-account-disconnect
```
— 禁用您对Financial Connections<code>Account</code>的访问权限。您将无法再访问数据...
```
stripe-pp-cli financial-connections post-accounts-account-refresh
```
— 刷新与Financial Connections<code>Account</code>关联的数据。
```
stripe-pp-cli financial-connections post-accounts-account-subscribe
```
— 订阅与Financial Connections<code>Account</code>关联的数据定期刷新。当...
```
stripe-pp-cli financial-connections post-accounts-account-unsubscribe
```
— 取消订阅与Financial Connections<code>Account</code>关联的数据定期刷新。
```
stripe-pp-cli financial-connections post-sessions
```
— 要启动Financial Connections授权流程，创建<code>Session</code>。会话的...

forwarding — 管理转发

```
stripe-pp-cli forwarding get-requests
```
— 列出所有ForwardingRequest对象。
```
stripe-pp-cli forwarding get-requests-id
```
— 获取ForwardingRequest对象详情。
```
stripe-pp-cli forwarding post-requests
```
— 创建ForwardingRequest对象。

identity — 管理身份验证

stripe-pp-cli identity get-verification-reports

— 列出所有验证报告。

stripe-pp-cli identity get-verification-reports-report

— 获取已存在的VerificationReport详情

stripe-pp-cli identity get-verification-sessions

— 返回VerificationSessions列表

```
stripe-pp-cli identity get-verification-sessions-session
```
— 获取之前创建的VerificationSession详情。 当会话状态为...
```
stripe-pp-cli identity post-verification-sessions
```
— 创建VerificationSession对象。 创建VerificationSession后，显示验证...
```
stripe-pp-cli identity post-verification-sessions-session
```
— 更新VerificationSession对象。 当会话状态为<code>requires_input</code>时，您可以使用...
```
stripe-pp-cli identity post-verification-sessions-session-cancel
```
— 当VerificationSession对象处于<code>requires_input</code>状态时可取消它...
```
stripe-pp-cli identity post-verification-sessions-session-redact
```
— 编辑VerificationSession以从Stripe中移除所有收集的信息。这将编辑...

invoice-payments — 管理发票支付

```
stripe-pp-cli invoice-payments get
```
— 获取发票时，可包含payments属性，包含前几个相关项...

stripe-pp-cli invoice-payments get-invoicepayments

— 获取指定ID的发票支付详情。

invoice-rendering-templates — 管理发票渲染模板

```
stripe-pp-cli invoice-rendering-templates get
```
— 列出所有模板，按创建时间排序，最新创建的模板排在最前面。
```
stripe-pp-cli invoice-rendering-templates get-template
```
— 获取指定ID的发票渲染模板详情。默认返回模板的最新版本...

invoiceitems — 管理发票项目

```
stripe-pp-cli invoiceitems delete
```
— 删除发票项目，将其从发票中移除。仅当发票项目未被...
```
stripe-pp-cli invoiceitems get
```
— 返回您的发票项目列表。发票项目按创建时间倒序排列，最新的...
```
stripe-pp-cli invoiceitems get-invoiceitem
```
— 获取指定ID的发票项目详情。
```
stripe-pp-cli invoiceitems post
```
— 创建将添加到草稿发票的项目（每张发票最多250个项目）。如果未指定发票，...
```
stripe-pp-cli invoiceitems post-invoiceitem
```
— 更新即将开具的发票上的发票项目金额或描述。仅当发票项目处于...

invoices — 管理发票

```
stripe-pp-cli invoices delete
```
— 永久删除一次性发票草稿。此操作不可逆。尝试删除已不再是...
```
stripe-pp-cli invoices get
```
— 您可以列出所有发票，或列出指定客户的发票。发票按创建时间排序...
```
stripe-pp-cli invoices get-invoice
```
— 获取指定ID的发票详情。
```
stripe-pp-cli invoices get-search
```
— 使用Stripe的<a...搜索您之前创建的发票
```
stripe-pp-cli invoices post
```
— 此端点为指定客户创建草稿发票。发票将保持草稿状态，直到您<a...
```
stripe-pp-cli invoices post-create-preview
```
— 您可随时预览订阅或订阅计划的即将开具发票。这将显示...
```
stripe-pp-cli invoices post-invoice
```
— 草稿发票可完全编辑。一旦发票<a href='/docs/billing/invoices/workflow#finalized'>完成...

issuing — 管理发卡

```
stripe-pp-cli issuing get-authorizations
```
— 返回Issuing<code>Authorization</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli issuing get-authorizations-authorization
```
— 获取Issuing<code>Authorization</code>对象详情。
```
stripe-pp-cli issuing get-cardholders
```
— 返回Issuing<code>Cardholder</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli issuing get-cardholders-cardholder
```
— 获取Issuing<code>Cardholder</code>对象详情。
```
stripe-pp-cli issuing get-cards
```
— 返回Issuing<code>Card</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli issuing get-cards-card
```
— 获取Issuing<code>Card</code>对象详情。
```
stripe-pp-cli issuing get-disputes
```
— 返回Issuing<code>Dispute</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli issuing get-disputes-dispute
```
— 获取Issuing<code>Dispute</code>对象详情。
```
stripe-pp-cli issuing get-personalization-designs
```
— 返回个性化设计对象列表。对象按创建时间倒序排列...

stripe-pp-cli issuing get-personalization-designs-personalization-design

— 获取个性化设计对象详情。

```
stripe-pp-cli issuing get-physical-bundles
```
— 返回物理捆绑包对象列表。对象按创建时间倒序排列...

stripe-pp-cli issuing get-physical-bundles-physical-bundle

— 获取物理捆绑包对象详情。

```
stripe-pp-cli issuing get-tokens
```
— 列出指定卡片的所有Issuing<code>Token</code>对象。
```
stripe-pp-cli issuing get-tokens-token
```
— 获取Issuing<code>Token</code>对象详情。
```
stripe-pp-cli issuing get-transactions
```
— 返回Issuing<code>Transaction</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli issuing get-transactions-transaction
```
— 获取Issuing<code>Transaction</code>对象详情。
```
stripe-pp-cli issuing post-authorizations-authorization
```
— 通过传递参数更新指定Issuing<code>Authorization</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli issuing post-authorizations-authorization-approve
```
— [已弃用] 批准待处理的Issuing<code>Authorization</code>对象。此请求应在...
```
stripe-pp-cli issuing post-authorizations-authorization-decline
```
— [已弃用] 拒绝待处理的Issuing<code>Authorization</code>对象。此请求应在...
```
stripe-pp-cli issuing post-cardholders
```
— 创建可发卡的新Issuing<code>Cardholder</code>对象。
```
stripe-pp-cli issuing post-cardholders-cardholder
```
— 通过传递参数更新指定Issuing<code>Cardholder</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli issuing post-cards
```
— 创建Issuing<code>Card</code>对象。
```
stripe-pp-cli issuing post-cards-card
```
— 通过传递参数更新指定Issuing<code>Card</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli issuing post-disputes
```
— 创建Issuing<code>Dispute</code>对象。<code>evidence</code>中的个别证据项...
```
stripe-pp-cli issuing post-disputes-dispute
```
— 通过传递参数更新指定Issuing<code>Dispute</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli issuing post-disputes-dispute-submit
```
— 向卡网络提交Issuing<code>Dispute</code>。Stripe将验证所需的所有证据字段...

stripe-pp-cli issuing post-personalization-designs

— 创建个性化设计对象。

stripe-pp-cli issuing post-personalization-designs-personalization-design

— 更新卡片个性化对象。

```
stripe-pp-cli issuing post-tokens-token
```
— 尝试将指定Issuing<code>Token</code>对象更新为指定状态。
```
stripe-pp-cli issuing post-transactions-transaction
```
— 通过传递参数更新指定Issuing<code>Transaction</code>对象。任何未提供的参数将保持不变...

mandates — 管理授权书

```
stripe-pp-cli mandates
```
— 获取授权书对象详情。

payment-attempt-records — 管理支付尝试记录

```
stripe-pp-cli payment-attempt-records get
```
— 列出附加到指定支付记录的所有支付尝试记录。
```
stripe-pp-cli payment-attempt-records get-id
```
— 获取指定ID的支付尝试记录详情

payment-intents — 管理支付意向

```
stripe-pp-cli payment-intents get
```
— 返回PaymentIntents列表。
```
stripe-pp-cli payment-intents get-intent
```
— 获取之前创建的PaymentIntent详情。 您可以获取...
```
stripe-pp-cli payment-intents get-search
```
— 使用Stripe的<a...搜索您之前创建的PaymentIntents
```
stripe-pp-cli payment-intents post
```
— 创建PaymentIntent对象。 创建PaymentIntent后，关联支付方式并<a...
```
stripe-pp-cli payment-intents post-intent
```
— 在不确认的情况下更新PaymentIntent对象的属性。 根据您更新的属性...

payment-links — 管理支付链接

```
stripe-pp-cli payment-links get
```
— 返回您的支付链接列表。

stripe-pp-cli payment-links get-paymentlinks

— 获取支付链接详情。

```
stripe-pp-cli payment-links post
```
— 创建支付链接。

stripe-pp-cli payment-links post-paymentlinks

— 更新支付链接。

payment-method-configurations — 管理支付方式配置

stripe-pp-cli payment-method-configurations get

— 列出支付方式配置

stripe-pp-cli payment-method-configurations get-configuration

— 获取支付方式配置详情

stripe-pp-cli payment-method-configurations post

— 创建支付方式配置

stripe-pp-cli payment-method-configurations post-configuration

— 更新支付方式配置

payment-method-domains — 管理支付方式域名

```
stripe-pp-cli payment-method-domains get
```
— 列出已存在的支付方式域名详情。

stripe-pp-cli payment-method-domains get-paymentmethoddomains

— 获取已存在的支付方式域名详情。

stripe-pp-cli payment-method-domains post

— 创建支付方式域名。

stripe-pp-cli payment-method-domains post-paymentmethoddomains

— 更新已存在的支付方式域名。

payment-methods — 管理支付方式

```
stripe-pp-cli payment-methods get
```
— 返回所有PaymentMethods列表。
```
stripe-pp-cli payment-methods get-paymentmethods
```
— 获取附加到Stripe账户的PaymentMethod对象详情。要获取附加到客户的支付方式...
```
stripe-pp-cli payment-methods post
```
— 创建PaymentMethod对象。阅读<a href='/docs/stripe-js/reference#stripe-create-payment-method'>Stripe.j...</a>
```
stripe-pp-cli payment-methods post-paymentmethods
```
— 更新PaymentMethod对象。PaymentMethod必须附加到客户才能更新。

payment-records — 管理支付记录

```
stripe-pp-cli payment-records get-id
```
— 获取指定ID的支付记录详情
```
stripe-pp-cli payment-records post-report-payment
```
— 报告新的支付记录。您可在初始化时报告支付记录，并在后续报告更新...

payouts — 管理付款

```
stripe-pp-cli payouts get
```
— 返回已发送到第三方银行账户的付款列表，或Stripe发送给您的付款列表。付款按创建时间排序...
```
stripe-pp-cli payouts get-payout
```
— 获取已存在的付款详情。提供付款创建请求或...
```
stripe-pp-cli payouts post
```
— 要将资金发送到您自己的银行账户，创建新的付款对象。您的<a href='#balance'>Stripe余额</a>...
```
stripe-pp-cli payouts post-payout
```
— 通过传递参数更新指定付款。我们不会更改您未传递的参数...

plans — 管理计划

```
stripe-pp-cli plans delete
```
— 删除计划意味着无法添加新订阅者。现有订阅者不受影响。
```
stripe-pp-cli plans get
```
— 返回您的计划列表。
```
stripe-pp-cli plans get-plan
```
— 获取指定ID的计划详情。
```
stripe-pp-cli plans post
```
— 您现在可以使用<a href='#prices'>Prices API</a>更灵活地建模订阅。它取代了Plans...
```
stripe-pp-cli plans post-plan
```
— 通过传递参数更新指定计划。任何未提供的参数将保持不变...

prices — 管理价格

```
stripe-pp-cli prices get
```
— 返回您的活跃价格列表，不包含<a href='/docs/products-prices/pricing-models#inline-pricing'>内联...
```
stripe-pp-cli prices get-price
```
— 获取指定ID的价格详情。
```
stripe-pp-cli prices get-search
```
— 使用Stripe的<a...搜索您之前创建的价格
```
stripe-pp-cli prices post
```
— 为已存在的<a...创建新的<a href='https://docs.stripe.com/api/prices'>Price</a>
```
stripe-pp-cli prices post-price
```
— 通过传递参数更新指定价格。任何未提供的参数将保持不变...

products — 管理产品

```
stripe-pp-cli products delete-id
```
— 删除产品。仅当产品没有关联价格时才能删除。此外...
```
stripe-pp-cli products get
```
— 返回您的产品列表。产品按创建时间倒序排列，最新的...
```
stripe-pp-cli products get-id
```
— 获取已存在产品的详情。提供产品创建请求或...
```
stripe-pp-cli products get-search
```
— 使用Stripe的<a...搜索您之前创建的产品
```
stripe-pp-cli products post
```
— 创建新产品对象。
```
stripe-pp-cli products post-id
```
— 通过传递参数更新指定产品。任何未提供的参数将保持不变...

promotion-codes — 管理促销代码

```
stripe-pp-cli promotion-codes get
```
— 返回您的促销代码列表。
```
stripe-pp-cli promotion-codes get-promotioncodes
```
— 获取指定ID的促销代码详情。要通过客户可见的代码获取促销代码...
```
stripe-pp-cli promotion-codes post
```
— 促销代码指向底层促销活动。您可选择将代码限制为特定客户...
```
stripe-pp-cli promotion-codes post-promotioncodes
```
— 通过传递参数更新指定促销代码。大多数字段按设计不可修改...

quotes — 管理报价

```
stripe-pp-cli quotes get
```
— 返回您的报价列表。
```
stripe-pp-cli quotes get-quote
```
— 获取指定ID的报价详情。
```
stripe-pp-cli quotes post
```
— 报价为客户建模价格和服务。<code>header</code>的默认选项...
```
stripe-pp-cli quotes post-quote
```
— 报价为客户建模价格和服务。

radar — 管理Radar

```
stripe-pp-cli radar delete-value-list-items-item
```
— 删除<code>ValueListItem</code>对象，将其从父值列表中移除。
```
stripe-pp-cli radar delete-value-lists-value-list
```
— 删除<code>ValueList</code>对象，同时删除值列表中包含的所有项。要删除...

stripe-pp-cli radar get-early-fraud-warnings

— 返回早期欺诈警告列表。

```
stripe-pp-cli radar get-early-fraud-warnings-early-fraud-warning
```
— 获取之前创建的早期欺诈警告详情。 请参考<a...
```
stripe-pp-cli radar get-value-list-items
```
— 返回<code>ValueListItem</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli radar get-value-list-items-item
```
— 获取<code>ValueListItem</code>对象详情。
```
stripe-pp-cli radar get-value-lists
```
— 返回<code>ValueList</code>对象列表。对象按创建时间倒序排列...
```
stripe-pp-cli radar get-value-lists-value-list
```
— 获取<code>ValueList</code>对象详情。
```
stripe-pp-cli radar post-payment-evaluations
```
— 在将支付发送到外部处理器之前，向Stripe请求Radar API欺诈风险评分...
```
stripe-pp-cli radar post-value-list-items
```
— 创建新的<code>ValueListItem</code>对象，将其添加到指定的父值列表中。
```
stripe-pp-cli radar post-value-lists
```
— 创建新的<code>ValueList</code>对象，可在规则中引用。
```
stripe-pp-cli radar post-value-lists-value-list
```
— 通过传递参数更新<code>ValueList</code>对象。任何未提供的参数将保持不变...

refunds — 管理退款

```
stripe-pp-cli refunds get
```
— 返回您创建的所有退款列表。我们按创建时间倒序排列退款，最新的...
```
stripe-pp-cli refunds get-refund
```
— 获取已存在的退款详情。
```
stripe-pp-cli refunds post
```
— 创建新退款时，必须指定要创建退款的Charge或PaymentIntent对象。...
```
stripe-pp-cli refunds post-refund
```
— 通过传递参数更新指定退款。任何您未传递的参数将保持不变...

reporting — 管理报告

```
stripe-pp-cli reporting get-report-runs
```
— 返回报告运行列表，最新的排在最前面。

stripe-pp-cli reporting get-report-runs-report-run

— 获取已存在的报告运行详情。

```
stripe-pp-cli reporting get-report-types
```
— 返回报告类型的完整列表。
```
stripe-pp-cli reporting get-report-types-report-type
```
— 获取报告类型详情。（某些报告类型需要<a...
```
stripe-pp-cli reporting post-report-runs
```
— 创建新对象并开始运行报告。（某些报告类型需要<a...

reviews — 管理审核

```
stripe-pp-cli reviews get
```
— 返回<code>open</code>设置为<code>true</code>的<code>Review</code>对象列表。对象按创建时间排序...
```
stripe-pp-cli reviews get-review
```
— 获取<code>Review</code>对象详情。

setup-attempts — 管理设置尝试

```
stripe-pp-cli setup-attempts
```
— 返回与指定SetupIntent关联的SetupAttempts列表。

setup-intents — 管理设置意向

```
stripe-pp-cli setup-intents get
```
— 返回SetupIntents列表。
```
stripe-pp-cli setup-intents get-intent
```
— 获取之前创建的SetupIntent详情。 客户端可使用...
```
stripe-pp-cli setup-intents post
```
— 创建SetupIntent对象。 创建SetupIntent后，关联支付方式并<a...
```
stripe-pp-cli setup-intents post-intent
```
— 更新SetupIntent对象。

shipping-rates — 管理运费

```
stripe-pp-cli shipping-rates get
```
— 返回您的运费列表。
```
stripe-pp-cli shipping-rates get-token
```
— 返回指定ID的运费对象详情。
```
stripe-pp-cli shipping-rates post
```
— 创建新运费对象。
```
stripe-pp-cli shipping-rates post-token
```
— 更新已存在的运费对象。

sigma — 管理Sigma

stripe-pp-cli sigma get-scheduled-query-runs

— 返回定时查询运行列表。

stripe-pp-cli sigma get-scheduled-query-runs-scheduled-query-run

— 获取定时查询运行详情。

sources — 管理来源

```
stripe-pp-cli sources get
```
— 获取已存在的来源对象详情。提供来源创建请求返回的唯一来源ID，Stripe将...
```
stripe-pp-cli sources post
```
— 创建新来源对象。
```
stripe-pp-cli sources post-source
```
— 通过传递参数更新指定来源。任何未提供的参数将保持不变...

subscription-items — 管理订阅项目

```
stripe-pp-cli subscription-items delete-item
```
— 从订阅中删除项目。从订阅中移除订阅项目不会取消订阅...
```
stripe-pp-cli subscription-items get
```
— 返回指定订阅的订阅项目列表。
```
stripe-pp-cli subscription-items get-item
```
— 获取指定ID的订阅项目详情。
```
stripe-pp-cli subscription-items post
```
— 向已存在的订阅添加新项目。现有项目不会被更改或替换。
```
stripe-pp-cli subscription-items post-item
```
— 更新当前订阅中项目的计划或数量。

subscription-schedules — 管理订阅计划

```
stripe-pp-cli subscription-schedules get
```
— 返回您的订阅计划列表。
```
stripe-pp-cli subscription-schedules get-schedule
```
— 获取已存在的订阅计划详情。您只需提供唯一的订阅...
```
stripe-pp-cli subscription-schedules post
```
— 创建新订阅计划对象。每个客户最多可拥有500个活跃或计划中的订阅。

stripe-pp-cli subscription-schedules post-schedule

— 更新已存在的订阅计划。

subscriptions — 管理订阅

```
stripe-pp-cli subscriptions delete-exposed-id
```
— 立即取消客户的订阅。客户将不再被收取订阅费用...
```
stripe-pp-cli subscriptions get
```
— 默认情况下，返回未取消的订阅列表。要列出已取消的订阅...

stripe-pp-cli subscriptions get-exposed-id

— 获取指定ID的订阅详情。

```
stripe-pp-cli subscriptions get-search
```
— 使用Stripe的<a...搜索您之前创建的订阅
```
stripe-pp-cli subscriptions post
```
— 在已存在的客户上创建新订阅。每个客户最多可拥有500个活跃或计划中的...
```
stripe-pp-cli subscriptions post-exposed-id
```
— 更新已存在的订阅以匹配指定参数。更改价格或数量时，我们...

tax — 管理税务

```
stripe-pp-cli tax get-associations-find
```
— 按PaymentIntent ID查找税务关联对象。
```
stripe-pp-cli tax get-calculations-calculation
```
— 获取Tax<code>Calculation</code>对象详情，如果计算未过期。
```
stripe-pp-cli tax get-calculations-calculation-line-items
```
— 获取税务计算的行项目集合，如果计算未过期。
```
stripe-pp-cli tax get-registrations
```
— 返回Tax<code>Registration</code>对象列表。
```
stripe-pp-cli tax get-registrations-id
```
— 返回Tax<code>Registration</code>对象详情。
```
stripe-pp-cli tax get-settings
```
— 获取商家的Tax<code>Settings</code>详情。
```
stripe-pp-cli tax get-transactions-transaction
```
— 获取Tax<code>Transaction</code>对象详情。
```
stripe-pp-cli tax get-transactions-transaction-line-items
```
— 获取已提交独立交易的行项目集合。
```
stripe-pp-cli tax post-calculations
```
— 根据输入计算税务并返回Tax<code>Calculation</code>对象。
```
stripe-pp-cli tax post-registrations
```
— 创建新的Tax<code>Registration</code>对象。
```
stripe-pp-cli tax post-registrations-id
```
— 更新已存在的Tax<code>Registration</code>对象。 注册完成后无法删除...
```
stripe-pp-cli tax post-settings
```
— 更新税务计算中使用的Tax<code>Settings</code>参数。所有参数均可编辑，但无...
```
stripe-pp-cli tax post-transactions-create-from-calculation
```
— 根据计算创建税务交易，如果计算未过期。计算将在90天后过期...
```
stripe-pp-cli tax post-transactions-create-reversal
```
— 部分或完全撤销之前创建的<code>Transaction</code>。

tax-codes — 管理税务代码

```
stripe-pp-cli tax-codes get
```
— <a href='https://stripe.com/docs/tax/tax-categories'>所有可用税务代码</a>的列表，可添加到产品中...
```
stripe-pp-cli tax-codes get-id
```
— 获取已存在的税务代码详情。提供唯一税务代码ID，Stripe将返回...

tax-ids — 管理税务ID

```
stripe-pp-cli tax-ids delete-id
```
— 删除已存在的账户或客户<code>tax_id</code>对象。
```
stripe-pp-cli tax-ids get
```
— 返回税务ID列表。
```
stripe-pp-cli tax-ids get-id
```
— 获取账户或客户<code>tax_id</code>对象详情。
```
stripe-pp-cli tax-ids post
```
— 创建新的账户或客户<code>tax_id</code>对象。

tax-rates — 管理税率

```
stripe-pp-cli tax-rates get
```
— 返回您的税率列表。税率按创建时间倒序排列，最新创建的...
```
stripe-pp-cli tax-rates get-taxrates
```
— 获取指定ID的税率详情
```
stripe-pp-cli tax-rates post
```
— 创建新税率。
```
stripe-pp-cli tax-rates post-taxrates
```
— 更新已存在的税率。

terminal — 管理终端

stripe-pp-cli terminal delete-configurations-configuration

— 删除<code>Configuration</code>对象。

stripe-pp-cli terminal delete-locations-location

— 删除<code>Location</code>对象。

stripe-pp-cli terminal delete-readers-reader

— 删除<code>Reader</code>对象。

```
stripe-pp-cli terminal get-configurations
```
— 返回<code>Configuration</code>对象列表。
```
stripe-pp-cli terminal get-configurations-configuration
```
— 获取<code>Configuration</code>对象详情。
```
stripe-pp-cli terminal get-locations
```
— 返回<code>Location</code>对象列表。
```
stripe-pp-cli terminal get-locations-location
```
— 获取<code>Location</code>对象详情。
```
stripe-pp-cli terminal get-readers
```
— 返回<code>Reader</code>对象列表。
```
stripe-pp-cli terminal get-readers-reader
```
— 获取<code>Reader</code>对象详情。
```
stripe-pp-cli terminal post-configurations
```
— 创建新的<code>Configuration</code>对象。
```
stripe-pp-cli terminal post-configurations-configuration
```
— 更新新的<code>Configuration</code>对象。
```
stripe-pp-cli terminal post-connection-tokens
```
— 要连接到读卡器，Stripe Terminal SDK需要从Stripe获取短期连接令牌...
```
stripe-pp-cli terminal post-locations
```
— 创建新的<code>Location</code>对象。更多详情，包括所需的地址字段...
```
stripe-pp-cli terminal post-locations-location
```
— 通过传递参数更新<code>Location</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli terminal post-onboarding-links
```
— 创建新的<code>OnboardingLink</code>对象，包含用于Tap to Pay入职的重定向URL...
```
stripe-pp-cli terminal post-readers
```
— 创建新的<code>Reader</code>对象。
```
stripe-pp-cli terminal post-readers-reader
```
— 通过传递参数更新<code>Reader</code>对象。任何未提供的参数将保持不变...
```
stripe-pp-cli terminal post-readers-reader-cancel-action
```
— 取消当前读卡器操作。请参阅<a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platform...'>
```
stripe-pp-cli terminal post-readers-reader-collect-inputs
```
— 在读卡器上启动<a href='/docs/terminal/features/collect-inputs'>输入收集流程</a>以显示...
```
stripe-pp-cli terminal post-readers-reader-collect-payment-method
```
— 在读卡器上启动支付流程，并在手动确认前使用卡片详情更新PaymentIntent...
```
stripe-pp-cli terminal post-readers-reader-confirm-payment-intent
```
— 在读卡器上完成支付。请参阅<a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platform=s...'>
```
stripe-pp-cli terminal post-readers-reader-process-payment-intent
```
— 在读卡器上启动支付流程。请参阅<a href='/docs/terminal/payments/collect-card-payment?terminal-sdk-platf...'>
```
stripe-pp-cli terminal post-readers-reader-process-setup-intent
```
— 在读卡器上启动SetupIntent流程。请参阅<a href='/docs/terminal/features/saving-payment-details/save-directl...'>
```
stripe-pp-cli terminal post-readers-reader-refund-payment
```
— 在读卡器上启动线下退款。请参阅<a href='/docs/terminal/payments/regional?integration-country=CA#re...'>
```
stripe-pp-cli terminal post-readers-reader-set-reader-display
```
— 设置读卡器显示以显示<a href='/docs/terminal/features/display'>购物车详情</a>。

test-helpers — 管理测试辅助工具

stripe-pp-cli test-helpers delete-test-clocks-test-clock

— 删除测试时钟。

```
stripe-pp-cli test-helpers get-test-clocks
```
— 返回您的测试时钟列表。

stripe-pp-cli test-helpers get-test-clocks-test-clock

— 获取测试时钟详情。

```
stripe-pp-cli test-helpers post-confirmation-tokens
```
— 为您的集成测试在服务器端创建测试模式的确认令牌。

stripe-pp-cli test-helpers post-customers-customer-fund-cash-balance

— 创建测试环境的银行转账入金

stripe-pp-cli test-helpers post-issuing-authorizations

— 创建测试模式的授权。

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-capture

— 捕获测试模式的授权。

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-expire

— 使测试模式的授权过期。

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-finalize-amount

— 在捕获前确定授权金额，当初始授权为估算金额时...

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-fraud-challenges-respond

— 响应测试环境Issuing授权的欺诈挑战，模拟欺诈确认或...

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-increment

— 增加测试模式的授权金额。

stripe-pp-cli test-helpers post-issuing-authorizations-authorization-reverse

— 撤销测试模式的授权。

```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-deliver
```
— 将指定Issuing<code>Card</code>对象的运输状态更新为<code>delivered</code>。
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-fail
```
— 将指定Issuing<code>Card</code>对象的运输状态更新为<code>failure</code>。
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-return
```
— 将指定Issuing<code>Card</code>对象的运输状态更新为<code>returned</code>。
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-ship
```
— 将指定Issuing<code>Card</code>对象的运输状态更新为<code>shipped</code>。
```
stripe-pp-cli test-helpers post-issuing-cards-card-shipping-submit
```
— 将指定Issuing<code>Card</code>对象的运输状态更新为<code>submitted</code>。这...
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-activate
```
— 将指定测试环境个性化设计对象的<code>status</code>更新为<code>active</code>。
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-deactivate
```
— 将指定测试环境个性化设计对象的<code>status</code>更新为<code>inactive</code>。
```
stripe-pp-cli test-helpers post-issuing-personalization-designs-personalization-design-reject
```
— 将指定测试环境个性化设计对象的<code>status</code>更新为<code>rejected</code>。

stripe-pp-cli test-helpers post-issuing-transactions-create-force-capture

— 允许用户捕获任意金额，也称为强制捕获。

stripe-pp-cli test-helpers post-issuing-transactions-create-unlinked-refund

— 允许用户退款任意金额，也称为无关联退款。

stripe-pp-cli test-helpers post-issuing-transactions-transaction-refund

— 退款测试模式的交易。

```
stripe-pp-cli test-helpers post-refunds-refund-expire
```
— 使状态为<code>requires_action</code>的退款过期。
```
stripe-pp-cli test-helpers post-terminal-readers-reader-present-payment-method
```
— 在模拟读卡器上呈现支付方式。可用于模拟接受支付、保存卡片或...

stripe-pp-cli test-helpers post-terminal-readers-reader-succeed-input-collection

— 使用此端点在模拟读卡器上触发成功的输入收集。

```
stripe-pp-cli test-helpers post-terminal-readers-reader-timeout-input-collection
```
— 使用此端点在模拟读卡器上完成输入收集并返回超时错误。
```
stripe-pp-cli test-helpers post-test-clocks
```
— 创建可附加到新客户和报价的新测试时钟。
```
stripe-pp-cli test-helpers post-test-clocks-test-clock-advance
```
— 开始将测试时钟推进到未来指定时间。当状态变为...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-fail
```
— 将测试环境创建的InboundTransfer转换为<code>failed</code>状态。InboundTransfer必须...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-return
```
— 将测试环境InboundTransfer对象标记为已退回，并将InboundTransfer关联到ReceivedDebit。...
```
stripe-pp-cli test-helpers post-treasury-inbound-transfers-id-succeed
```
— 将测试环境创建的InboundTransfer转换为<code>succeeded</code>状态。InboundTransfer必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id
```
— 使用跟踪详情更新测试环境创建的OutboundPayment。OutboundPayment必须不可取消...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-fail
```
— 将测试环境创建的OutboundPayment转换为<code>failed</code>状态。OutboundPayment必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-post
```
— 将测试环境创建的OutboundPayment转换为<code>posted</code>状态。OutboundPayment必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-payments-id-return
```
— 将测试环境创建的OutboundPayment转换为<code>returned</code>状态。OutboundPayment必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer
```
— 使用跟踪详情更新测试环境创建的OutboundTransfer。OutboundTransfer必须不可取消...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-fail
```
— 将测试环境创建的OutboundTransfer转换为<code>failed</code>状态。OutboundTransfer必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-post
```
— 将测试环境创建的OutboundTransfer转换为<code>posted</code>状态。OutboundTransfer必须...
```
stripe-pp-cli test-helpers post-treasury-outbound-transfers-outbound-transfer-return
```
— 将测试环境创建的OutboundTransfer转换为<code>returned</code>状态。OutboundTransfer必须...
```
stripe-pp-cli test-helpers post-treasury-received-credits
```
— 使用此端点模拟第三方发起的测试环境ReceivedCredit。在生产环境中，您无法...
```
stripe-pp-cli test-helpers post-treasury-received-debits
```
— 使用此端点模拟第三方发起的测试环境ReceivedDebit。在生产环境中，您无法...

tokens — 管理令牌

```
stripe-pp-cli tokens get
```
— 获取指定ID的令牌详情。
```
stripe-pp-cli tokens post
```
— 创建代表银行账户详情的一次性令牌。您可将此令牌用于任何v1 API...

topups — 管理充值

```
stripe-pp-cli topups get
```
— 返回充值列表。
```
stripe-pp-cli topups get-topup
```
— 获取之前创建的充值详情。提供充值创建请求返回的唯一充值ID...
```
stripe-pp-cli topups post
```
— 为账户余额充值
```
stripe-pp-cli topups post-topup
```
— 更新充值的元数据。其他充值详情按设计不可编辑。

transfers — 管理转账

```
stripe-pp-cli transfers get
```
— 返回已发送到关联账户的转账列表。转账按创建时间排序...
```
stripe-pp-cli transfers get-transfer
```
— 获取已存在的转账详情。提供转账创建请求或...
```
stripe-pp-cli transfers post
```
— 要将资金从您的Stripe账户发送到关联账户，创建新的转账对象。您的<a...
```
stripe-pp-cli transfers post-transfer
```
— 通过传递参数更新指定转账。任何未提供的参数将保持不变...

treasury — 管理财务库

stripe-pp-cli treasury get-credit-reversals

— 返回CreditReversals列表。

```
stripe-pp-cli treasury get-credit-reversals-credit-reversal
```
— 通过传递CreditReversal创建时返回的唯一ID获取已存在的CreditReversal详情...

stripe-pp-cli treasury get-debit-reversals

— 返回DebitReversals列表。

stripe-pp-cli treasury get-debit-reversals-debit-reversal

— 获取DebitReversal对象详情。

stripe-pp-cli treasury get-financial-accounts

— 返回FinancialAccounts列表。

stripe-pp-cli treasury get-financial-accounts-financial-account

— 获取FinancialAccount详情。

stripe-pp-cli treasury get-financial-accounts-financial-account-features

— 获取与FinancialAccount关联的功能信息。

```
stripe-pp-cli treasury get-inbound-transfers
```
— 返回从指定FinancialAccount发送的InboundTransfers列表。
```
stripe-pp-cli treasury get-inbound-transfers-id
```
— 获取已存在的InboundTransfer详情。
```
stripe-pp-cli treasury get-outbound-payments
```
— 返回从指定FinancialAccount发送的OutboundPayments列表。
```
stripe-pp-cli treasury get-outbound-payments-id
```
— 通过传递OutboundPayment创建时返回的唯一ID获取已存在的OutboundPayment详情...
```
stripe-pp-cli treasury get-outbound-transfers
```
— 返回从指定FinancialAccount发送的OutboundTransfers列表。
```
stripe-pp-cli treasury get-outbound-transfers-outbound-transfer
```
— 通过传递OutboundTransfer创建时返回的唯一ID获取已存在的OutboundTransfer详情...

stripe-pp-cli treasury get-received-credits

— 返回ReceivedCredits列表。

```
stripe-pp-cli treasury get-received-credits-id
```
— 通过传递ReceivedCredit创建时返回的唯一ID获取已存在的ReceivedCredit详情...

stripe-pp-cli treasury get-received-debits

— 返回ReceivedDebits列表。

```
stripe-pp-cli treasury get-received-debits-id
```
— 通过传递ReceivedDebit创建时返回的唯一ID获取已存在的ReceivedDebit详情...
```
stripe-pp-cli treasury get-transaction-entries
```
— 返回TransactionEntry对象列表。

stripe-pp-cli treasury get-transaction-entries-id

— 获取TransactionEntry对象详情。

```
stripe-pp-cli treasury get-transactions
```
— 返回Transaction对象列表。
```
stripe-pp-cli treasury get-transactions-id
```
— 获取已存在的Transaction详情。
```
stripe-pp-cli treasury post-credit-reversals
```
— 撤销ReceivedCredit并创建CreditReversal对象。
```
stripe-pp-cli treasury post-debit-reversals
```
— 撤销ReceivedDebit并创建DebitReversal对象。
```
stripe-pp-cli treasury post-financial-accounts
```
— 创建新的FinancialAccount。每个关联账户默认最多可拥有三个FinancialAccount。

stripe-pp-cli treasury post-financial-accounts-financial-account

— 更新FinancialAccount详情。

```
stripe-pp-cli treasury post-financial-accounts-financial-account-close
```
— 关闭FinancialAccount。仅当FinancialAccount余额为零且无待处理...

stripe-pp-cli treasury post-financial-accounts-financial-account-features

— 更新与FinancialAccount关联的功能。

stripe-pp-cli treasury post-inbound-transfers

— 创建InboundTransfer。

stripe-pp-cli treasury post-inbound-transfers-inbound-transfer-cancel

— 取消InboundTransfer。

stripe-pp-cli treasury post-outbound-payments

— 创建OutboundPayment。

stripe-pp-cli treasury post-outbound-payments-id-cancel

— 取消OutboundPayment。

stripe-pp-cli treasury post-outbound-transfers

— 创建OutboundTransfer。

stripe-pp-cli treasury post-outbound-transfers-outbound-transfer-cancel

— 如果资金尚未支付，可取消OutboundTransfer。

webhook-endpoints — 管理Webhook端点

```
stripe-pp-cli webhook-endpoints delete
```
— 您也可通过<a href='https://dashboard.stripe.com/account/webhooks'>Webhook...</a>页面删除Webhook端点...
```
stripe-pp-cli webhook-endpoints get
```
— 返回您的Webhook端点列表。

stripe-pp-cli webhook-endpoints get-webhookendpoints

— 获取指定ID的Webhook端点详情。

```
stripe-pp-cli webhook-endpoints post
```
— Webhook端点必须包含<code>url</code>和<code>enabled_events</code>列表。您可选择...
```
stripe-pp-cli webhook-endpoints post-webhookendpoints
```
— 更新Webhook端点。您可编辑<code>url</code>、<code>enabled_events</code>列表和...

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:

bash

stripe-pp-cli which "<capability in your own words>"

which

resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当您知道要执行的操作但不知道对应命令时，可直接询问CLI：

bash

stripe-pp-cli which "<用您自己的语言描述功能>"

which

命令会将自然语言功能查询解析为CLI精选功能索引中最匹配的命令。退出码

表示至少找到一个匹配项；退出码

表示没有找到可信匹配项——请回退到

--help

或使用更精确的查询。

Recipes

使用示例

Find double-subscribed customers

查找重复订阅的客户

bash

stripe-pp-cli sql 'SELECT json_extract(s.data,"$.customer") AS cid, COUNT(*) AS subs FROM resources s WHERE s.resource_type="subscriptions" AND json_extract(s.data,"$.status")="active" GROUP BY cid HAVING subs > 1' --json

All Stripe data lives in the generic

resources

table; query JSON fields with json_extract.

bash

stripe-pp-cli sql 'SELECT json_extract(s.data,"$.customer") AS cid, COUNT(*) AS subs FROM resources s WHERE s.resource_type="subscriptions" AND json_extract(s.data,"$.status")="active" GROUP BY cid HAVING subs > 1' --json

所有Stripe数据存储在通用的

resources

表中；使用json_extract查询JSON字段。

Top 10 customers with at-risk PM

支付方式存在风险的前10位客户

bash

stripe-pp-cli subs-at-risk --within 30d --limit 10 --json --select customer_email,mrr,card_exp

Email these customers proactively before involuntary churn hits.

bash

stripe-pp-cli subs-at-risk --within 30d --limit 10 --json --select customer_email,mrr,card_exp

主动向这些客户发送邮件，避免非自愿流失。

Replay missed events since last cron tick

重放自上次定时任务以来遗漏的事件

bash

stripe-pp-cli events-since --type 'invoice' --json --select id,type,created,data.object.id

Cursor-driven event tail — one-shot, agent-friendly, persists cursor between runs.

bash

stripe-pp-cli events-since --type 'invoice' --json --select id,type,created,data.object.id

基于游标的事件追踪——一次性执行，适配Agent，在运行之间保存游标。

Reconcile this week's payouts

对账本周的付款

bash

stripe-pp-cli payout-reconcile --since 7d --csv

Joins payout → balance_transactions → charges → customers; flags missing rows.

bash

stripe-pp-cli payout-reconcile --since 7d --csv

关联付款→余额交易→收费→客户数据；标记缺失行。

Compact customer dossier for agent context

用于Agent上下文的精简客户档案

bash

stripe-pp-cli customer-360 alice@example.com --json --select customer.email,active_subscriptions,open_disputes,lifetime_spend

Use --select to project deeply-nested fields; saves tokens vs full dossier.

bash

stripe-pp-cli customer-360 alice@example.com --json --select customer.email,active_subscriptions,open_disputes,lifetime_spend

使用--select选择深层嵌套字段；与完整档案相比，节省令牌使用。

Auth Setup

认证设置

Authenticate by exporting

STRIPE_SECRET_KEY=sk_test_...

(recommended) or running

stripe-pp-cli auth set-token <key>

to persist it. Test-mode keys (

sk_test_...

) and live-mode keys (

sk_live_...

) are accepted; this v1 does NOT yet enforce a live-mode write guard, so audit any live invocation before running mutating commands.

Run

stripe-pp-cli doctor

to verify setup.

通过导出环境变量

STRIPE_SECRET_KEY=sk_test_...

（推荐）或运行

stripe-pp-cli auth set-token <key>

来持久化密钥进行认证。接受测试环境密钥（

sk_test_...

）和生产环境密钥（

sk_live_...

）；当前v1版本尚未实现生产环境写入保护，因此在执行变更命令前请审核所有生产环境调用。

运行

stripe-pp-cli doctor

验证设置。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
stripe-pp-cli account --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag
Explicit retries — use
```
--idempotent
```
only when an already-existing create should count as success, and
```
--ignore-missing
```
only when a missing delete target should count as success

在任何命令后添加

--agent

参数。等效于：

--json --compact --no-input --no-color --yes

。

可管道化 — 标准输出为JSON，错误输出到标准错误
可过滤 —
```
--select
```
保留字段子集。点路径可深入嵌套结构；数组可遍历元素。对于冗长的API，这是保持上下文精简的关键：
bash
```
stripe-pp-cli account --agent --select id,name,status
```
可预览 —
```
--dry-run
```
显示请求但不发送
离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
非交互式 — 从不提示，所有输入均为标志参数
显式重试 — 仅当已存在的创建操作应视为成功时使用
```
--idempotent
```
，仅当缺失的删除目标应视为成功时使用
```
--ignore-missing
```

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令会将输出包装在来源信封中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

获取数据，

.meta.source

表示数据来自生产环境还是本地存储。仅当标准输出为终端时，才会在标准错误中打印人类可读的

N results (live)

摘要——管道/Agent消费者仅在标准输出获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

stripe-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
stripe-pp-cli feedback --stdin < notes.txt
stripe-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.stripe-pp-cli/feedback.jsonl

. They are never POSTed unless

STRIPE_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

STRIPE_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当您（或Agent）发现此CLI存在问题时，记录反馈：

stripe-pp-cli feedback "--since标志是包含性的，但文档说是排他性的"
stripe-pp-cli feedback --stdin < notes.txt
stripe-pp-cli feedback list --json --limit 10

反馈条目存储在本地

~/.stripe-pp-cli/feedback.jsonl

文件中。仅当设置了

STRIPE_FEEDBACK_ENDPOINT

且传递了

--send

参数或设置了

STRIPE_FEEDBACK_AUTO_SEND=true

时，才会POST反馈。默认行为仅存储在本地。

写下让您感到意外的内容，而非错误报告。简短、具体、单行：这是能带来改进的部分。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

每个命令都接受

--deliver <sink>

参数。输出将发送到指定的接收器，同时（或替代）发送到标准输出，因此Agent无需手动管道即可路由命令结果。支持三种接收器：

接收器	效果
`stdout`	默认；仅写入标准输出
`file:<path>`	原子性地将输出写入 `<path>` （临时文件+重命名）
`webhook:<url>`	将输出体POST到指定URL（当使用 `--compact` 时为 `application/json` 或 `application/x-ndjson` ）

未知格式将被拒绝，并返回结构化错误，列出支持的格式。Webhook失败将返回非零退出码，并在标准错误中记录URL和HTTP状态。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

stripe-pp-cli profile save briefing --json
stripe-pp-cli --profile briefing account
stripe-pp-cli profile list --json
stripe-pp-cli profile show briefing
stripe-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是保存的一组标志值，可在多次调用中复用。当定时Agent每次运行都使用相同配置调用同一命令时使用——HeyGen的"Beacon"模式。

stripe-pp-cli profile save briefing --json
stripe-pp-cli --profile briefing account
stripe-pp-cli profile list --json
stripe-pp-cli profile show briefing
stripe-pp-cli profile delete briefing --yes

显式标志始终优先于配置文件值；配置文件值优先于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，以便内省Agent在运行时发现它们。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

代码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
4	需要认证
5	API错误（上游问题）
7	速率限制（等待并重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
stripe-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
stripe-pp-cli --help
```
输出
以
install
开头 → 以
```
mcp
```
结尾 → MCP安装；否则 → 请参阅上方前提条件
其他内容 → 直接使用（以
```
--agent
```
标志执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP server:

bash

go install github.com/mvanhorn/printing-press-library/library/payments/stripe/cmd/stripe-pp-mcp@latest

bash

claude mcp add stripe-pp-mcp -- stripe-pp-mcp

Verify:
```
claude mcp list
```

安装MCP服务器：

bash

go install github.com/mvanhorn/printing-press-library/library/payments/stripe/cmd/stripe-pp-mcp@latest

注册到Claude Code：

bash

claude mcp add stripe-pp-mcp -- stripe-pp-mcp

验证：
```
claude mcp list
```

Direct Use

直接使用

Check if installed:
```
which stripe-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

stripe-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
stripe-pp-cli <command> --help
```
.

检查是否已安装：
```
which stripe-pp-cli
```
如果未找到，提供安装选项（请参阅本技能顶部的前提条件）。
将用户查询与上方独特功能和命令参考中的最佳命令匹配。

使用

--agent

标志执行：

bash

stripe-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
stripe-pp-cli <command> --help
```
。