编辑 VerificationSession，以从 Stripe 删除所有已收集的信息。此操作会编辑 VerificationSession 及其所有关联对象，包括 VerificationReport、Event 和请求日志等。

\n\n

VerificationSession 处于 requires_input 或 verified 状态时可以编辑；编辑处于 requires_action 状态的会话会自动取消该会话。

\n\n

编辑过程最长可能需要四天。处理期间，VerificationSession 的 redaction.status 为 processing；完成后将变为 redacted，并发出 identity.verification_session.redacted 事件。

\n\n

编辑操作不可逆。编辑后的对象仍可通过 Stripe API 访问，但包含个人数据的字段会替换为 [redacted] 或类似占位符，metadata 字段也会被清除。编辑后的对象不能再更新或用于任何用途。

\n\n

了解更多。

","

Redact a VerificationSession to remove all collected information from Stripe. This will redact\nthe VerificationSession and all objects related to it, including VerificationReports, Events,\nrequest logs, etc.

\n\n

A VerificationSession object can be redacted when it is in requires_input or verified\nstatus. Redacting a VerificationSession in requires_action\nstate will automatically cancel it.

\n\n

The redaction process may take up to four days. When the redaction process is in progress, the\nVerificationSession’s redaction.status field will be set to processing; when the process is\nfinished, it will change to redacted and an identity.verification_session.redacted event\nwill be emitted.

\n\n

Redaction is irreversible. Redacted objects are still accessible in the Stripe API, but all the\nfields that contain personal data will be replaced by the string [redacted] or a similar\nplaceholder. The metadata field will also be erased. Redacted objects cannot be updated or\nused for any purpose.

\n\n

Learn more.

","编辑验证会话","Redact a VerificationSession","post-identity-verification-sessions-session-cancel","postIdentityVerificationSessionsSessionCancel","/v1/identity/verification_sessions/{session}/cancel",{"_30":1846,"_10":1847},{"_30":1844,"_10":1845},[1839,1840],{"_1773":1837,"_1775":22,"_25":1838},[1829,1830],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[1825,1826],[1815],{"_302":1728,"_304":120,"_305":1814},{},{"_303":1700,"_17":1816,"_1732":1817,"_1734":1735,"_125":114,"_1736":1737,"_1738":1818},{"_30":1755,"_10":1755},{"_1703":1821,"_1749":1822,"_1751":1823,"_1753":1824},[1819],{"_1741":1703,"_15":1742,"_1743":1820},{"_1745":1746,"_1697":1747},{},{},{},{},{"_1758":1762,"_1760":1828},{"_1758":1759,"_1760":1827},[],[],{"_19":1834,"_1773":1835,"_1775":22,"_1776":280,"_25":1836,"_306":1735},{"_19":1831,"_1773":1832,"_1775":22,"_1776":236,"_25":1833,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[307,309,302,303,295,296,304,305,22,297,298,299,321,323,300,306,21,328,330,301],[1708],[1788],{"_15":1742,"_1741":1703,"_23":45,"_21":46,"_42":43},{"_15":1753,"_1741":1753,"_21":22,"_1791":1841},{"_1788":1842},[1843],{},"

当 VerificationSession 处于 requires_input 状态时，可以取消。

\n\n

取消后将禁止未来的提交尝试，且无法撤销。了解更多。

","

A VerificationSession object can be canceled when it is in requires_input status.

\n\n

Once canceled, future submission attempts are disabled. This cannot be undone. Learn more.

