stripe 20.4.0 → 20.4.1

package/CHANGELOG.md

@@ -1,4 +1,8 @@
 # Changelog
+## 20.4.1 - 2026-03-06
+* [#2590](https://github.com/stripe/stripe-node/pull/2590) Add Stripe-Request-Trigger header
+* [#2588](https://github.com/stripe/stripe-node/pull/2588) Add agent information to UserAgent
+
 ## 20.4.0 - 2026-02-25
 This release changes the pinned API version to `2026-02-25.clover`.
 

package/VERSION

@@ -1 +1 @@
-20.4.0
+20.4.1

package/cjs/RequestSender.js

@@ -263,7 +263,15 @@ class RequestSender {
         const appInfo = this._stripe._appInfo
             ? this._stripe.getAppInfoAsString()
             : '';
-        return `Stripe/${apiMode} NodeBindings/${packageVersion} ${appInfo}`.trim();
+        const aiAgent = this._stripe.getConstant('AI_AGENT');
+        let uaString = `Stripe/${apiMode} NodeBindings/${packageVersion}`;
+        if (appInfo) {
+            uaString += ` ${appInfo}`;
+        }
+        if (aiAgent) {
+            uaString += ` AIAgent/${aiAgent}`;
+        }
+        return uaString;
     }
     _getTelemetryHeader() {
         if (this._stripe.getTelemetryEnabled() &&

package/cjs/resources/V2/Core/Events.js

@@ -51,6 +51,9 @@ exports.Events = StripeResource_js_1.StripeResource.extend({
             }).apply(this, [
                 {
                     stripeContext: pulledEvent.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${pulledEvent.id}`,
+                    },
                 },
             ]) });
     },

package/cjs/stripe.core.js

@@ -37,9 +37,13 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '20.4.0';
+    Stripe.PACKAGE_VERSION = '20.4.1';
     Stripe.API_VERSION = apiVersion_js_1.ApiVersion;
-    Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
+    const aiAgent = typeof process !== 'undefined' && process.env
+        ? (0, utils_js_1.detectAIAgent)(process.env)
+        : '';
+    Stripe.AI_AGENT = aiAgent;
+    Stripe.USER_AGENT = Object.assign(Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)()), (aiAgent ? { ai_agent: aiAgent } : {}));
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.StripeContext = StripeContext_js_1.StripeContext;
     Stripe.resources = resources;
@@ -368,6 +372,9 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
             eventNotification.fetchEvent = () => {
                 return this._requestSender._rawRequest('GET', `/v2/core/events/${eventNotification.id}`, undefined, {
                     stripeContext: eventNotification.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${eventNotification.id}`,
+                    },
                 }, ['fetch_event']);
             };
             eventNotification.fetchRelatedObject = () => {
@@ -376,6 +383,9 @@ function createStripe(platformFunctions, requestSender = defaultRequestSenderFac
                 }
                 return this._requestSender._rawRequest('GET', eventNotification.related_object.url, undefined, {
                     stripeContext: eventNotification.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${eventNotification.id}`,
+                    },
                 }, ['fetch_related_object']);
             };
             return eventNotification;

package/cjs/utils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseHeadersForFetch = exports.parseHttpHeaderAsNumber = exports.parseHttpHeaderAsString = exports.getAPIMode = exports.jsonStringifyRequestData = exports.concat = exports.createApiKeyAuthenticator = exports.determineProcessUserAgentProperties = exports.validateInteger = exports.flattenAndStringify = exports.isObject = exports.emitWarning = exports.pascalToCamelCase = exports.callbackifyPromiseWithTimeout = exports.normalizeHeader = exports.normalizeHeaders = exports.removeNullish = exports.protoExtend = exports.getOptionsFromArgs = exports.getDataFromArgs = exports.extractUrlParams = exports.makeURLInterpolator = exports.queryStringifyRequestData = exports.isOptionsHash = void 0;
+exports.parseHeadersForFetch = exports.parseHttpHeaderAsNumber = exports.parseHttpHeaderAsString = exports.getAPIMode = exports.jsonStringifyRequestData = exports.concat = exports.createApiKeyAuthenticator = exports.detectAIAgent = exports.AI_AGENTS = exports.determineProcessUserAgentProperties = exports.validateInteger = exports.flattenAndStringify = exports.isObject = exports.emitWarning = exports.pascalToCamelCase = exports.callbackifyPromiseWithTimeout = exports.normalizeHeader = exports.normalizeHeaders = exports.removeNullish = exports.protoExtend = exports.getOptionsFromArgs = exports.getDataFromArgs = exports.extractUrlParams = exports.makeURLInterpolator = exports.queryStringifyRequestData = exports.isOptionsHash = void 0;
 const OPTIONS_KEYS = [
     'apiKey',
     'idempotencyKey',
@@ -11,6 +11,7 @@ const OPTIONS_KEYS = [
     'host',
     'authenticator',
     'stripeContext',
+    'headers',
     'additionalHeaders',
     'streaming',
 ];
@@ -216,8 +217,13 @@ function getOptionsFromArgs(args) {
                 }
                 opts.authenticator = params.authenticator;
             }
+            // these are sent by us from _rawRequest, which is what powers all generated requests
+            if (params.headers) {
+                Object.assign(opts.headers, params.headers);
+            }
+            // these are sent from the user-facing RawRequest
             if (params.additionalHeaders) {
-                opts.headers = params.additionalHeaders;
+                Object.assign(opts.headers, params.additionalHeaders);
             }
             if (params.streaming) {
                 opts.streaming = true;
@@ -380,6 +386,29 @@ function determineProcessUserAgentProperties() {
         };
 }
 exports.determineProcessUserAgentProperties = determineProcessUserAgentProperties;
+exports.AI_AGENTS = [
+    // The beginning of the section generated from our OpenAPI spec
+    ['ANTIGRAVITY_CLI_ALIAS', 'antigravity'],
+    ['CLAUDECODE', 'claude_code'],
+    ['CLINE_ACTIVE', 'cline'],
+    ['CODEX_SANDBOX', 'codex_cli'],
+    ['CODEX_THREAD_ID', 'codex_cli'],
+    ['CODEX_SANDBOX_NETWORK_DISABLED', 'codex_cli'],
+    ['CODEX_CI', 'codex_cli'],
+    ['CURSOR_AGENT', 'cursor'],
+    ['GEMINI_CLI', 'gemini_cli'],
+    ['OPENCODE', 'open_code'],
+    // The end of the section generated from our OpenAPI spec
+];
+function detectAIAgent(env) {
+    for (const [envVar, agentName] of exports.AI_AGENTS) {
+        if (env[envVar]) {
+            return agentName;
+        }
+    }
+    return '';
+}
+exports.detectAIAgent = detectAIAgent;
 function createApiKeyAuthenticator(apiKey) {
     const authenticator = (request) => {
         request.headers.Authorization = 'Bearer ' + apiKey;

package/esm/RequestSender.js

@@ -260,7 +260,15 @@ export class RequestSender {
         const appInfo = this._stripe._appInfo
             ? this._stripe.getAppInfoAsString()
             : '';
-        return `Stripe/${apiMode} NodeBindings/${packageVersion} ${appInfo}`.trim();
+        const aiAgent = this._stripe.getConstant('AI_AGENT');
+        let uaString = `Stripe/${apiMode} NodeBindings/${packageVersion}`;
+        if (appInfo) {
+            uaString += ` ${appInfo}`;
+        }
+        if (aiAgent) {
+            uaString += ` AIAgent/${aiAgent}`;
+        }
+        return uaString;
     }
     _getTelemetryHeader() {
         if (this._stripe.getTelemetryEnabled() &&

package/esm/resources/V2/Core/Events.js

@@ -48,6 +48,9 @@ export const Events = StripeResource.extend({
             }).apply(this, [
                 {
                     stripeContext: pulledEvent.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${pulledEvent.id}`,
+                    },
                 },
             ]) });
     },

