Overview of the Mandate Connection Update
Starting with API version 2025-10, Shopify has introduced a powerful new feature to streamline payment method management. Apps with the read_customer_payment_methods scope can now access the mandate connection on the CustomerPaymentMethod object.
What Does the Mandate Connection Do?
The mandate connection provides valuable details about what each payment method is authorized for. This includes:
- Orders: Payment methods can indicate authorization for order transactions.
- Subscriptions: Recurring payments for subscription-based services.
- Checkout: One-time payments associated with online checkouts.
It achieves this through the resourceType field and, when applicable, the resourceId, which provide context and specificity for each payment method's permissions.
Better Insight for Developers
This feature enhances visibility into payment method capabilities, allowing developers to build more robust and informed integrations. Whether managing recurring subscriptions or one-time purchases, this connection simplifies the process by providing actionable data.
How to Get Started
To leverage this feature:
- Ensure your app has the
read_customer_payment_methodsscope enabled. - Query the
CustomerPaymentMethodobject for mandate connection details. - Use the
resourceTypeandresourceIdfields to understand authorization specifics for each payment method.
For more details, refer to Shopify's official API documentation.
Update your app today to make the most of this exciting enhancement.