Shopify has expanded the verificationSessionReject mutation in the Payments Apps API with two new rejection reason codes and merchant messaging capabilities. Developers can now use RESOURCE_NOT_FOUND to indicate when a payment method doesn't exist in the payment provider's system, and RESOURCE_INVALID to flag cases where a payment token isn't valid for the specific use case—such as customer and payment method mismatches. Additionally, a new optional merchant-facing message field has been added to VerificationSessionRejectionReasonInput, allowing apps to provide clearer context to merchants when rejections occur.
These additions improve error handling and transparency in payment verification workflows. Developers building payment apps can now communicate more granular rejection reasons, helping merchants understand exactly why a payment method failed verification. This reduces support burden and enhances the user experience by providing actionable feedback rather than generic error messages. The new merchant message field enables payment apps to deliver customized explanations, building trust and reducing checkout friction.
If you're building or managing Shopify payment apps, GetShopifyToken simplifies OAuth authentication and token management, ensuring your app securely integrates with the Payments Apps API. Our platform streamlines access token generation so you can focus on implementing the latest API features without worrying about authentication complexity.