---
title: "Attach business tax details to a payment intent"
method: POST
path: "/v1/sdk/payment-intents/{processorPaymentId}/business-details"
tags: ["Payment Intents"]
---

# Attach business tax details to a payment intent

`POST /v1/sdk/payment-intents/{processorPaymentId}/business-details`

Applies business or consumer tax location to a payment intent and returns the calculated tax breakdown.

## Path parameters

- `processorPaymentId` string, required

## Request body

- BusinessDetailsDto
  - `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
  - `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
  - `isBusiness` boolean, required — Whether the purchase is on behalf of a business
  - `taxId` string — Tax / VAT identification number
  - `taxIdType` 'eu_vat' | 'gb_vat' | 'us_ein' — Tax ID type

## Response `200`

Business details applied and tax breakdown returned

- AttachBusinessDetailsResponse
  - `taxBreakdown` TaxBreakdownDto, required
    - `currency` string, required — ISO 4217 currency code
    - `inclusive` boolean, required — Whether tax is included in the listed price
    - `subtotal` number, required — Pre-tax amount in minor units
    - `taxAmount` number, required — Tax amount in minor units
    - `taxRate` number, required — Tax rate as a decimal (e.g. 0.25 for 25%)
    - `taxType` 'amusement_tax' | 'communications_tax' | 'gst' | 'hst' | 'igst' | 'jct' | 'lease_tax' | 'pst' | 'qst' | 'retail_delivery_fee' | 'rst' | 'sales_tax' | 'service_tax' | 'vat' — Stripe tax type (e.g. vat, sales_tax, gst)
    - `total` number, required — Total amount in minor units
    - `treatment` 'reverse_charge' | 'standard' | 'none' | 'not_collecting', required

## Other responses

- `400` — Invalid request or business details
- `404` — Payment intent not found

---

[API](https://skmtc.net/solvapay/apis/solvapay-rest-api.md) · [All operations](https://skmtc.net/solvapay/apis/solvapay-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solvapay/solvapay-rest-api/revisions/d29ab7373802/schema)