Shopify Payments Account
Requires the or the access scope.
Financial account information for merchants using Shopify Payments. Tracks current balances across all supported currencies, payout schedules, and records.
The account includes configuration details such as objects for receiving transfers, statement descriptors that appear on customer credit card statements, and the 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.
Anchor to FieldsFields
- Anchor to accountOpenerNameaccount•String
Opener Name The name of the account opener.
- Anchor to activatedactivated•Boolean!non-null
Whether the Shopify Payments setup is completed.
- Anchor to balancebalance•[Money
V2!]! non-null Current balances in all currencies for the account.
- Anchor to balanceTransactionsbalance•Shopify
Transactions Payments Balance Transaction Connection! non-null A list of balance transactions associated with the shop.
- Anchor to hideTransfershide•Boolean
Transfers Default:false Determines if returned transactions contain transaction type transfer.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Balance
Key Transaction Sort Keys 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.
- Anchor to queryquery•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.
query=Bob Normanquery=title:green hoodie- Anchor to available_on•time
- Anchor to credit_card_last4•string
- Anchor to currency•string
- 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
Example:
- Anchor to savedSearchIdsaved•ID
Search Id The ID of a saved search. The search’s query string is used as the query argument.
Arguments
- Anchor to bankAccountsbank•Shopify
Accounts Payments Bank Account Connection! non-null All bank accounts configured for the Shopify Payments account.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
Arguments
- Anchor to chargeStatementDescriptorscharge•Shopify
Statement Descriptors Payments Charge Statement Descriptor The statement descriptors used for charges.
These descriptors appear on a customer's credit card or bank statement when they make a purchase.
- Anchor to countrycountry•String!non-null
The Shopify Payments account country.
- Anchor to defaultCurrencydefault•Currency
Currency Code! non-null The default payout currency for the Shopify Payments account.
- Anchor to disputesdisputes•Shopify
Payments Dispute Connection! non-null All disputes that originated from a transaction made with the Shopify Payments account.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to queryquery•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.
Arguments
- •ID!non-null
A globally-unique ID.
- Anchor to onboardableonboardable•Boolean!non-null
Whether the Shopify Payments account can be onboarded.
- Anchor to payoutspayouts•Shopify
Payments Payout Connection! non-null All current and previous payouts made between the account and the bank account.
- Anchor to transactionTypetransaction•Shopify
Type Payments Payout Transaction Type Filter the direction of the payout.
- Anchor to firstfirst•Int
The first
nelements from the paginated list.- Anchor to afterafter•String
The elements that come after the specified cursor.
- Anchor to lastlast•Int
The last
nelements from the paginated list.- Anchor to beforebefore•String
The elements that come before the specified cursor.
- Anchor to reversereverse•BooleanDefault:false
Reverse the order of the underlying list.
- Anchor to sortKeysort•Payout
Key Sort Keys 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.
- Anchor to queryquery•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.
query=Bob Normanquery=title:green hoodie- Anchor to amount•float
- Anchor to bank_account•string
- Anchor to currency•string
- Anchor to issued_at•time
- Anchor to ledger_type•string
- Anchor to status•string
- Anchor to transaction_dates•time
Example:
- Anchor to savedSearchIdsaved•ID
Search Id The ID of a saved search. The search’s query string is used as the query argument.
Arguments
- Anchor to payoutSchedulepayout•Shopify
Schedule Payments Payout Schedule! non-null The payout schedule for the account.
- Anchor to payoutStatementDescriptorpayout•String
Statement Descriptor The descriptor used for payouts.
The descriptor appears on a merchant's bank statement when they receive a payout.
- Anchor to chargeStatementDescriptorcharge•String
Statement Descriptor Deprecated
Anchor to QueriesQueries
- •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
records showing charges, refunds, and adjustments that affect your balance. Also includesrecords andhistory between the account and connectedconfigurations.