Downpay store permissions

Downpay requires the Shopify API permissions listed on this page in order to provide core functionality.

Overview

Downpay uses Shopify’s native APIs to offer deposits and partial payments directly at checkout, store cards securely, and collect the remaining balance later. The permissions below fall into a few clear categories.

For legal policies, review our Legal page.

Storefront and checkout experience

Required to show deposit options and let customers check out normally

Scope	Why it’s required
unauthenticated_write_checkouts	Allows shoppers to select a deposit option and proceed to checkout from your storefront.
unauthenticated_write_customers	Creates a customer record during checkout when needed, just like Shopify’s native checkout does.
unauthenticated_read_product_listings	Reads product details so deposit options can appear on the correct products.
unauthenticated_read_product_tags	Supports tag-based rules (for example, only show deposits on tagged products).
unauthenticated_read_product_inventory	Checks availability so deposits respect inventory rules.
unauthenticated_read_selling_plans	Reads Shopify purchase option data used to represent deposit and payment structures.
read_locales	Ensures deposit messaging displays correctly across all enabled shop languages.
write_translations	Ensures deposit messaging displays correctly across all enabled shop languages.

Orders, payments, and balance collection

Required to manage deposits, save cards, and charge the remaining balance later and provide analytics.

Scope	Why it’s required
write_orders	Updates orders to reflect deposit payments and balance collection status.
read_all_orders	Shopify limits standard order access to the last 60 days. Because deposit and deferred payment orders often extend well beyond that window, this permission ensures we can reliably find, manage, and collect remaining balances on older partially paid orders.
write_customer_payment_methods	Securely associates the customer’s payment method so the remaining balance can be charged later.
read_payment_mandate	Confirms whether a valid authorization exists to charge a saved payment method.
write_payment_mandate	Creates or updates the authorization that allows future balance collection.
read_payment_terms	Reads existing payment terms (common in B2B) so deposits behave correctly.
write_payment_terms	Creates or updates payment terms when deposits or staged payments are used.
read_shopify_payments_accounts	Confirms Shopify Payments methods in order to provide better onboarding

Product and deposit configuration

Required to define which products support deposits and how they behave

Scope	Why it’s required
write_products	Associates deposit options with products and keeps product-level configuration in sync.
write_purchase_options	Creates and manages Shopify-native purchase options used for deposits and partial payments.
write_metaobject_definitions	Defines structured data models used to store deposit configuration in Shopify.
write_metaobjects	Stores and updates deposit rules, messaging, and configuration data.
unauthenticated_read_metaobjects	Reads storefront-visible configuration needed to display deposit options.
read_themes	Detects your active theme and confirms the deposit widget or app embed is installed correctly.

Operations, inventory, and reporting

Required to support merchant workflows and visibility

Scope	Why it’s required
read_fulfillments	Lets Downpay know when an order is ready so the remaining balance can be collected at the right time.
write_inventory	Reserves or releases inventory when deposits are placed on limited or made-to-order items.
read_reports	Powers reporting and insights around deposit usage, conversion, and revenue impact.
write_draft_orders	Supports sales-assisted or invoice-style flows where draft orders are used.
write_customers	Ensures customer records stay accurate when deposits and partial payments are involved.

Jump to top

Updated on: 11/03/2026

Was this article helpful?