Update Account

Account ID or code. For ID no prefix is used e.g. `e28zov4fw0v2`. For code use prefix `code-`, e.g. `code-bob`.

A secondary value for the account.

The email address used for communicating with this customer. The customer will also use this email address to log into your hosted account management pages. This value does not need to be unique.

Used to determine the language and locale of emails sent on behalf of the merchant to the customer. The list of locales is restricted to those the merchant has enabled on the site.

One ofda-DKde-CHde-DEen-AUen-CAen-GBen-IEen-NZen-USes-ESes-MXes-USfi-FIfr-BEfr-CAfr-CHfr-FRhi-INit-ITja-JPko-KRnl-BEnl-NLpl-PLpt-BRpt-PTro-ROru-RUsk-SKsv-SEtr-TRzh-CN

Used to determine the time zone of emails sent on behalf of the merchant to the customer. Must be a [supported IANA time zone name](https://docs.recurly.com/docs/email-time-zones-and-time-stamps#supported-api-iana-time-zone-names)

Additional email address that should receive account correspondence. These should be separated only by commas. These CC emails will receive all emails that the `email` field also receives.

The VAT number of the account (to avoid having the VAT applied). This is only used for manually collected invoices.

The tax status of the account. `true` exempts tax on the account, `false` applies tax on the account.

The tax exemption certificate number for the account. If the merchant has an integration for the Vertex tax provider, this optional value will be sent in any tax calculation requests for the account.

Unique ID to identify the business entity assigned to the account. Available when the `Multiple Business Entities` feature is enabled.

The account code of the parent account to be associated with this account. Passing an empty value removes any existing parent association from this account. If both `parent_account_code` and `parent_account_id` are passed, the non-blank value in `parent_account_id` will be used. Only one level of parent child relationship is allowed. You cannot assign a parent account that itself has a parent account.

The UUID of the parent account to be associated with this account. Passing an empty value removes any existing parent association from this account. If both `parent_account_code` and `parent_account_id` are passed, the non-blank value in `parent_account_id` will be used. Only one level of parent child relationship is allowed. You cannot assign a parent account that itself has a parent account.

An enumerable describing the billing behavior of the account, specifically whether the account is self-paying or will rely on the parent account to pay.

One ofparentself

An optional type designation for the payment gateway transaction created by this request. Supports 'moto' value, which is the acronym for mail order and telephone transactions.

One ofmoto

Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this account. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.

Unique ID to identify an invoice template. Available when the site is on a Pro or Elite plan. Used to specify which invoice template, if any, should be used to generate invoices for the account.

State or province.

Zip or postal code.

Country, 2-letter ISO 3166-1 alpha-2 code.

Code that represents a geographic entity (location or object). Only returned when Vertex or Avalara for Communications is enabled.

A token [generated by Recurly.js](https://recurly.com/developers/reference/recurly-js/#getting-a-token).

Credit card number, spaces and dashes are accepted.

*STRONGLY RECOMMENDED*

3-letter ISO 4217 currency code.

*STRONGLY RECOMMENDED* Customer's IP address when updating their billing information.

Array of Payment Gateway References, each a reference to a third-party gateway object of varying types.

Additional attributes to send to the gateway.

Only supported on Amazon V1. For Amazon V2, use token_id with Recurly.js.

The Adyen Risk Profile Reference ID is used to identify the risk profile for the payment method.

An optional type designation for the payment gateway transaction created by this request. Supports 'moto' value, which is the acronym for mail order and telephone transactions.

One ofmoto

A token generated by Recurly.js after completing a 3-D Secure device fingerprinting or authentication challenge.

The International Bank Account Number, up to 34 alphanumeric characters comprising a country code; two check digits; and a number that includes the domestic bank account number, branch identifier, and potential routing information

The name associated with the bank account (ACH, SEPA, Bacs only)

The bank account number. (ACH, Bacs only)

The bank's rounting number. (ACH only)

Bank identifier code for UK based banks. Required for Bacs based billing infos. (Bacs only)

The payment method type for a non-credit card based billing info. `bacs`, `becs`, `pix-automatico`, `mercadopago`, `upi-autopay` are the only accepted values.

One ofbacsbecspix-automaticomercadopagoupi-autopay

The bank account type. (ACH only)

One ofcheckingsavings

Tax identifier is required if adding a billing info that is a consumer card in Brazil or in Argentina. This would be the customer's CPF/CNPJ (Brazil) and CUIT (Argentina). CPF, CNPJ and CUIT are tax identifiers for all residents who pay taxes in Brazil and Argentina respectively.

This field and a value of `cpf`, `cnpj` or `cuit` are required if adding a billing info that is an elo or hipercard type in Brazil or in Argentina.

One ofcpfcnpjcuit

The `primary_payment_method` field is used to designate the primary billing info on the account. The first billing info created on an account will always become primary. Adding additional billing infos provides the flexibility to mark another billing info as primary, or adding additional non-primary billing infos. This can be accomplished by passing the `primary_payment_method` with a value of `true`. When adding billing infos via the billing_info and /accounts endpoints, this value is not permitted, and will return an error if provided.

The `backup_payment_method` field is used to designate a billing info as a backup on the account that will be tried if the initial billing info used for an invoice is declined. All payment methods, including the billing info marked `primary_payment_method` can be set as a backup. An account can have a maximum of 1 backup, if a user sets a different payment method as a backup, the existing backup will no longer be marked as such.

Use for Adyen HPP billing info. This should only be used as part of a pending purchase request, when the billing info is nested inside an account object.

One ofadyen

Use for Online Banking billing info. This should only be used as part of a pending purchase request, when the billing info is nested inside an account object.

One ofidealsofort

One ofAmerican ExpressDankortDiners ClubDiscoverELOForbrugsforeningenHipercardJCBLaserMaestroMasterCardTest CardUnion PayUnknownVisaTarjeta Naranja

Represents the card network preference associated with the billing info for dual badged cards. Must be a supported card network.

One ofBancontactCartesBancairesDankortMasterCardVisa

Specifies a URL to which a consumer will be redirected upon completion of a redirect payment flow. Only redirect payment flows operating through Adyen Components will utilize this return URL.

UPI Autopay authentication method. Specifies how the customer authorizes the enrollment mandate. Defaults to 'vpa' if omitted.

One ofvpaqr-codeapp-deep-links

The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.

Fields must be created in the UI before values can be assigned to them.

Any values that resemble a credit card number or security code (CVV/CVC) will be rejected.

The type of record a custom field was automatically copied from.

One ofaccountplanproductsubscription

The UUID of the record this custom field was automatically copied from. Only present when the field was copied from another record.

The Avalara AvaTax value that can be passed to identify the customer type for tax purposes. The range of values can be A - R (more info at Avalara). Value is case-sensitive.

The preferred billing date for the account. This date will be used as the billing date for when activating new subscriptions on the account.