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