Ir a contenido
Crea una cuenta o Inicia sesión
Logotipo de Stripe Docs
/
Pregúntale a la IA
Crear una cuentaIniciar sesión
Empieza ahora
Pagos
Ingresos
Plataformas y marketplaces
Gestión del dinero
Recursos para desarrolladores
API y SDKAyuda
Resumen
Control de versiones
Registro de cambios
    Resumen
    Clover
    Basil
    Acacia
    Versiones anteriores
Actualiza tu versión de API
Actualiza la versión de SDK
Essentials
SDK
API
Pruebas
CLI de Stripe
Proyectos de muestra
Herramientas
Dashboard de Stripe
Workbench
Dashboard para desarrolladores
Stripe para Visual Studio Code
Terraform
Funcionalidades
Flujos de trabajo
Destinos de eventos
Alertas de estado de StripeCargas de archivos
Soluciones de IA
Kit de herramientas para agentes
Protocolo de contexto del modeloCrea flujos de trabajo de facturación para SaaS con IA de agente
Seguridad y privacidad
Seguridad
Araña web Stripebot
Amplía Stripe
Crear aplicaciones de Stripe
Usar aplicaciones de Stripe
Socios
Ecosistema de socios
Certificación de socio
Estados Unidos
Español (América Latina)
InicioRecursos para desarrolladoresChangelogClover2026-01-28.preview

Updates error codes for the Outbound Setup Intents APIBreaking changes

What’s new

Updates the error codes returned by the Outbound Setup Intents API to use more generic error types instead of credential-type-specific codes. This change replaces several existing error codes with standardized error types:

  • blocked_payout_method_bank_account, blocked_payout_method_card, and blocked_payout_method_crypto_wallet errors now return blocked_payout_method.
  • unsupported_payout_method_bank_account and unsupported_payout_method_card errors now return unsupported_payout_method.
  • invalid_payout_method_bank_account, invalid_payout_method_card, and invalid_payout_method_crypto_wallet errors now return invalid_payout_method.
  • limit_payout_method_bank_account, limit_payout_method_card, and limit_payout_method_crypto_wallet errors now return limit_payout_method.

This standardization improves the consistency of error handling across different Payout Method types and supports future extensibility when adding new credential types to Payout Methods.

Why is this a breaking change?

This is a breaking change because your integration can rely on the specific error code identifiers that this update replaces. If your code checks for type specific error codes like blocked_payout_method_bank_account, unsupported_payout_method_bank_account, invalid_payout_method_bank_account_, or limit_payout_method_bank_account, those checks no longer work and you must update them to handle the generic error types.

Impact

If your integration handles specific error codes from Outbound Setup Intents endpoints, you need to update your error handling logic to use the generic error types. The error messages and underlying reasons remain the same, but the error code identifiers have changed to be more consistent across different Payout Method types.

Changes

CódigosCambiar
blocked_payout_methodunsupported_payout_methodAgregado
blocked_by_stripe
invalid_payout_method_dataAgregado
invalid_payout_method
limit_payout_methodAgregado
quota_exceeded

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-01-28.preview
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Adds alternative reference field to bank account and payout method resources
  • Adds fingerprint property to card payout methods
  • Global Payouts adds support for 15 new countries for cross-border payouts
¿Te fue útil esta página?
SíNo
  • ¿Necesitas ayuda? Ponte en contacto con soporte.
  • Echa un vistazo a nuestro registro de cambios.
  • ¿Tienes alguna pregunta? Contacto.
  • ¿LLM? Lee llms.txt.
  • Con tecnología de Markdoc