Skip to content

BILL-5582: Add descriptor_code support to bank account verification#192

Merged
kevinpjones merged 2 commits into
mainfrom
BILL-5582-php-descriptor-code-verification
Jun 5, 2026
Merged

BILL-5582: Add descriptor_code support to bank account verification#192
kevinpjones merged 2 commits into
mainfrom
BILL-5582-php-descriptor-code-verification

Conversation

@kevinpjones

Copy link
Copy Markdown
Contributor

Description

Problem: Stripe's Setup Intents API added a descriptor code-based microdeposit verification path alongside the legacy two-amount path. When a bank account is created via Setup Intents, Stripe sends a single $0.01 deposit whose statement descriptor contains a 6-character code beginning with SM. The PHP SDK had no support for this path, so customers whose accounts were assigned microdeposit_type: descriptor_code could not complete verification through the SDK.

Solution: Added descriptor_code as an alternative to amounts on BankAccountVerify, updated validation so exactly one of the two fields is required (not both, not neither), and added microdeposit_type to the BankAccount response model so callers can read which verification path applies to a given account before calling verify.

Non-breaking: All existing code using amounts continues to work without any changes.

Story

N/A

Related PR's

N/A

Verify

  • Code runs without errors
  • Tests pass with >=85% line coverage

Stripe updated microdeposit verification from two amounts to a single
6-character descriptor code. This adds support for the new path while
keeping the existing amounts path fully backwards compatible.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@kevinpjones kevinpjones merged commit effd184 into main Jun 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants