Update billing info for a customer

For certain parameters, if you do not include a parameter in the request, Chargebee removes the corresponding attribute from the customer object. To retain an existing attribute, you must explicitly include its parameter in your request.

Parameters that are affected by this behavior

• billing_address.first_name
• billing_address.last_name
• billing_address.phone
• billing_address.email
• billing_address.line1
• billing_address.line2
• billing_address.line3
• billing_address.city
• billing_address.state
• billing_address.country
• billing_address.zip
• vat_number
• vat_number_prefix
• business_customer_without_vat_number
• registered_for_gst

Example

Assume the customer object has these attributes set:

Current attributes:

• billing_address.first_name
• billing_address.last_name
• billing_address.phone
• billing_address.email
• vat_number

You make an API call with only the following parameters:

Request parameters:

• billing_address.first_name
• billing_address.last_name
• billing_address.phone

Result: The billing_address.email and vat_number attributes are removed from the customer object because they weren't included in the request. To preserve these attributes, include them in the request.

• Chargebee uses the billing_address object from the customer to set the values in the billing_address of the invoices generated for the customer.
• If the billing_address object does not include the first_name, last_name, or company fields, Chargebee automatically uses the values from customer.first_name, customer.last_name, and customer.company (if available) when generating invoices.

After integrating tax providers, you might encounter unintended tax calculation failures during renewals. The error message typically states:

Unable to calculate the tax rate as the shipping/billing address is either invalid or incomplete. Please verify and try again.

This error can occur even if the is_taxable value of item prices is changed from true to false before subscription renewal and reactivation.

Solution

Use this operation to update the billing address attributes to ensure they are accurate and complete.

This error occurs when location validation is enabled in the tax settings and there's a mismatch between the customer's billing country and their IP address or the card issuing country.

Resolution

Choose one of the following solutions:

Option A: Fix IP address mismatch

Use the Update a card payment source API and include the correct IP address in the request header.

Option B: Fix BIN mismatch

Ask the customer to update their payment method with one whose BIN matches their country. You can do this using the Request Payment Method option or the Self-Serve Portal.

Option C: Disable location validation

1. In Chargebee Billing, navigate to Settings > Configure Chargebee > Taxes.
2. Select the country.
3. In the right pane, clear the Enable location validation checkbox.