Shopify Payments Payout

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

What you can do with Shopify Payments Payout

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

Shopify Payments Payout properties

id
"id": 54534554564

The unique identifier of the payout

status
"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
"date": "2018-03-22"

The date the payout was issued.

currency
"currency": "USD"

The ISO 4217 currency code of the payout.

amount
"amount": "102.53"

The total amount of the payout, in a decimal formatted string.

Endpoints

GET /admin/shopify_payments/payouts.json
Retrieves a list of all payouts ordered by payout date, with the most recent being first.
since_id

Filter response to payouts exclusively after the specified ID.

last_id

Filter response to payouts exclusively before the specified ID

date_min

Filter response to payouts inclusively after the specified date.

date_max

Filter response to payouts inclusively before the specified date.

date

Filter response to payouts on the specified date.

status

Filter response to payouts with the specified status

List all payouts ordered newest to oldest

GET /admin/shopify_payments/payouts.json
View Response
HTTP/1.1 200 OK
{
  "payouts": [
    {
      "id": 512467833,
      "status": "failed",
      "date": "2013-11-01",
      "currency": "USD",
      "amount": "43.12",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "1.32",
        "charges_gross_amount": "45.52",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    },
    {
      "id": 349534908,
      "status": "scheduled",
      "date": "2013-11-01",
      "currency": "USD",
      "amount": "43.12",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "1.32",
        "charges_gross_amount": "45.52",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    },
    {
      "id": 39438702,
      "status": "in_transit",
      "date": "2013-11-01",
      "currency": "USD",
      "amount": "43.12",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "1.32",
        "charges_gross_amount": "45.52",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    },
    {
      "id": 974708905,
      "status": "paid",
      "date": "2012-11-13",
      "currency": "CAD",
      "amount": "51.69",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "6.46",
        "charges_gross_amount": "58.15",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    },
    {
      "id": 623721858,
      "status": "paid",
      "date": "2012-11-12",
      "currency": "USD",
      "amount": "41.90",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "1.32",
        "charges_gross_amount": "44.52",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    }
  ]
}

List all payouts up to a specfic date

GET /admin/shopify_payments/payouts.json?date_max=2012-11-12
View Response
HTTP/1.1 200 OK
{
  "payouts": [
    {
      "id": 623721858,
      "status": "paid",
      "date": "2012-11-12",
      "currency": "USD",
      "amount": "41.90",
      "summary": {
        "adjustments_fee_amount": "0.12",
        "adjustments_gross_amount": "2.13",
        "charges_fee_amount": "1.32",
        "charges_gross_amount": "44.52",
        "refunds_fee_amount": "-0.23",
        "refunds_gross_amount": "-3.54",
        "reserved_funds_fee_amount": "0.00",
        "reserved_funds_gross_amount": "0.00",
        "retried_payouts_fee_amount": "0.00",
        "retried_payouts_gross_amount": "0.00"
      }
    }
  ]
}
GET /admin/shopify_payments/payouts/623721858.json
Retrieves a single payout by id.

Retrieves a single payout by id.

GET /admin/shopify_payments/payouts/#{payout_id}.json
View Response
HTTP/1.1 200 OK
{
  "payout": {
    "id": 623721858,
    "status": "paid",
    "date": "2012-11-12",
    "currency": "USD",
    "amount": "41.90",
    "summary": {
      "adjustments_fee_amount": "0.12",
      "adjustments_gross_amount": "2.13",
      "charges_fee_amount": "1.32",
      "charges_gross_amount": "44.52",
      "refunds_fee_amount": "-0.23",
      "refunds_gross_amount": "-3.54",
      "reserved_funds_fee_amount": "0.00",
      "reserved_funds_gross_amount": "0.00",
      "retried_payouts_fee_amount": "0.00",
      "retried_payouts_gross_amount": "0.00"
    }
  }
}

Sign up for a Partner account to get started.

Sign up