","取消验证会话","Cancel a VerificationSession","post-identity-verification-sessions-session","postIdentityVerificationSessionsSession","/v1/identity/verification_sessions/{session}",{"_30":1898,"_10":1899},{"_30":1896,"_10":1897},[1888,1889],{"_1773":1886,"_1775":22,"_25":1887},[1878,1879],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[1874,1875],[1864],{"_302":1728,"_304":120,"_305":1863},{},{"_303":1700,"_17":1865,"_1732":1866,"_1734":1735,"_125":114,"_1736":1737,"_1738":1867},{"_30":1755,"_10":1755},{"_1703":1870,"_1749":1871,"_1751":1872,"_1753":1873},[1868],{"_1741":1703,"_15":1742,"_1743":1869},{"_1745":1746,"_1697":1747},{},{},{},{"_21":342},{"_1758":1762,"_1760":1877},{"_1758":1759,"_1760":1876},[],[],{"_19":1883,"_1773":1884,"_1775":22,"_1776":280,"_25":1885,"_306":1735},{"_19":1880,"_1773":1881,"_1775":22,"_1776":236,"_25":1882,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[307,309,302,303,295,296,304,305,22,297,298,299,321,323,300,306,21,328,330,301],[1708],[1788,305,297,298,21],{"_15":1742,"_1741":1703,"_23":45,"_21":46,"_42":43},{"_15":1753,"_1741":1753,"_21":22,"_1791":1890},{"_1788":1891,"_305":1892,"_297":1893,"_298":1894,"_21":342},[1895],{},{},{},{},"

更新 VerificationSession 对象。

\n\n

当会话状态为 requires_input 时，可通过此接口更新验证检查和选项。

","

Updates a VerificationSession object.

\n\n

When the session status is requires_input, you can use this method to update the\nverification check and options.

","更新验证会话","Update a VerificationSession","get-identity-verification-sessions-session","getIdentityVerificationSessionsSession","GET",{"_30":1943,"_10":1944},{"_30":1941,"_10":1942},[1936,1937],[1928,1929],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[1924,1925],[1915],{"_302":1728,"_304":120,"_305":1914},{},{"_303":1700,"_17":1916,"_1732":1917,"_1734":1735,"_125":114,"_1736":1737,"_1738":1918},{"_30":1755,"_10":1755},{"_1703":1921,"_1749":1922,"_1751":1923},[1919],{"_1741":1703,"_15":1742,"_1743":1920},{"_1745":1746,"_1697":1747},{},{},{},{"_1758":1762,"_1760":1927},{"_1758":1759,"_1760":1926},[],[],{"_19":1933,"_1773":1934,"_1775":22,"_1776":280,"_25":1935,"_306":1735},{"_19":1930,"_1773":1931,"_1775":22,"_1776":236,"_25":1932,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[307,309,302,303,295,296,304,305,22,297,298,299,321,323,300,306,21,328,330,301],{"_15":1788,"_1741":1749,"_21":741,"_19":1938},{"_15":1742,"_1741":1703,"_23":45,"_21":46,"_42":43},{"_30":1939,"_10":1940},"指定需要在响应中展开的字段。","Specifies which fields in the response should be expanded.","

获取此前创建的 VerificationSession 详情。

\n\n

当会话状态为 requires_input 时，可通过此接口获取有效的 client_secret 或 url，以允许用户重新提交。

","

Retrieves the details of a VerificationSession that was previously created.

\n\n

When the session status is requires_input, you can use this method to retrieve a valid\nclient_secret or url to allow re-submission.

","获取验证会话","Retrieve a VerificationSession","post-identity-verification-sessions","/v1/identity/verification_sessions",{"_30":1994,"_10":1995},{"_30":1992,"_10":1993},[1984],{"_1773":1981,"_1775":22,"_25":1982},[1973,1974],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[1969,1970],[1960],{"_302":1728,"_304":120,"_305":1959},{},{"_303":1700,"_17":1961,"_1732":1962,"_1734":1735,"_125":114,"_1736":1963,"_1738":1964},{"_30":1755,"_10":1755},{"_1703":1965,"_1749":1966,"_1751":1967,"_1753":1968},"ready",[],{},{},{},{"_21":342},{"_1758":1762,"_1760":1972},{"_1758":1759,"_1760":1971},[],[],{"_19":1978,"_1773":1979,"_1775":22,"_1776":280,"_25":1980,"_306":1735},{"_19":1975,"_1773":1976,"_1775":22,"_1776":236,"_25":1977,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[307,309,302,303,295,296,304,305,22,297,298,299,321,323,300,306,21,328,330,301],[1708],[307,1788,305,297,298,321,323,300,1983,21,330],"return_url",{"_15":1753,"_1741":1753,"_21":22,"_1791":1985},{"_1788":1986,"_305":1987,"_297":1988,"_298":1989,"_300":1990},[1991],{},{},{},{},{},"

