---
title: ApplicationCharge
description: Charge a shop a one-time fee by creating an application charge.
api_version: 2026-07
source_url:
  html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge'
  md: >-
    https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md
api_name: admin-rest
api_type: rest
---

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Application​Charge

The ApplicationCharge resource facilitates one-time charges. This type of charge is recommended for apps that aren’t billed on a recurring basis. You can create an application charge by sending a request with the name the charge should appear under, the price your app is charging, and a return URL where Shopify redirects the merchant after the charge is accepted. After you've created the charge, redirect the merchant to the confirmation URL returned by Shopify. If the charge is declined, then Shopify redirects the merchant and provides a notification message that the app charge was declined.

**Note:**

For testing purposes you can include `"test": true` when creating the charge. This prevents the credit card from being charged. Test shops and demo shops can't be charged.

\#

## Endpoints

* [post](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#post-application-charges)

  [/admin/api/latest/application\_​charges.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#post-application-charges)

  Creates an application charge

  [appPurchaseOneTimeCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appPurchaseOneTimeCreate?example=creates-an-application-charge)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#get-application-charges)

  [/admin/api/latest/application\_​charges.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#get-application-charges)

  Retrieves a list of application charges

  [currentAppInstallation](https://shopify.dev/docs/api/admin-graphql/latest/queries/currentAppInstallation?example=retrieves-a-list-of-application-charges)

* [get](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#get-application-charges-application-charge-id)

  [/admin/api/latest/application\_​charges/{application\_​charge\_​id}.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/applicationcharge.md#get-application-charges-application-charge-id)

  Retrieves an application charge

***

## The ApplicationCharge resource

### Properties

***

confirmation\_url

->[confirmationUrl](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTimeCreatePayload#field-AppPurchaseOneTimeCreatePayload.fields.confirmationUrl)

The URL where the merchant accepts or declines the application charge.

***

created\_at

->[createdAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.createdAt)

The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the application charge was created.

***

id

->[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.id)

The ID of the application charge.

***

name

->[name](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.name)

The application charge name.

***

price

->[price](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.price)

The price of the application charge. The minimum price is 0.50, and maximum price is 10,000.

***

return\_url

The URL where the merchant is redirected after accepting a charge.

***

status

->[status](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.status)

The status of the application charge. Valid values:

* **pending**: The application charge is pending approval by the merchant.
* **accepted**: **Removed in version 2021-01**. The application charge has been accepted by the merchant and is ready to be activated by the app. At this point it will appear on the merchant's invoice. As of API version 2021-01, when a merchant accepts a charge, the charge immediately transitions from `pending` to `active`.
* **active**: The application charge has been activated by the app and will be paid out to the Partner.
* **declined**: The application charge was declined by the merchant.
* **expired**: The application charge was not accepted within 2 days of being created.

***

test

->[test](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.test)

Whether the application charge is a test transaction. Valid values:`true`,`null`.

***

updated\_at

The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the charge was last updated.

***

currency

->[price](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppPurchaseOneTime#field-AppPurchaseOneTime.fields.price)

The currency of the price of the application charge.

***

{}

## The ApplicationCharge resource

```json
{
  "confirmation_url": "https://jsmith.myshopify.com/admin/charges/confirm_application_charge?id=1012637313&signature=BAhpBIGeWzw%3D--17779c1efb4688e9cfa653a3245f923b4f1eb140",
  "created_at": "2013-06-27T08:48:27-04:00",
  "id": 675931192,
  "name": "Super Duper Expensive action",
  "price": "100.00",
  "return_url": "http://super-duper.shopifyapps.com",
  "status": "accepted",
  "test": null,
  "updated_at": "2013-06-27T08:48:27-04:00",
  "currency": "USD"
}
```

***

## postCreates an application charge

[appPurchaseOneTimeCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appPurchaseOneTimeCreate?example=creates-an-application-charge)

Creates an application charge

### Parameters

***

api\_version

**string**

**required**

***

### Examples

### Create a test charge that will not cause a credit card to be charged

### Request body

application\_​charge​

**Application\_charge resource**

application\_​charge.name:​"Super Duper Expensive action"

The application charge name.

application\_​charge.price:​100

The price of the application charge. The minimum price is 0.50, and maximum price is 10,000.

application\_​charge.return\_​url:​"http://super-duper.shopifyapps.com"

The URL where the merchant is redirected after accepting a charge.

application\_​charge.test:​true

Whether the application charge is a test transaction. Valid values:`true`,`null`.

### Create an application charge

### Request body

application\_​charge​

**Application\_charge resource**

application\_​charge.name:​"Super Duper Expensive action"

The application charge name.

application\_​charge.price:​100

The price of the application charge. The minimum price is 0.50, and maximum price is 10,000.

application\_​charge.return\_​url:​"http://super-duper.shopifyapps.com"

The URL where the merchant is redirected after accepting a charge.

### Trying to create a charge with a price less than 0.50 will return an error

### Request body

application\_​charge​

**Application\_charge resource**

application\_​charge.name:​"Super Duper Expensive action"

The application charge name.

application\_​charge.price:​0.4

The price of the application charge. The minimum price is 0.50, and maximum price is 10,000.

application\_​charge.return\_​url:​"http://super-duper.shopifyapps.com"

The URL where the merchant is redirected after accepting a charge.

### Trying to create a charge without a price or name will return an error

### Request body

application\_​charge​

**Application\_charge resource**

application\_​charge.name:​""

The application charge name.

post

## /admin/api/2026-07/application\_​charges.​json

```bash
curl -d '{"application_charge":{"name":"Super Duper Expensive action","price":100,"return_url":"http://super-duper.shopifyapps.com","test":true}}' \
-X POST "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
HTTP/1.1 201 Created
{
  "application_charge": {
    "id": 1017262360,
    "name": "Super Duper Expensive action",
    "api_client_id": 755357713,
    "price": "100.00",
    "status": "pending",
    "return_url": "http://super-duper.shopifyapps.com/",
    "test": true,
    "created_at": "2026-07-01T12:19:32-04:00",
    "updated_at": "2026-07-01T12:19:32-04:00",
    "currency": "USD",
    "charge_type": null,
    "decorated_return_url": "http://super-duper.shopifyapps.com/?charge_id=1017262360",
    "confirmation_url": "https://jsmith.myshopify.com/admin/charges/755357713/1017262360/ApplicationCharge/confirm_application_charge?signature=BAh7BzoHaWRpBBgxojw6EmF1dG9fYWN0aXZhdGVU--695e9dd53dcb8a5399f470c028ba529dce34199d"
  }
}
```

### examples

* #### Create a test charge that will not cause a credit card to be charged

  #####

  ```curl
  curl -d '{"application_charge":{"name":"Super Duper Expensive action","price":100,"return_url":"http://super-duper.shopifyapps.com","test":true}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 201 Created{"application_charge":{"id":1017262360,"name":"Super Duper Expensive action","api_client_id":755357713,"price":"100.00","status":"pending","return_url":"http://super-duper.shopifyapps.com/","test":true,"created_at":"2026-07-01T12:19:32-04:00","updated_at":"2026-07-01T12:19:32-04:00","currency":"USD","charge_type":null,"decorated_return_url":"http://super-duper.shopifyapps.com/?charge_id=1017262360","confirmation_url":"https://jsmith.myshopify.com/admin/charges/755357713/1017262360/ApplicationCharge/confirm_application_charge?signature=BAh7BzoHaWRpBBgxojw6EmF1dG9fYWN0aXZhdGVU--695e9dd53dcb8a5399f470c028ba529dce34199d"}}
  ```

* #### Create an application charge

  #####

  ```curl
  curl -d '{"application_charge":{"name":"Super Duper Expensive action","price":100,"return_url":"http://super-duper.shopifyapps.com"}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

* #### Trying to create a charge with a price less than 0.50 will return an error

  #####

  ```curl
  curl -d '{"application_charge":{"name":"Super Duper Expensive action","price":0.4,"return_url":"http://super-duper.shopifyapps.com"}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #### response

  ```json
  HTTP/1.1 422 Unprocessable Entity{"errors":{"price":["must be greater than or equal to the equivalent of $0.50 USD"]}}
  ```

* #### Trying to create a charge without a price or name will return an error

  #####

  ```curl
  curl -d '{"application_charge":{"name":""}}' \
  -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

***

## getRetrieves a list of application charges

[currentAppInstallation](https://shopify.dev/docs/api/admin-graphql/latest/queries/currentAppInstallation?example=retrieves-a-list-of-application-charges)

Retrieves a list of application charges

### Parameters

***

api\_version

**string**

**required**

***

fields

A comma-separated list of fields to include in the response.

***

since\_id

Restrict results to after the specified ID.

***

### Examples

### Retrieve all application charges

### Retrieve all application charges since a specified ID

### Query parameters

since\_​id=​556467234

Restrict results to after the specified ID.

get

## /admin/api/2026-07/application\_​charges.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "application_charges": [
    {
      "id": 556467234,
      "name": "Green theme",
      "api_client_id": 755357713,
      "price": "120.00",
      "status": "accepted",
      "return_url": "http://google.com",
      "test": null,
      "external_id": null,
      "created_at": "2026-07-01T12:17:28-04:00",
      "updated_at": "2026-07-01T12:17:28-04:00",
      "currency": "USD",
      "charge_type": "theme",
      "decorated_return_url": "http://google.com?charge_id=556467234"
    },
    {
      "id": 675931192,
      "name": "iPod Cleaning",
      "api_client_id": 755357713,
      "price": "5.00",
      "status": "accepted",
      "return_url": "http://google.com",
      "test": null,
      "created_at": "2026-07-01T12:17:28-04:00",
      "updated_at": "2026-07-01T12:17:28-04:00",
      "currency": "USD",
      "charge_type": null,
      "decorated_return_url": "http://google.com?charge_id=675931192"
    },
    {
      "id": 1017262346,
      "name": "Create me a logo",
      "api_client_id": 755357713,
      "price": "123.00",
      "status": "accepted",
      "return_url": "http://google.com",
      "test": null,
      "created_at": "2026-07-01T12:17:28-04:00",
      "updated_at": "2026-07-01T12:17:28-04:00",
      "currency": "USD",
      "charge_type": "brokered_service",
      "decorated_return_url": "http://google.com?charge_id=1017262346"
    }
  ]
}
```

### examples

* #### Retrieve all application charges

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"application_charges":[{"id":556467234,"name":"Green theme","api_client_id":755357713,"price":"120.00","status":"accepted","return_url":"http://google.com","test":null,"external_id":null,"created_at":"2026-07-01T12:17:28-04:00","updated_at":"2026-07-01T12:17:28-04:00","currency":"USD","charge_type":"theme","decorated_return_url":"http://google.com?charge_id=556467234"},{"id":675931192,"name":"iPod Cleaning","api_client_id":755357713,"price":"5.00","status":"accepted","return_url":"http://google.com","test":null,"created_at":"2026-07-01T12:17:28-04:00","updated_at":"2026-07-01T12:17:28-04:00","currency":"USD","charge_type":null,"decorated_return_url":"http://google.com?charge_id=675931192"},{"id":1017262346,"name":"Create me a logo","api_client_id":755357713,"price":"123.00","status":"accepted","return_url":"http://google.com","test":null,"created_at":"2026-07-01T12:17:28-04:00","updated_at":"2026-07-01T12:17:28-04:00","currency":"USD","charge_type":"brokered_service","decorated_return_url":"http://google.com?charge_id=1017262346"}]}
  ```

* #### Retrieve all application charges since a specified ID

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges.json?since_id=556467234" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

***

## getRetrieves an application charge

Retrieves an application charge

### Parameters

***

api\_version

**string**

**required**

***

application\_charge\_id

**string**

**required**

***

fields

A comma-separated list of fields to include in the response.

***

### Examples

### Retrieve an application charge

### Path parameters

application\_​charge\_​id=​675931192

**string**

**required**

get

## /admin/api/2026-07/application\_​charges/675931192.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges/675931192.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "application_charge": {
    "id": 675931192,
    "name": "iPod Cleaning",
    "api_client_id": 755357713,
    "price": "5.00",
    "status": "accepted",
    "return_url": "http://google.com",
    "test": null,
    "created_at": "2026-07-01T12:17:28-04:00",
    "updated_at": "2026-07-01T12:17:28-04:00",
    "currency": "USD",
    "charge_type": null,
    "decorated_return_url": "http://google.com?charge_id=675931192"
  }
}
```

### examples

* #### Retrieve an application charge

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/application_charges/675931192.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"application_charge":{"id":675931192,"name":"iPod Cleaning","api_client_id":755357713,"price":"5.00","status":"accepted","return_url":"http://google.com","test":null,"created_at":"2026-07-01T12:17:28-04:00","updated_at":"2026-07-01T12:17:28-04:00","currency":"USD","charge_type":null,"decorated_return_url":"http://google.com?charge_id=675931192"}}
  ```