Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in

Add PayPay settings to the Account object

What’s new

We added two new fields to the Account object to store additional information required for onboarding connected accounts to PayPay:

  • settings.paypay_payments.goods_type
  • business_profile.specified_commercial_transactions_act_url

Impact

Connect platforms can now onboard connected accounts to PayPay by using the Accounts API. PayPay requires additional information about the connected account to process onboarding requests. If you update any of these new fields, PayPay automatically attempts onboarding for the applicable connected account.

Changes

ParametersChangeResources or endpoints
specified_commercial_transactions_act_urlAdded
Account#create.business_profileAccount#update.business_profileAccount.business_profile
paypay_paymentsAdded
Account#create.settingsAccount#update.settings

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: 2025-08-27.basil
  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

Was this page helpful?
YesNo