---
title: ShopifyPaymentsAccount - GraphQL Admin
description: |-
  Balance and payout information for a
  [Shopify Payments](https://help.shopify.com/manual/payments/shopify-payments/getting-paid-with-shopify-payments)
  account. Balance includes all balances for the currencies supported by the shop.
  You can also query for a list of payouts, where each payout includes the corresponding currencyCode field.
api_version: 2025-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount
  md: https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsAccount.md
---

# Shopify​Payments​Account

object

Requires the `read_shopify_payments` or the `read_shopify_payments_accounts` access scope.

Balance and payout information for a [Shopify Payments](https://help.shopify.com/manual/payments/shopify-payments/getting-paid-with-shopify-payments) account. Balance includes all balances for the currencies supported by the shop. You can also query for a list of payouts, where each payout includes the corresponding currencyCode field.

## Fields

* account​Opener​Name

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The name of the account opener.

* activated

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the Shopify Payments setup is completed.

* balance

  [\[Money​V2!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2)

  non-null

  Current balances in all currencies for the account.

* balance​Transactions

  [Shopify​Payments​Balance​Transaction​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsBalanceTransactionConnection)

  non-null

  A list of balance transactions associated with the shop.

* bank​Accounts

  [Shopify​Payments​Bank​Account​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsBankAccountConnection)

  non-null

  All bank accounts configured for the Shopify Payments account.

* charge​Statement​Descriptors

  [Shopify​Payments​Charge​Statement​Descriptor](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/ShopifyPaymentsChargeStatementDescriptor)

  The statement descriptors used for charges.

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

* country

  [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  non-null

  The Shopify Payments account country.

* default​Currency

  [Currency​Code!](https://shopify.dev/docs/api/admin-graphql/latest/enums/CurrencyCode)

  non-null

  The default payout currency for the Shopify Payments account.

* disputes

  [Shopify​Payments​Dispute​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsDisputeConnection)

  non-null

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

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID)

  non-null

  A globally-unique ID.

* onboardable

  [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean)

  non-null

  Whether the Shopify Payments account can be onboarded.

* payouts

  [Shopify​Payments​Payout​Connection!](https://shopify.dev/docs/api/admin-graphql/latest/connections/ShopifyPaymentsPayoutConnection)

  non-null

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

* payout​Schedule

  [Shopify​Payments​Payout​Schedule!](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsPayoutSchedule)

  non-null

  The payout schedule for the account.

* payout​Statement​Descriptor

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  The descriptor used for payouts.

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

* charge​Statement​Descriptor

  [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String)

  Deprecated

***

## Map

### Fields with this object

* {}[BusinessEntity.shopifyPaymentsAccount](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessEntity#field-BusinessEntity.fields.shopifyPaymentsAccount)

***

## Queries

* [shopify​Payments​Account](https://shopify.dev/docs/api/admin-graphql/latest/queries/shopifyPaymentsAccount)

  query

  Shopify Payments account information, including balances and payouts.

***

## \<?>ShopifyPaymentsAccount Queries

### Queried by

* \<?>[shopify​Payments​Account](https://shopify.dev/docs/api/admin-graphql/latest/queries/ShopifyPaymentsAccount)

***

## Interfaces

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)

  interface

***

## ||-ShopifyPaymentsAccount Implements

### Implements

* ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)