package/esm/stripe.core.js

@@ -7,7 +7,7 @@ import { ApiVersion } from './apiVersion.js';
 import { CryptoProvider } from './crypto/CryptoProvider.js';
 import { HttpClient, HttpClientResponse } from './net/HttpClient.js';
 import * as resources from './resources.js';
-import { createApiKeyAuthenticator, determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
+import { createApiKeyAuthenticator, detectAIAgent, determineProcessUserAgentProperties, pascalToCamelCase, validateInteger, } from './utils.js';
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
@@ -34,9 +34,13 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '20.4.0';
+    Stripe.PACKAGE_VERSION = '20.4.1';
     Stripe.API_VERSION = ApiVersion;
-    Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
+    const aiAgent = typeof process !== 'undefined' && process.env
+        ? detectAIAgent(process.env)
+        : '';
+    Stripe.AI_AGENT = aiAgent;
+    Stripe.USER_AGENT = Object.assign(Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties()), (aiAgent ? { ai_agent: aiAgent } : {}));
     Stripe.StripeResource = StripeResource;
     Stripe.StripeContext = StripeContext;
     Stripe.resources = resources;
@@ -365,6 +369,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
             eventNotification.fetchEvent = () => {
                 return this._requestSender._rawRequest('GET', `/v2/core/events/${eventNotification.id}`, undefined, {
                     stripeContext: eventNotification.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${eventNotification.id}`,
+                    },
                 }, ['fetch_event']);
             };
             eventNotification.fetchRelatedObject = () => {
@@ -373,6 +380,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
                 }
                 return this._requestSender._rawRequest('GET', eventNotification.related_object.url, undefined, {
                     stripeContext: eventNotification.context,
+                    headers: {
+                        'Stripe-Request-Trigger': `event=${eventNotification.id}`,
+                    },
                 }, ['fetch_related_object']);
             };
             return eventNotification;

package/esm/utils.js

@@ -8,6 +8,7 @@ const OPTIONS_KEYS = [
     'host',
     'authenticator',
     'stripeContext',
+    'headers',
     'additionalHeaders',
     'streaming',
 ];
@@ -209,8 +210,13 @@ export function getOptionsFromArgs(args) {
                 }
                 opts.authenticator = params.authenticator;
             }
+            // these are sent by us from _rawRequest, which is what powers all generated requests
+            if (params.headers) {
+                Object.assign(opts.headers, params.headers);
+            }
+            // these are sent from the user-facing RawRequest
             if (params.additionalHeaders) {
-                opts.headers = params.additionalHeaders;
+                Object.assign(opts.headers, params.additionalHeaders);
             }
             if (params.streaming) {
                 opts.streaming = true;
@@ -361,6 +367,28 @@ export function determineProcessUserAgentProperties() {
             platform: process.platform,
         };
 }
+export const AI_AGENTS = [
+    // The beginning of the section generated from our OpenAPI spec
+    ['ANTIGRAVITY_CLI_ALIAS', 'antigravity'],
+    ['CLAUDECODE', 'claude_code'],
+    ['CLINE_ACTIVE', 'cline'],
+    ['CODEX_SANDBOX', 'codex_cli'],
+    ['CODEX_THREAD_ID', 'codex_cli'],
+    ['CODEX_SANDBOX_NETWORK_DISABLED', 'codex_cli'],
+    ['CODEX_CI', 'codex_cli'],
+    ['CURSOR_AGENT', 'cursor'],
+    ['GEMINI_CLI', 'gemini_cli'],
+    ['OPENCODE', 'open_code'],
+    // The end of the section generated from our OpenAPI spec
+];
+export function detectAIAgent(env) {
+    for (const [envVar, agentName] of AI_AGENTS) {
+        if (env[envVar]) {
+            return agentName;
+        }
+    }
+    return '';
+}
 export function createApiKeyAuthenticator(apiKey) {
     const authenticator = (request) => {
         request.headers.Authorization = 'Bearer ' + apiKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "20.4.0",
+  "version": "20.4.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",