Payouts

Payouts represent the movement of money between a Shopify Payments account balance and a connected bank account.

What you can do with Payouts

The Shopify API lets you do the following with the Payouts resource. More detailed versions of these general actions may be available:

Payouts properties

id plain "id": 54534554564 The unique identifier of the payout
status plain "status": "scheduled" The transfer status of the payout. The value will be one of the following:
+ scheduled: The payout has been created and had transactions assigned to it, but it has not yet been submitted to the bank.
+ in_transit: The payout has been submitted to the bank for processing.
+ paid: The payout has been successfully deposited into the bank.
+ failed: The payout has been declined by the bank.
+ canceled: The payout has been canceled by Shopify.
date plain "date": "2018-03-22" The date (ISO 8601 format) when the payout was issued.
currency plain "currency": "USD" The ISO 4217 currency code of the payout.
amount plain "amount": "102.53" The total amount of the payout, in a decimal formatted string.

Endpoints

GET/admin/api/2021-01/shopify_payments/payouts.json Retrieves a list of all payouts ordered by payout date, with the most recent being first. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. Sending the <font style="background-color:#F4F6F8;">page</font> parameter will return an error. To learn more, see Making requests to paginated REST Admin API endpoints.
since_id Filter the response to payouts made after the specified ID.
last_id Filter the response to payouts made before the specified ID.
date_min Filter the response to payouts made inclusively after the specified date.
date_max Filter the response to payouts made inclusively before the specified date.
date Filter the response to payouts made on the specified date.
status Filter the response to payouts made with the specified status.

List all payouts ordered newest to oldest

GET /admin/api/2021-01/shopify_payments/payouts.json

View Response

List all payouts up to a specified date

GET /admin/api/2021-01/shopify_payments/payouts.json?date_max=2012-11-12

View Response

GET/admin/api/2021-01/shopify_payments/payouts/{payout_id}.json Retrieves a single payout by id.

Retrieves a single payout by id

GET /admin/api/2021-01/shopify_payments/payouts/623721858.json

View Response