---
title: "BillingAccount"
description: "the tenant's account with the payment provider: the provider's customer id, the currency, the address, the payment state, the period"
section: concepts
address: /concepts/billingaccount
contract: 0476e35e6e275db5
---

# BillingAccount

the tenant's account with the payment provider: the provider's customer id, the currency, the address, the payment state, the period

[figure: BillingAccount is a row at tenant scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | row |
| scope | tenant |
| key | the tenant |
| store | postgres |
| family | operations |



## Fields


| field | type | required | note |
|---|---|---|---|
| `provider` | `text` | yes | the connector package |
| `customer_id` | `text` | yes | the provider's |
| `currency` | `text` | yes |  |
| `address` | `text` | no |  |
| `payment_state` | `one of none \| on file \| failing` | yes |  |
| `period` | `one of monthly \| yearly` | yes |  |



## Routes that use it
No route takes or returns BillingAccount directly. The record holds it, and the objects that point at it reach it.