ApplicationCredit
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2019-10/application_credits.json Creates an application credit
- GET /admin/api/2019-10/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2019-10/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2019-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2019-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2019-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2019-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2019-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2019-10/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2019-10/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-01/application_credits.json Creates an application credit
- GET /admin/api/2020-01/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2020-01/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2020-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2020-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2020-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2020-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2020-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2020-01/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2020-01/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-04/application_credits.json Creates an application credit
- GET /admin/api/2020-04/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2020-04/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2020-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2020-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2020-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2020-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2020-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2020-04/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2020-04/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-07/application_credits.json Creates an application credit
- GET /admin/api/2020-07/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2020-07/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2020-07/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2020-07/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2020-07/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2020-07/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2020-07/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2020-07/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2020-07/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2020-10/application_credits.json Creates an application credit
- GET /admin/api/2020-10/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2020-10/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2020-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2020-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2020-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2020-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2020-10/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2020-10/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2020-10/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2021-01/application_credits.json Creates an application credit
- GET /admin/api/2021-01/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2021-01/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2021-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2021-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2021-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2021-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2021-01/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2021-01/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2021-01/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/2021-04/application_credits.json Creates an application credit
- GET /admin/api/2021-04/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/2021-04/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/2021-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/2021-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/2021-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/2021-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/2021-04/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/2021-04/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/2021-04/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}
The ApplicationCredit resource is used to issue credits to merchants that can be used towards future app purchases in Shopify. You can create an application credit by sending a request that includes the credit amount and a description explaining the reason for the credit. A corresponding deduction based on your revenue share is entered in your Partner account by Shopify. For example, if you create a credit for $10.00, then a deduction of $8.00 is applied.
The total amount of all application credits requested by an app must not exceed the total amount the shop owner was charged in the last 30 days, or the total amount of pending payouts in the app's Partner account.
Note
The ApplicationCredit resource can be used only by apps that use Shopify's Billing API (ApplicationCharge, RecurringApplicationCharge, or UsageCharge).
What you can do with ApplicationCredit
The Shopify API lets you do the following with the ApplicationCredit resource. More detailed versions of these general actions may be available:
- POST /admin/api/unstable/application_credits.json Creates an application credit
- GET /admin/api/unstable/application_credits/{application_credit_id}.json Retrieves a single application credit
- GET /admin/api/unstable/application_credits.json Retrieves all application credits
ApplicationCredit properties
description |
The description of the application credit. |
id |
The ID of the application credit. |
amount |
The amount refunded by the application credit. |
test |
Whether the application credit is a test transaction. Valid values: |
Endpoints
Create a test application credit that will not issue a credit to the merchant
POST /admin/api/unstable/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0,
"test": true
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636125,
"amount": "5.00",
"description": "application credit for refund",
"test": true
}
}
Creating a credit amount that exceeds the total pending payouts for the app will return an error
POST /admin/api/unstable/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Creating a credit amount that exceeds shop owner purchases over last 30 days will return an error
POST /admin/api/unstable/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded 30 day shop credit issue limit (0.00)"
]
}
}
Applying a credit to a shop without a previous app purchase will return an error
POST /admin/api/unstable/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
"errors": {
"base": [
"exceeded pending receivable credit issue limit (0.00)"
]
}
}
Create a new credit
POST /admin/api/unstable/application_credits.json
{
"application_credit": {
"description": "application credit for refund",
"amount": 5.0
}
}
View Response
HTTP/1.1 201 Created
{
"application_credit": {
"id": 1031636129,
"amount": "5.00",
"description": "application credit for refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve a single application credit
GET /admin/api/unstable/application_credits/445365009.json
View Response
HTTP/1.1 200 OK
{
"application_credit": {
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
}
fields
|
A comma-separated list of fields to include in the response. |
Retrieve all application credits
GET /admin/api/unstable/application_credits.json
View Response
HTTP/1.1 200 OK
{
"application_credits": [
{
"id": 445365009,
"amount": "5.00",
"description": "credit for application refund",
"test": null
}
]
}