Skip to main content
POST
Attach business tax details to a payment intent

Authorizations

Authorization
string
header
required

Provider secret API key (sk_live_… / sk_test_…) supplied as a Bearer token.

Path Parameters

processorPaymentId
string
required

Stripe payment intent ID (pi_…)

Body

application/json
isBusiness
boolean
required

Whether the purchase is on behalf of a business

businessName
string

Legal business name

country
string

ISO 3166-1 alpha-2 country code

customerCity
string

Billing city

customerCountry
string

ISO 3166-1 alpha-2 billing country (non-business consumers)

customerLine1
string

Billing address line 1

customerLine2
string

Billing address line 2

customerName
string

Customer full name

Maximum string length: 100
customerPostalCode
string

Billing postal code (required by Stripe Tax for US)

customerRef
string

Customer reference to persist business tax details on the customer record. Only honored by the payment-intent business-details endpoint; ignored on the checkout-session endpoint.

customerState
string

Billing state/region

taxId
string

Tax / VAT identification number

taxIdType
enum<string>

Tax ID type

Available options:
eu_vat,
gb_vat,
us_ein

Response

Business details applied and tax breakdown returned

taxBreakdown
object
required

Calculated tax breakdown