What causes "Billing address is not provided" in nopSolutions/nopCommerce?

Ensure the billing address is set on the customer before submitting payment: assign Customer.BillingAddressId.

nopSolutions/nopCommerce · error · NopException

Billing address is not provided

Error message

Billing address is not provided

What it means

Thrown by PrepareAndValidateBillingAddressAsync when the customer's BillingAddressId is null. A billing address is mandatory for every order regardless of shipping requirements, as it determines taxation, invoice generation, and payment processing address verification. This check runs after customer validation in the PlaceOrder pipeline.

Source

Thrown at src/Libraries/Nop.Services/Orders/OrderProcessingService.cs:543

        if (!await ValidateMinOrderTotalAmountAsync(details.Cart))
        {
            var minOrderTotalAmount = await _currencyService.ConvertFromPrimaryStoreCurrencyAsync(_orderSettings.MinOrderTotalAmount, currentCurrency);
            throw new NopException(string.Format(await _localizationService.GetResourceAsync("Checkout.MinOrderTotalAmount"),
                await _priceFormatter.FormatPriceAsync(minOrderTotalAmount, true, false)));
        }
    }

    /// <summary>
    /// Prepare and validate billing address
    /// </summary>
    /// <param name="details">PlaceOrder container</param>
    /// <returns>A task that represents the asynchronous operation</returns>
    /// <exception cref="NopException">Validation problems</exception>
    protected virtual async Task PrepareAndValidateBillingAddressAsync(PlaceOrderContainer details)
    {
        if (details.Customer.BillingAddressId is null)
            throw new NopException("Billing address is not provided");

        var billingAddress = await _customerService.GetCustomerBillingAddressAsync(details.Customer);

        if (!CommonHelper.IsValidEmail(billingAddress?.Email))
            throw new NopException("Email is not valid");

        details.BillingAddress = _addressService.CloneAddress(billingAddress);

        if (await _countryService.GetCountryByAddressAsync(details.BillingAddress) is Country billingCountry && !billingCountry.AllowsBilling)
            throw new NopException($"Country '{billingCountry.Name}' is not allowed for billing");
    }

    /// <summary>
    /// Prepare and validate customer
    /// </summary>
    /// <param name="details">PlaceOrder container</param>
    /// <param name="processPaymentRequest">payment info holder</param>
    /// <param name="currentCurrency">The working currency</param>

View on GitHub (pinned to 64bdf2ff08)

Solutions

Ensure the billing address is set on the customer before submitting payment: assign Customer.BillingAddressId.
In the checkout flow, require a billing address step and validate its presence on the payment page.
For custom integrations, use ICustomerService.AddCustomerAddressAsync then set BillingAddressId before PlaceOrder.
For digital/downloadable products where shipping is skipped, still require and validate a billing address.

Example fix

// before: customer.BillingAddressId == null, PlaceOrder called
// after:
await _customerService.AddCustomerAddressAsync(customer, billingAddress);
customer.BillingAddressId = billingAddress.Id;
await _customerService.UpdateCustomerAsync(customer);

Defensive patterns

Strategy: validation

Validate before calling

// Before PlaceOrder, confirm the customer has a billing address
if (customer.BillingAddressId == null)
{
    _notificationService.ErrorNotification("Please provide a billing address.");
    return RedirectToRoute("CheckoutBillingAddress");
}

Type guard

bool HasBillingAddress(Customer c) => c.BillingAddressId.HasValue;

Try / catch

try
{
    var result = await _orderProcessingService.PlaceOrderAsync(processPaymentRequest);
}
catch (NopException ex) when (ex.Message == "Billing address is not provided")
{
    return RedirectToRoute("CheckoutBillingAddress");
}

Prevention

Require a billing address step in checkout even for digital/downloadable goods.
In custom integrations, always set BillingAddressId before calling PlaceOrder.
For guest checkout, persist the entered billing address before proceeding to payment.
Add a payment-page guard that redirects to the billing step if BillingAddressId is null.

When it happens

Trigger: The customer completed checkout without setting a billing address, the BillingAddressId was never assigned, or a programmatic order request was created for a customer without a billing address. Unlike shipping, there is no 'pickup' exemption for billing.

Common situations: A custom checkout flow or API that skips the billing address step. A guest customer whose billing address wasn't persisted to the address book before PlaceOrder. Data inconsistency where the address was deleted but the foreign key wasn't cleared. A migration where billing addresses weren't imported.

Related errors

AI-assisted analysis of nopSolutions/nopCommerce@64bdf2ff08 (2026-08-13). Data as JSON: /api/errors/b277419dbc3e1b36. Report an issue: GitHub.