Shopify’s buy‑now‑pay‑later (BNPL) solution, Shop Pay Installments, just got a major usability boost. If you run more than one legal entity in the United States, Canada, or the United Kingdom, you can now activate Installments on each eligible entity instead of being limited to the primary one. This change removes a long‑standing friction point for multi‑store owners and opens new integration possibilities for developers building on Shopify Payments.
What’s Changing?
Previously, Shop Pay Installments could only be turned on for the primary business entity associated with a Shopify Payments account. The new update expands the eligibility matrix so that every qualifying entity—whether it’s a separate storefront, a regional subsidiary, or a distinct legal brand—can enable the feature directly from its own payment settings. In practice, the backend logic now checks the Installments eligibility at the entity level rather than at the account level.
Who Is Affected?
How to Enable Shop Pay Installments Across Entities
If you prefer to automate the rollout, you can use the GraphQL Admin API (see the next section) to update each entity’s shopPayInstallmentsEnabled flag.
graphql
mutation enableInstallments($entityId: ID!) {
businessEntityUpdate(id: $entityId, input: {shopPayInstallmentsEnabled: true}) {
businessEntity {
id
name
shopPayInstallmentsEnabled
}
userErrors { field message }
}
}
Key Configuration Details for Developers
The GraphQL schema now includes the boolean field shopPayInstallmentsEnabled on the BusinessEntity type. When building apps that manage payment settings, query the field to determine the current state and issue the mutation shown above to toggle it. Remember to respect rate limits and include the X-Shopify-Access-Token header for authenticated requests.
graphql
query getEntities {
businessEntities(first: 20) {
edges {
node {
id
name
shopPayInstallmentsEnabled
}
}
}
}
Action Checklist
Conclusion
Enabling Shop Pay Installments on multiple business entities removes a historic bottleneck for merchants with complex brand architectures and gives developers a clearer, entity‑level API to work with. By following the steps above, you can roll out BNPL across all eligible storefronts, boost conversion, and keep your payment configuration in sync programmatically. Ready to activate? Head to your Payments settings today, or fire off the GraphQL mutation and watch the results roll in!