创建 VerificationSession 对象。

\n\n

创建 VerificationSession 后，请使用会话的 client_secret 显示验证弹窗，或将用户跳转到会话的 url。

\n\n

如果 API Key 处于测试模式，验证检查不会真正处理，但其他流程会按实时模式执行。

\n\n

相关指南：验证用户的身份证件

","

Creates a VerificationSession object.

\n\n

After the VerificationSession is created, display a verification modal using the session client_secret or send your users to the session’s url.

\n\n

If your API key is in test mode, verification checks won’t actually process, though everything else will occur as if in live mode.

\n\n

","创建验证会话","Create a VerificationSession","get-identity-verification-sessions","getIdentityVerificationSessions",{"_30":2069,"_10":2070},{"_30":2067,"_10":2068},[2036,2037,2038,2039,2040,2041,2042,2043,2044],[2028,2029],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[2024,2025],[2015],{"_2009":2010,"_2011":120,"_22":2012},"data",[2013],"has_more","list",{"_302":1728,"_304":120,"_305":2014},{},{"_303":1700,"_17":2016,"_1732":2017,"_1734":1735,"_125":114,"_1736":1963,"_1738":2018},{"_30":1755,"_10":1755},{"_1703":2019,"_1749":2020,"_1751":2021},[],{},{"_2022":2023},{},"limit",10,{"_1758":1762,"_1760":2027},{"_1758":1759,"_1760":2026},[],[],{"_19":2033,"_1773":2034,"_1775":22,"_25":2035,"_306":1735},{"_19":2030,"_1773":2031,"_1775":22,"_1776":236,"_25":2032,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[2009,2011,22,328],{"_15":307,"_1741":1749,"_21":46,"_42":43,"_19":2066},{"_15":302,"_1741":1749,"_21":46,"_19":2063},{"_15":2059,"_1741":1749,"_21":46,"_42":43,"_19":2060},{"_15":1788,"_1741":1749,"_21":741,"_19":2058},{"_15":2022,"_1741":1749,"_21":390,"_19":2055},{"_15":321,"_1741":1749,"_21":46,"_42":43,"_19":2054},{"_15":323,"_1741":1749,"_21":46,"_42":43,"_19":2053},{"_15":2049,"_1741":1749,"_21":46,"_42":43,"_19":2050},{"_15":306,"_1741":1749,"_21":46,"_48":2045,"_19":2046},[346,347,348,349],{"_30":2047,"_10":2048},"仅返回具有此状态的 VerificationSession。[了解会话生命周期](https://docs.stripe.com/identity/how-sessions-work)。","Only return VerificationSessions with this status. [Learn more about the lifecycle of sessions](https://docs.stripe.com/identity/how-sessions-work).","starting_after",{"_30":2051,"_10":2052},"分页游标。`starting_after` 是用于确定列表位置的对象 ID。例如，列表请求返回 100 个对象且最后一个为 `obj_foo` 时，后续请求可传入 `starting_after=obj_foo` 获取下一页。","A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.",{"_30":351,"_10":426},{"_30":352,"_10":427},{"_30":2056,"_10":2057},"限制返回对象的数量。取值范围为 1 到 100，默认值为 10。","A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.",{"_30":1939,"_10":1940},"ending_before",{"_30":2061,"_10":2062},"分页游标。`ending_before` 是用于确定列表位置的对象 ID。例如，列表请求返回 100 个对象且第一个为 `obj_bar` 时，后续请求可传入 `ending_before=obj_bar` 获取上一页。","A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.",{"_30":2064,"_10":2065},"仅返回在指定日期区间内创建的 VerificationSession。","Only return VerificationSessions that were created during the given date interval.",{"_30":392,"_10":455},"

返回 VerificationSession 列表。

","

Returns a list of VerificationSessions

","列出验证会话","List VerificationSessions","get-identity-verification-reports-report","getIdentityVerificationReportsReport","/v1/identity/verification_reports/{report}",{"_30":2118,"_10":2119},{"_30":2116,"_10":2117},[2113,2114],[2105,2106],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[2101,2102],[2090],{"_302":1728,"_342":2085,"_510":2086,"_343":2087,"_304":120,"_22":509},{"_1565":2088},{"_306":1347},{"_1121":1144,"_306":1347},[2089],{},{"_303":1700,"_17":2091,"_1732":2092,"_1734":1735,"_125":114,"_1736":1737,"_1738":2093},{"_30":1755,"_10":1755},{"_1703":2098,"_1749":2099,"_1751":2100},[2094],{"_1741":1703,"_15":2095,"_1743":2096},"report",{"_1745":1746,"_1697":2097},"getIdentityVerificationReports",{},{},{},{"_1758":1762,"_1760":2104},{"_1758":1759,"_1760":2103},[],[],{"_19":2110,"_1773":2111,"_1775":22,"_1776":496,"_25":2112,"_306":1735},{"_19":2107,"_1773":2108,"_1775":22,"_1776":236,"_25":2109,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[307,302,342,510,303,343,304,22,297,511,512,21,330,526],{"_15":1788,"_1741":1749,"_21":741,"_19":2115},{"_15":2095,"_1741":1703,"_23":45,"_21":46,"_42":43},{"_30":1939,"_10":1940},"

获取已有的 VerificationReport。

","

Retrieves an existing VerificationReport

","获取验证报告","Retrieve a VerificationReport","get-identity-verification-reports","/v1/identity/verification_reports",{"_30":2184,"_10":2185},{"_30":2182,"_10":2183},[2159,2160,2161,2162,2163,2164,2165,2166],[2151,2152],[83],{},{"_30":1768,"_10":1769},[1764,1765,1766,1767],[2147,2148],[2140],{"_2009":2133,"_2011":120,"_22":2012},[2134],{"_302":1728,"_342":2135,"_510":2136,"_343":2137,"_304":120,"_22":509},{"_1565":2138},{"_306":1347},{"_1121":1144,"_306":1347},[2139],{},{"_303":1700,"_17":2141,"_1732":2142,"_1734":1735,"_125":114,"_1736":1963,"_1738":2143},{"_30":1755,"_10":1755},{"_1703":2144,"_1749":2145,"_1751":2146},[],{},{"_2022":2023},{},{"_1758":1762,"_1760":2150},{"_1758":1759,"_1760":2149},[],[],{"_19":2156,"_1773":2157,"_1775":22,"_25":2158,"_306":1735},{"_19":2153,"_1773":2154,"_1775":22,"_1776":236,"_25":2155,"_306":1700},{"_30":1779,"_10":1780},[1778],[247],{"_30":1784,"_10":1785},[1778],[2009,2011,22,328],{"_15":307,"_1741":1749,"_21":46,"_42":43,"_19":2181},{"_15":302,"_1741":1749,"_21":46,"_19":2178},{"_15":2059,"_1741":1749,"_21":46,"_42":43,"_19":2177},{"_15":1788,"_1741":1749,"_21":741,"_19":2176},{"_15":2022,"_1741":1749,"_21":390,"_19":2175},{"_15":2049,"_1741":1749,"_21":46,"_42":43,"_19":2174},{"_15":21,"_1741":1749,"_21":46,"_48":2170,"_19":2171},{"_15":526,"_1741":1749,"_21":46,"_42":43,"_19":2167},{"_30":2168,"_10":2169},"仅返回由此 VerificationSession ID 创建的 VerificationReport；也允许提供 VerificationIntent ID。","Only return VerificationReports created by this VerificationSession ID. It is allowed to provide a VerificationIntent ID.",[342,343],{"_30":2172,"_10":2173},"仅返回此类型的 VerificationReport。","Only return VerificationReports of this type",{"_30":2051,"_10":2052},{"_30":2056,"_10":2057},{"_30":1939,"_10":1940},{"_30":2061,"_10":2062},{"_30":2179,"_10":2180},"仅返回在指定日期区间内创建的 VerificationReport。","Only return VerificationReports that were created during the given date interval.",{"_30":392,"_10":455},"

列出所有验证报告。

","

List all verification reports.

","列出验证报告","List VerificationReports","freemium",{"_30":2197,"_10":2198},"officialUrl","https://stripe.com/identity","freeTier",{"_30":2195,"_10":2196},"billingUnit",{"_30":2194,"_10":2194},"verification","首次 50 次验证免费。","The first 50 verifications are free.","Stripe 官方页面当前公布按量计费：身份文件与自拍验证每次 1.50 美元，身份号码查询每次 0.50 美元；前 50 次验证免费，大批量或特殊业务可联系定制定价。实际价格和可用地区以 Stripe 账户与官方页面为准。","Stripe's official page currently lists usage pricing of US$1.50 per ID document and selfie verification and US$0.50 per ID number lookup. The first 50 verifications are free, with custom pricing available for volume or unique business models. Actual pricing and regional availability remain subject to the Stripe account and official page.",{"_303":1759,"_21":2200,"_2201":2202,"_19":2203},"bearer","envVar","STRIPE_SECRET_KEY",{"_30":2204,"_10":2205},"Stripe Secret Key 通过 Bearer Header 提供，仅保留在调用者本地环境中；不要在浏览器、日志或示例中持久化。","Stripe Secret Key supplied through a Bearer header and retained only in the caller's local environment. Never persist it in a browser, log, or example.",{"_303":83,"_328":2207,"_19":2208},"https://api.stripe.com",{"_30":2209,"_10":2210},"Stripe 官方 API 入口","Official Stripe API endpoint","operationSlug","requestExampleId","基于 Stripe 官方 OpenAPI 固定 revision 的完整 Identity 子产品契约。该 API 涉及身份证件、自拍、身份号码和一次性客户端密钥等高敏感数据；Hub 不代理、缓存、记录或保存请求与响应，调用者须核验地区、用途、用户同意和数据保留要求。","Complete Identity subproduct contract pinned to an immutable revision of Stripe's official OpenAPI repository. This API handles highly sensitive data including identity documents, selfies, identity numbers, and single-use client secrets. The Hub does not proxy, cache, log, or store requests or responses; callers must confirm regional availability, supported use cases, user consent, and retention requirements.","https://github.com/pontjs/stripe-identity/actions/runs/31858572852","typescript","import { createStripeIdentityClient } from \"@pontx/stripe-identity\";\n\nconst client = createStripeIdentityClient({\n secretKey: process.env.STRIPE_SECRET_KEY!\n});\nconst sessions = await client.getIdentityVerificationSessions({ limit: 10 });","cli","pnpm add --global @pontx/stripe-identity\n\npontx-stripe-identity call getIdentityVerificationSessions --limit 10 --dry-run","client",{"_1745":2225,"_2225":2226,"_2227":2220,"_297":2228},"controllers",{"_1700":-5},[2097,2072,1997,1747,1901,1849,1800,1698],"factory","createStripeIdentityClient","identifier",{"_2229":2202},"secretKey","testedVersion","unitTests",{"_2234":2246,"_2247":2246,"_2248":1728},"e2eStatus","passed","nodeVersions",[2243,2244,2245],"sourceCommit","2319bec517bb35b8d3512d1495f784193f178080","testedAt","repositoryUrl","https://github.com/pontjs/stripe-identity","workflowRunUrl","18","20","22",5,"total","skipped","创建、查询、更新、取消和编辑 Stripe Identity 验证会话，并查询验证报告；覆盖官方 Identity 路径下全部 8 个 Endpoint，Hub 仅提供文档与本地 SDK/CLI。","Create, retrieve, update, cancel, and redact Stripe Identity verification sessions, and retrieve verification reports. The collection covers all 8 Endpoints under the official Identity path boundary; the Hub provides documentation and a local SDK/CLI only.","Stripe Identity 身份验证 API","Stripe Identity verification API","accountsEnabled","siteVerification",{"_2258":-7,"_2259":2260,"_2261":-7},"googleAnalyticsId","G-F9JFHB8W58","google","bing","23CCA318A0686AEA0A0015E46FC1A641","baidu"]