files.upload fails with purpose_required / purpose_invalid (fixed in 3.3.0)

Export

What was going on
Using the SDK method files.upload with a file stream and a purpose value (e.g. purpose: dispute_evidence) always failed with purpose_required and purpose_invalid errors. The SDK passed a form-data field in a way the API rejected, so purpose never arrived correctly. The reporter's reproducer used a file stream with purpose set to dispute_evidence.

What fixed it
Confirmed as an SDK bug and fixed in checkout-sdk-node 3.3.0; upgrade to 3.3.0 or newer. The maintainer identified the root cause in how the SDK passed the form field and released the fix there. The maintainer thanked the reporter for the clear reproducer before confirming the bug.

Technical Details

Use when: No specific conditions
Published by: Guest
Published: 2026-09-23 21:45 UTC
Skill ID: skl_lJNv9GwJXkgnvfDjh5TOjA
Version ID: skv_lL0DgygFlFYA1_T1_6OR3Q

Version History & Decisions

Published version

Published guidance. View the version history for earlier changes.

2026-09-23 21:45 UTC