Skip to main content
object

Requires The staff member must have permission to manage app billing or approve app charges if authenticated with an online access token as described in https://shopify.dev/apps/auth/oauth/access-modes.

Services and features purchased once by a store.

DateTime!non-null

The date and time when the app purchase occurred.

ID!non-null

A globally-unique ID.

String!non-null

The name of the app purchase.

MoneyV2!non-null

The amount to be charged to the store for the app purchase.

AppPurchaseStatus!non-null

The status of the app purchase.

Boolean!non-null

Whether the app purchase is a test transaction.


Was this section helpful?

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.

Arguments

String!required

The name of the one-time purchase from the app.

MoneyInput!required

The amount to be charged to the store for the app one-time purchase.

URL!required

The URL where the merchant is redirected after approving the app one-time purchase.

BooleanDefault:false

Whether the app one-time purchase is a test transaction.


Fields

AppPurchaseOneTime

The newly created app one-time purchase.

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 to active.

You get paid after the charge is activated.

[UserError!]!non-null

The list of errors that occurred from executing the mutation.


Was this section helpful?


Was this section helpful?