User Error
Represents an error in the input of a mutation.
Anchor to FieldsFields
- Anchor to fieldfield•[String!]
The path to the input field that caused the error.
- Anchor to messagemessage•String!non-null
The error message.
Anchor to MutationsMutations
- •mutation
Charges a shop for features or services one time. This type of charge is recommended for apps that aren't billed on a recurring basis. Test and demo shops aren't charged.
- Anchor to namename•String!required
The name of the one-time purchase from the app.
- Anchor to priceprice•Money
Input!required The amount to be charged to the store for the app one-time purchase.
- Anchor to returnUrlreturn•URL!required
Url The URL where the merchant is redirected after approving the app one-time purchase.
- Anchor to testtest•BooleanDefault:false
Whether the app one-time purchase is a test transaction.
Arguments
- Anchor to appPurchaseOneTimeapp•App
Purchase One Time Purchase One Time The newly created app one-time purchase.
- Anchor to confirmationUrlconfirmation•URL
Url The URL that the merchant can access to approve or decline the newly created app one-time purchase.
If the merchant declines, then the merchant is redirected to the app and receives a notification message stating that the charge was declined. If the merchant approves and they're successfully invoiced, then the state of the charge changes from
pending
toactive
.You get paid after the charge is activated.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Cancels an app subscription on a store.
- •ID!required
The ID of the app subscription to be cancelled.
- Anchor to prorateprorate•BooleanDefault:false
Whether to issue prorated credits for the unused portion of the app subscription. There will be a corresponding deduction (based on revenue share) to your Partner account. For example, if a $10.00 app subscription (with 0% revenue share) is cancelled and prorated half way through the billing cycle, then the merchant will be credited $5.00 and that amount will be deducted from your Partner account.
Arguments
- Anchor to appSubscriptionapp•App
Subscription Subscription The cancelled app subscription.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Allows an app to charge a store for features or services on a recurring basis.
- Anchor to lineItemsline•[App
Items Subscription Line Item Input!]!required Attaches one or more pricing plans to an app subscription. Only one pricing plan can be defined for each available type.
- Anchor to namename•String!required
A descriptive name for the app subscription.
- Anchor to replacementBehaviorreplacement•App
Behavior Subscription Replacement BehaviorDefault:STANDARD The replacement behavior when creating an app subscription for a merchant with an already existing app subscription.
- Anchor to returnUrlreturn•URL!required
Url The URL pointing to the page where the merchant is redirected after approving the app subscription.
- Anchor to testtest•BooleanDefault:false
Whether the app subscription is a test transaction.
- Anchor to trialDaystrial•Int
Days The number of days of the free trial period, beginning on the day that the merchant approves the app charges.
Arguments
- Anchor to appSubscriptionapp•App
Subscription Subscription The newly-created app subscription.
- Anchor to confirmationUrlconfirmation•URL
Url The URL pointing to the page where the merchant approves or declines the charges for an app subscription.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates the capped amount on the usage pricing plan of an app subscription line item.
- Anchor to cappedAmountcapped•Money
Amount Input!required The new maximum amount of usage charges that can be incurred within a subscription billing interval.
- •ID!required
The ID of the app subscription line item to be updated.
Arguments
- Anchor to appSubscriptionapp•App
Subscription Subscription The updated app subscription.
- Anchor to confirmationUrlconfirmation•URL
Url The URL where the merchant approves or declines the updated app subscription line item.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Enables an app to charge a store for features or services on a per-use basis. The usage charge value is counted towards the
limit that was specified in the
field when the app subscription was created. If you create an app usage charge that causes the total usage charges in a billing interval to exceed the capped amount, then a
Total price exceeds balance remaining
error is returned.- Anchor to descriptiondescription•String!required
The description of the app usage record.
- Anchor to idempotencyKeyidempotency•String
Key A unique key generated by the client to avoid duplicate charges. Maximum length of 255 characters.
- Anchor to priceprice•Money
Input!required The price of the app usage record.
- Anchor to subscriptionLineItemIdsubscription•ID!required
Line Item Id The ID of the app subscription line item to create the usage record under. This app subscription line item must have a usage pricing plan.
Arguments
- Anchor to appUsageRecordapp•App
Usage Record Usage Record The newly created app usage record.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Starts the cancelation process of a running bulk operation.
There may be a short delay from when a cancelation starts until the operation is actually canceled.
- •ID!required
The ID of the bulk operation to cancel.
Arguments
- Anchor to bulkOperationbulk•Bulk
Operation Operation The bulk operation to be canceled.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Adds products to a collection.
- •ID!required
The ID of the collection that's being updated. This can't be a smart collection.
- Anchor to productIdsproduct•[ID!]!required
Ids The IDs of the products that are being added to the collection. If any of the products is already present in the input collection, then an error is raised and no products are added.
Arguments
- Anchor to collectioncollection•Collection
The updated collection. Returns
null
if an error is raised.- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates a collection.
- Anchor to inputinput•Collection
Input!required The properties to use when creating the collection.
Arguments
- Anchor to collectioncollection•Collection
The collection that has been created.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Deletes a collection.
- Anchor to inputinput•Collection
Delete Input!required The collection to delete.
Arguments
- Anchor to deletedCollectionIddeleted•ID
Collection Id The ID of the collection that was deleted. Returns
null
if the collection doesn't exist.- Anchor to shopshop•Shop!non-null
The shop associated with the collection.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Removes a set of products from a given collection. The mutation can take a long time to run. Instead of returning an updated collection the mutation returns a job, which should be polled. For use with manual collections only.
- •ID!required
The ID of the collection to remove products from. The ID must reference an existing manual collection.
- Anchor to productIdsproduct•[ID!]!required
Ids The IDs of products to remove from the collection. The mutation doesn't validate that the products belong to the collection or whether the products exist.
Arguments
- •Job
The asynchronous job removing the products.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Asynchronously reorders a set of products within a specified collection. Instead of returning an updated collection, this mutation returns a job, which should be polled. The
must be
. Displaced products will have their position altered in a consistent manner, with no gaps.
- •ID!required
The ID of the collection on which to reorder products.
- Anchor to movesmoves•[Move
Input!]!required A list of moves to perform, which will be evaluated in order. Up to 250 moves are supported, the
does not have to be unique.
Arguments
- •Job
The asynchronous job reordering the products.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates a collection.
- Anchor to inputinput•Collection
Input!required The updated properties for the collection.
Arguments
- Anchor to collectioncollection•Collection
The updated collection.
- •Job
The asynchronous job updating the products based on the new rule set.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Add tax exemptions for the customer.
- Anchor to customerIdcustomer•ID!required
Id The ID of the customer to update.
- Anchor to taxExemptionstax•[Tax
Exemptions Exemption!]!required The list of tax exemptions to add for the customer, in the format of an array or a comma-separated list. Example values:
,
.
Arguments
- Anchor to customercustomer•Customer
The updated customer.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Create a new customer. As of API version 2022-10, apps using protected customer data must meet the protected customer data requirements.
- Anchor to inputinput•Customer
Input!required The input fields to create a customer.
Arguments
- Anchor to customercustomer•Customer
The created customer.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Delete a customer. As of API version 2022-10, apps using protected customer data must meet the protected customer data requirements.
- Anchor to inputinput•Customer
Delete Input!required Specifies the customer to delete.
Arguments
- Anchor to deletedCustomerIddeleted•ID
Customer Id The ID of the deleted customer.
- Anchor to shopshop•Shop!non-null
The shop of the deleted customer.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Generate an account activation URL for a customer.
- Anchor to customerIdcustomer•ID!required
Id The ID of the customer that the URL is generated for.
Arguments
- Anchor to accountActivationUrlaccount•URL
Activation Url The generated account activation URL.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Creates a credit card payment method for a customer using a session id. These values are only obtained through card imports happening from a PCI compliant environment. Please use customerPaymentMethodRemoteCreate if you are not managing credit cards directly.
- Anchor to billingAddressbilling•Mailing
Address Address Input!required The billing address.
- Anchor to customerIdcustomer•ID!required
Id The ID of the customer.
- Anchor to sessionIdsession•String!required
Id The Cardserver session ID. Obtained by storing card data with Shopify's Cardsink. Exchanging raw card data for a session ID must be done in a PCI complaint environment.
Arguments
- Anchor to customerPaymentMethodcustomer•Customer
Payment Method Payment Method The customer payment method.
- Anchor to processingprocessing•Boolean
If the card verification result is processing. When this is true, customer_payment_method will be null.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Updates the credit card payment method for a customer.
- Anchor to billingAddressbilling•Mailing
Address Address Input!required The billing address.
- •ID!required
The ID of the customer payment method.
- Anchor to sessionIdsession•String!required
Id The Cardserver session ID.
Arguments
- Anchor to customerPaymentMethodcustomer•Customer
Payment Method Payment Method The customer payment method.
- Anchor to processingprocessing•Boolean
If the card verification result is processing. When this is true, customer_payment_method will be null.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Revokes a customer's payment method.
- Anchor to customerPaymentMethodIdcustomer•ID!required
Payment Method Id The ID of the customer payment method to be revoked.
Arguments
- Anchor to revokedCustomerPaymentMethodIdrevoked•ID
Customer Payment Method Id The ID of the revoked customer payment method.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Sends a link to the customer so they can update a specific payment method.
- Anchor to customerPaymentMethodIdcustomer•ID!required
Payment Method Id The payment method to be updated.
- Anchor to emailemail•Email
Input Specifies the payment method update email fields. Only the 'from' and 'bcc' fields are accepted for input.
Arguments
- Anchor to customercustomer•Customer
The customer to whom an update payment method email was sent.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Remove tax exemptions from a customer.
- Anchor to customerIdcustomer•ID!required
Id The ID of the customer to update.
- Anchor to taxExemptionstax•[Tax
Exemptions Exemption!]!required The list of tax exemptions to remove for the customer, in the format of an array or a comma-separated list. Example values:
,
.
Arguments
- Anchor to customercustomer•Customer
The updated customer.
- Anchor to userErrorsuser•[User
Errors Error!]!non-null The list of errors that occurred from executing the mutation.
Fields
- •mutation
Replace tax exemptions for a customer.
- Anchor to customerIdcustomer
Id
Arguments