Skip to main content
TroopyDocs
GuidesSet up and use TroopyAppsConnect your servicesAPIThe API, the CLI and MCPChangelogEach update to Troopy

Developers

Account

Troop

Skills

Tasks and projects

Needs you

Routines and triggers

Brain

Docs

Canvas

Email

CRM

Outreach

Customers

Analytics

Sessions

Surveys

Support Agent

Tests and incidents

Disputes

Apps

Vault

Computer

Open Troopy
Troopy

API reference / Apps

List failed Stripe payments

Card payments that failed in the workspace's Stripe since a date (the last 7 days by default), newest first, with why they failed. Read only. Needs Stripe connected.

get/api/v1/apps/stripe/failed-payments

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.
Scopesapps:read

Other ways to call it

CLItroopy stripe failed-payments
MCP tooltroopy_stripe_failed_payments
Rate limit60 calls in 60 seconds, for each key

Query parameters

sincestring

On or after this date; 7 days ago when left out

date

limitinteger

At most 50; ask for 10 or fewer to read them all at once

Default 10 · At least 1 · At most 50

cursorstring

The next value from the previous page

At most 200 characters

Response

200 · application/json
data*array<object>
9 properties
id*string
customer*string | null
email*string | null
amount*number

In the currency's main unit: dollars, not cents

currency*string

ISO code, like usd

failureCode*string | null
failureMessage*string | null
invoice*string | null
created*string

ISO 8601 date and time

hasMore*boolean
next*string | null

Pass as cursor for the next page; null on the last

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.