# Adds the ability to collect and store tax identification information for customers in the Faroe Islands, Gibraltar, Italy, and Paraguay ## What’s new You can use the following new tax ID types when creating or updating [Customer.tax_ids](https://docs.stripe.com/api/customers/object.md?api-version=2026-04-22.dahlia#customer_object-tax_ids): - `fo_vat`: Faroe Islands VAT numbers - `gi_tin`: Gibraltar Tax Identification Numbers - `it_cf`: Italian Codice Fiscale - `py_ruc`: Paraguayan RUC Stripe Invoicing supports these tax ID types in the [Customers](https://docs.stripe.com/api/customers/create.md?api-version=2026-04-22.dahlia#create_customer-tax_id_data-type), [Tax IDs](https://docs.stripe.com/api/tax_ids/create.md?api-version=2026-04-22.dahlia#create_tax_id-type), [Invoices](https://docs.stripe.com/api/invoices/create.md?api-version=2026-04-22.dahlia#create_invoice-customer_details-tax_ids), [Tax Calculations](https://docs.stripe.com/api/tax/calculations/create.md?api-version=2026-04-22.dahlia#calculate_tax-customer_details-tax_ids-type), and [Tax Transactions](https://docs.stripe.com/api/tax/transactions/object.md?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-type) APIs. ## Impact You can now collect and store tax identification information for customers in the Faroe Islands, Gibraltar, Italy, and Paraguay. This can help improve tax compliance and record-keeping for businesses operating in these jurisdictions. ## Changes #### REST API | Values | Change | Enums | | ------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [Checkout.Session.customer_details.tax_ids[]](/api/checkout/sessions/object?api-version=2026-04-22.dahlia#checkout_session_object-customer_details-tax_ids-type), [Invoice.customer_tax_ids[]](/api/invoices/object?api-version=2026-04-22.dahlia#invoice_object-customer_tax_ids-type), [Tax.Calculation.customer_details.tax_ids[]](/api/tax/calculations/object?api-version=2026-04-22.dahlia#tax_calculation_object-customer_details-tax_ids-type), [Tax.Transaction.customer_details.tax_ids[]](/api/tax/transactions/object?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-type), [TaxId](/api/tax_ids/object?api-version=2026-04-22.dahlia#tax_id_object-type), [Customer#create.tax_id_data[]](/api/customers/create?api-version=2026-04-22.dahlia#create_customer-tax_id_data-type), [Invoice#create_preview.customer_details.tax_ids[]](/api/invoices/create_preview?api-version=2026-04-22.dahlia#create_invoice-customer_details-tax_ids-type), [Tax.Calculation#create.customer_details.tax_ids[]](/api/tax/calculations/create?api-version=2026-04-22.dahlia#calculate_tax-customer_details-tax_ids-type), [TaxId#create](/api/tax_ids/customer_create?api-version=2026-04-22.dahlia#create_customer_tax_id-type), [TaxId#create](/api/tax_ids/create?api-version=2026-04-22.dahlia#create_tax_id-type) | #### Ruby This change does not affect the Ruby SDK. #### Python | Values | Change | Enums | | ------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [Checkout.Session.CustomerDetail.TaxId](/api/checkout/sessions/object?api-version=2026-04-22.dahlia#checkout_session_object-customer_details-tax_ids-type), [Invoice.CustomerTaxId](/api/invoices/object?api-version=2026-04-22.dahlia#invoice_object-customer_tax_ids-type), [Tax.Calculation.CustomerDetail.TaxId](/api/tax/calculations/object?api-version=2026-04-22.dahlia#tax_calculation_object-customer_details-tax_ids-type), [Tax.Transaction.CustomerDetail.TaxId](/api/tax/transactions/object?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-type), [TaxId](/api/tax_ids/object?api-version=2026-04-22.dahlia#tax_id_object-type), [CustomerCreateParamsTaxIdDatum](/api/customers/create?api-version=2026-04-22.dahlia#create_customer-tax_id_data-type), [CustomerCreateTaxIdParams](/api/tax_ids/customer_create?api-version=2026-04-22.dahlia#create_customer_tax_id-type), [InvoiceCreatePreviewParamsCustomerDetailTaxId](/api/invoices/create_preview?api-version=2026-04-22.dahlia#create_invoice-customer_details-tax_ids-type), [tax.CalculationCreateParamsCustomerDetailTaxId](/api/tax/calculations/create?api-version=2026-04-22.dahlia#calculate_tax-customer_details-tax_ids-type), [TaxIdCreateParams](/api/tax_ids/create?api-version=2026-04-22.dahlia#create_tax_id-type) | #### PHP | Values | Change | Enums | | ------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [Checkout.Session.customer_details.tax_ids[]](/api/checkout/sessions/object?api-version=2026-04-22.dahlia#checkout_session_object-customer_details-tax_ids-type), [Invoice.customer_tax_ids[]](/api/invoices/object?api-version=2026-04-22.dahlia#invoice_object-customer_tax_ids-type), [Tax.Calculation.customer_details.tax_ids[]](/api/tax/calculations/object?api-version=2026-04-22.dahlia#tax_calculation_object-customer_details-tax_ids-type), [Tax.Transaction.customer_details.tax_ids[]](/api/tax/transactions/object?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-type), [TaxId](/api/tax_ids/object?api-version=2026-04-22.dahlia#tax_id_object-type) | #### Java | Values | Change | Enums | | ------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [CustomerCreateParams.tax_id_data[]](/api/customers/create?api-version=2026-04-22.dahlia#create_customer-tax_id_data-type), [TaxIdCreateParams](/api/tax_ids/customer_create?api-version=2026-04-22.dahlia#create_customer_tax_id-type), [InvoiceCreatePreviewParams.customer_details.tax_ids[]](/api/invoices/create_preview?api-version=2026-04-22.dahlia#create_invoice-customer_details-tax_ids-type), [tax.CalculationCreateParams.customer_details.tax_ids[]](/api/tax/calculations/create?api-version=2026-04-22.dahlia#calculate_tax-customer_details-tax_ids-type), [TaxIdCreateParams](/api/tax_ids/create?api-version=2026-04-22.dahlia#create_tax_id-type) | #### Node.js | Values | Change | Enums | | ------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [Checkout.Session.customer_details.tax_ids[]](/api/checkout/sessions/object?api-version=2026-04-22.dahlia#checkout_session_object-customer_details-tax_ids-type), [Invoice.customer_tax_ids[]](/api/invoices/object?api-version=2026-04-22.dahlia#invoice_object-customer_tax_ids-type), [Tax.Calculation.customer_details.tax_ids[]](/api/tax/calculations/object?api-version=2026-04-22.dahlia#tax_calculation_object-customer_details-tax_ids-type), [Tax.Transaction.customer_details.tax_ids[]](/api/tax/transactions/object?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-type), [TaxId](/api/tax_ids/object?api-version=2026-04-22.dahlia#tax_id_object-type), [CustomerCreateParams.tax_id_data[]](/api/customers/create?api-version=2026-04-22.dahlia#create_customer-tax_id_data-type), [CustomerCreateTaxIdParams](/api/tax_ids/customer_create?api-version=2026-04-22.dahlia#create_customer_tax_id-type), [InvoiceCreatePreviewParams.customer_details.tax_ids[]](/api/invoices/create_preview?api-version=2026-04-22.dahlia#create_invoice-customer_details-tax_ids-type), [Tax.CalculationCreateParams.customer_details.tax_ids[]](/api/tax/calculations/create?api-version=2026-04-22.dahlia#calculate_tax-customer_details-tax_ids-type), [TaxIdCreateParams](/api/tax_ids/create?api-version=2026-04-22.dahlia#create_tax_id-type) | #### Go | Values | Change | Enums | | ------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `fo_vat`, `gi_tin`, `it_cf`, `py_ruc` | Added | [CheckoutSessionCustomerDetailsTaxIds](/api/checkout/sessions/object?api-version=2026-04-22.dahlia#checkout_session_object-customer_details-tax_ids-Type), [TaxCalculationCustomerDetailsTaxId](/api/tax/calculations/object?api-version=2026-04-22.dahlia#tax_calculation_object-customer_details-tax_ids-Type), [TaxTransactionCustomerDetailsTaxId](/api/tax/transactions/object?api-version=2026-04-22.dahlia#tax_transaction_object-customer_details-tax_ids-Type), [TaxId](/api/tax_ids/object?api-version=2026-04-22.dahlia#tax_id_object-Type) | #### .NET This change does not affect the .NET SDK. ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. If you use an SDK, upgrade to the corresponding SDK version for this API version. - If you don’t use an SDK, update your [API requests](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-04-22.dahlia` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). ## Related changes - [Adds expandable tax rate property to tax rate details](https://docs.stripe.com/changelog/dahlia/2026-04-22/adds-expandable-tax-rate-property-to-tax-rate-details.md)