Skip to main content
Anchor to ShopifyPaymentsAccount

ShopifyPaymentsAccount

object

Requires the read_shopify_payments or the read_shopify_payments_accounts access scope.

Financial account information for merchants using Shopify Payments. Tracks current balances across all supported currencies, payout schedules, and ShopifyPaymentsBalanceTransaction records.

The account includes configuration details such as ShopifyPaymentsBankAccount objects for receiving ShopifyPaymentsPayout transfers, statement descriptors that appear on customer credit card statements, and the ShopifyPaymentsPayoutSchedule that determines when funds transfer to your bank. Access balance transactions to review individual charges, refunds, and adjustments that affect your account balance. Query payouts to track money movement between your Shopify Payments balance and bank accounts.

String

The name of the account opener.

Boolean!
non-null

Whether the Shopify Payments setup is completed.

[MoneyV2!]!
non-null

Current balances in all currencies for the account.

ShopifyPaymentsBalanceTransactionConnection!
non-null

A list of balance transactions associated with the shop.

Arguments

Boolean
Default:false

Determines if returned transactions contain transaction type transfer.

Int

The first n elements from the paginated list.

String

The elements that come after the specified cursor.

Int

The last n elements from the paginated list.

String

The elements that come before the specified cursor.

Boolean
Default:false

Reverse the order of the underlying list.

BalanceTransactionSortKeys
Default:PROCESSED_AT

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to default
string

Filter by a case-insensitive search of multiple fields in a document.

Example:

  • query=Bob Norman
  • query=title:green hoodie
Anchor to available_on
time
Anchor to credit_card_last4
string
Anchor to currency
string
id

Filter by id range.

Example:

  • id:1234
  • id:>=1234
  • id:<=1234
Anchor to payment_method_name
string
Anchor to payments_transfer_id
id
Anchor to payout_date
time
Anchor to payout_status
string
Anchor to processed_at
time
Anchor to tax_reporting_exempt
boolean
Anchor to transaction_type
string
ID

The ID of a saved search. The search’s query string is used as the query argument.


ShopifyPaymentsBankAccountConnection!
non-null

All bank accounts configured for the Shopify Payments account.

Arguments

Int

The first n elements from the paginated list.

String

The elements that come after the specified cursor.

Int

The last n elements from the paginated list.

String

The elements that come before the specified cursor.

Boolean
Default:false

Reverse the order of the underlying list.


Anchor to chargeStatementDescriptorschargeStatementDescriptors
ShopifyPaymentsChargeStatementDescriptor

The statement descriptors used for charges.

These descriptors appear on a customer's credit card or bank statement when they make a purchase.

String!
non-null

The Shopify Payments account country.

CurrencyCode!
non-null

The default payout currency for the Shopify Payments account.

ShopifyPaymentsDisputeConnection!
non-null

All disputes that originated from a transaction made with the Shopify Payments account.

Arguments

Int

The first n elements from the paginated list.

String

The elements that come after the specified cursor.

Int

The last n elements from the paginated list.

String

The elements that come before the specified cursor.

Boolean
Default:false

Reverse the order of the underlying list.

String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

id

Filter by id range.

Example:

  • id:1234
  • id:>=1234
  • id:<=1234
Anchor to initiated_at
time
string

ID!
non-null

A globally-unique ID.

Boolean!
non-null

Whether the Shopify Payments account can be onboarded.

ShopifyPaymentsPayoutConnection!
non-null

All current and previous payouts made between the account and the bank account.

Arguments

ShopifyPaymentsPayoutTransactionType

Filter the direction of the payout.

Int

The first n elements from the paginated list.

String

The elements that come after the specified cursor.

Int

The last n elements from the paginated list.

String

The elements that come before the specified cursor.

Boolean
Default:false

Reverse the order of the underlying list.

PayoutSortKeys
Default:ISSUED_AT

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to default
string

Filter by a case-insensitive search of multiple fields in a document.

Example:

  • query=Bob Norman
  • query=title:green hoodie
float
Anchor to bank_account
string
Anchor to currency
string
id

Filter by id range.

Example:

  • id:1234
  • id:>=1234
  • id:<=1234
Anchor to issued_at
time
Anchor to ledger_type
string
string
Anchor to transaction_dates
time
ID

The ID of a saved search. The search’s query string is used as the query argument.


ShopifyPaymentsPayoutSchedule!
non-null

The payout schedule for the account.

Anchor to payoutStatementDescriptorpayoutStatementDescriptor
String

The descriptor used for payouts.

The descriptor appears on a merchant's bank statement when they receive a payout.

Anchor to chargeStatementDescriptorchargeStatementDescriptor
String
Deprecated

Was this section helpful?

query

Returns the Shopify Payments account information for the shop. Includes current balances across all currencies, payout schedules, and bank account configurations.

The account includes ShopifyPaymentsBalanceTransaction records showing charges, refunds, and adjustments that affect your balance. Also includes ShopifyPaymentsDispute records and ShopifyPaymentsPayout history between the account and connected ShopifyPaymentsBankAccount configurations.


Was this section helpful?

interface

Was this section helpful?