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

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Boolean
Default:false

Determines if returned transactions contain transaction type transfer.

•Int

The last n elements from the paginated list.

•String

A filter made up of terms, connectives, modifiers, and comparators.

nametypedescriptionacceptable_valuesdefault_valueexample_use
defaultstringFilter by a case-insensitive search of multiple fields
in a document.- query=Bob Norman
- query=title:green hoodie
available_ontime
credit_card_last4string
currencystring
ididFilter by id range.- id:1234
- id:>=1234
- id:<=1234
payment_method_namestring
payments_transfer_idid
payout_datetime
payout_statusstring
processed_attime
tax_reporting_exemptboolean
transaction_typestring
You can apply one or more filters to a query. Learn more about [Shopify API
search syntax](https://shopify.dev/api/usage/search-syntax).
•Boolean
Default:false

Reverse the order of the underlying list.

•ID

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

•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.


•ShopifyPaymentsBankAccountConnection!
non-null

All bank accounts configured for the Shopify Payments account.

Arguments

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•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

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated 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
•Boolean
Default:false

Reverse the order of the underlying list.


•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

•String

The elements that come after the specified cursor.

•String

The elements that come before the specified cursor.

•Int

The first n elements from the paginated list.

•Int

The last n elements from the paginated list.

•String

A filter made up of terms, connectives, modifiers, and comparators.

nametypedescriptionacceptable_valuesdefault_valueexample_use
defaultstringFilter by a case-insensitive search of multiple fields
in a document.- query=Bob Norman
- query=title:green hoodie
amountfloat
bank_accountstring
currencystring
ididFilter by id range.- id:1234
- id:>=1234
- id:<=1234
issued_attime
ledger_typestring
statusstring
transaction_datestime
You can apply one or more filters to a query. Learn more about [Shopify API
search syntax](https://shopify.dev/api/usage/search-syntax).
•Boolean
Default:false

Reverse the order of the underlying list.

•ID

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

•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.

•ShopifyPaymentsPayoutTransactionType

Filter the direction of the payout.


•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?