Stripe API

Hosts: api.stripe.com · 26 facts

Error meanings

• ✅ verified:server:sandbox · amount must convert to at least ## cents. $#.## converts to approximately €#.##. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · your card was declined. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · your card has expired. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · your card's security code is incorrect. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · your card has insufficient funds. use a different payment method to complete this purchase. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · your card was declined. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · no such customer: 'cus_apifactsnosuch' · GET /v1/customers/{id} · env sandbox
• ✅ verified:server:sandbox · this property cannot be expanded (data.agent_facts). · GET /v1/customers · env sandbox
• ✅ verified:server:sandbox · keys for idempotent requests can only be used for the same endpoint they were first used for ('/v#/payment_intents' vs '/v#/customers'). try using a key other than '<id>' if you meant to execute a different request." · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · keys for idempotent requests can only be used with the same parameters they were first used with. try using a key other than '<id>' if you meant to execute a different request. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · idempotent key length is ### characters long, which is outside accepted lengths. idempotent keys must be #-### characters long. if you're looking for a decent generator, try using a uuid defined by ietf rfc ####. · POST /v1/customers · env sandbox
• ✅ verified:server:sandbox · invalid stripe api version: ####-##-## · GET /v1/customers · env sandbox
• ✅ verified:server:sandbox · invalid integer: abc · GET /v1/customers · env sandbox
• ✅ verified:server:sandbox · received unknown parameter: agent_facts_unknown · POST /v1/customers · env sandbox

Rate limits

• 🔵 official · A rate-limited request returns HTTP 429 with a Stripe-Rate-Limited-Reason header (global-rate, endpoint-rate, global-concurrency, endpoint-concurrency or resource-specific); a 429 without it is not a rate limit, e.g. lock_timeout. · GET /v1/customers · env sandbox

Breaking changes

• ✅ verified:server:sandbox · the `payment_method_types` parameter is no longer supported. payment methods are now managed from your dashboard settings (<url>). for migration guidance, see <url> · POST /v1/payment_intents · env sandbox

Silent behavior

• ✅ verified:server:sandbox · Retrieving a deleted customer returns HTTP 200 with a stub object (id, object, deleted: true) instead of 404; fields such as email are absent. · GET /v1/customers/{id} · env sandbox
• ✅ verified:server:sandbox · amount must convert to at least ## cents. $#.## converts to approximately €#.##. · POST /v1/payment_intents · env sandbox
• 🔵 official · Idempotency keys may be removed once they are at least 24 hours old; a key reused after removal starts a new request instead of replaying the saved response. · POST /v1/payment_intents · env sandbox
• ✅ verified:server:sandbox · Repeating a POST with the same Idempotency-Key and the same body returns the saved first response with the header Idempotent-Replayed: true, which the first response does not carry. · POST /v1/customers · env sandbox
• ✅ verified:server:sandbox · A POST sent without an Idempotency-Key header is answered with an Idempotency-Key response header holding a UUID chosen by Stripe; a GET gets no such header. · POST /v1/customers · env sandbox
• ✅ verified:server:sandbox · received unknown parameter: agent_facts_unknown · POST /v1/customers · env sandbox

Auth quirks

• ✅ verified:server:sandbox · you did not provide an api key. you need to provide your api key in the authorization header, using bearer auth (e.g. 'authorization: <redacted>'). see <url> for details, or we can help at <url> · GET /v1/customers · env sandbox

Pagination

• ✅ verified:server:sandbox · GET /v1/customers?limit=0, outside the documented range 1-100, is not rejected: it returns a list holding one object, with has_more: true. · GET /v1/customers · env sandbox
• ✅ verified:server:sandbox · no such customer: 'cus_apifactsnosuch' · GET /v1/customers · env sandbox

Sandbox divergence

• 🔵 official · The global API rate limit per account is 25 requests per second in a sandbox against 100 in live mode; most individual endpoints are limited to 25 requests per second. · GET /v1/customers · env sandbox

Data: CC BY 4.0 · apifacts registry · This page is generated; edit the YAML, not the page.