All funding sources to appear in the API by September 16th

Previously, the funding sources endpoint only returned funding sources that were usable to pay for orders via the API. This led to questions from users like “Why doesn’t my credit card show up in the funding sources endpoint?”

We are changing the GET /funding_sources endpoint to show all funding sources, including ones that aren’t enabled for the API or had a return associated with them. This will allow customers to perform funding operations via API (changes to be announced soon).

What’s changing

All funding sources, including those which are not API-enabled (e.g. bank accounts, credit cards) will show in the GET /funding_sources endpoint.

The newly-added attributes status and usage_permissions indicate whether a funding source is active and can be used for API orders (see docs for details).

The funding sources will use the following sort order:

• Balance
• Invoice (if available)
• Active, API-enabled cards and bank accounts
• Active, non-API-enabled cards and bank accounts
• Inactive cards and bank accounts

When

This change will be effective:

• Immediately for most API clients (who either only have Balance or Invoice funding sources available for use via API, or who have not called GET /funding_sources in the last 60 days)
• In 2 months, on September 16th for everyone else

This may be a breaking change for the 2nd group if an integration selects funding sources automatically from the GET /funding_sources endpoint assuming they are all active, so we are notifying them of the change in behavior.

How to migrate

If you are in the second group (you’ll know, because you received an email) - you can just add a query parameter to immediately migrate.

• GET /funding_sources?show_all=true will return all funding sources.
• This will become the default behavior on September 16th

If you have any questions, please email us at [email protected]