Payment Intents

Attach business tax details to a payment intent

Changed on

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

post/v1/sdk/payment-intents/{processorPaymentId}/business-details

Request

Path parameters

processorPaymentIdstring required

Stripe payment intent ID (pi_…)

Request body

businessNamestring

Legal business name

countrystring

ISO 3166-1 alpha-2 country code

customerCitystring

Billing city

customerCountrystring

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

customerLine1string

Billing address line 1

customerLine2string

Billing address line 2

customerNamestring

Customer full name

customerPostalCodestring

Billing postal code (required by Stripe Tax for US)

customerRefstring

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.

customerStatestring

Billing state/region

isBusinessboolean required

Whether the purchase is on behalf of a business

taxIdstring

Tax / VAT identification number

taxIdType'ae_trn' | 'al_tin' | 'am_tin' | 'ao_tin' | 'au_abn' | 'aw_tin' | 'az_tin' | 'ba_tin' | 'bb_tin' | 'bd_bin' | 'bf_ifu' | 'bh_vat' | 'bj_ifu' | 'bs_tin' | 'by_tin' | 'ca_gst_hst' | 'cd_nif' | 'ch_vat' | 'cl_tin' | 'cm_niu' | 'co_nit' | 'cr_tin' | 'cv_nif' | 'ec_ruc' | 'eg_tin' | 'et_tin' | 'eu_vat' | 'gb_vat' | 'ge_vat' | 'gn_nif' | 'hk_br' | 'id_npwp' | 'in_gst' | 'is_vat' | 'jp_trn' | 'ke_pin' | 'kg_tin' | 'kh_tin' | 'kr_brn' | 'kz_bin' | 'la_tin' | 'li_vat' | 'lk_vat' | 'ma_vat' | 'md_vat' | 'me_pib' | 'mk_vat' | 'mr_nif' | 'mx_rfc' | 'my_sst' | 'ng_tin' | 'no_vat' | 'np_pan' | 'nz_gst' | 'om_vat' | 'pe_ruc' | 'ph_tin' | 'rs_pib' | 'ru_inn' | 'sa_vat' | 'sg_gst' | 'sn_ninea' | 'sr_fin' | 'th_vat' | 'tj_tin' | 'tr_tin' | 'tw_vat' | 'tz_vat' | 'ua_vat' | 'ug_tin' | 'us_ein' | 'uy_ruc' | 'uz_vat' | 'vn_tin' | 'za_vat' | 'zm_tin' | 'zw_tin'

Tax ID type

Response

Business details applied and tax breakdown returned

Changes

    • warning

      added the new not_supported enum value to the ///// response property for the response status

    • info

      added the new ae_trn enum value to the request property

    • info

      added the new al_tin enum value to the request property

    • info

      added the new am_tin enum value to the request property

    • info

      added the new ao_tin enum value to the request property

    • info

      added the new au_abn enum value to the request property

    • info

      added the new aw_tin enum value to the request property

    • info

      added the new az_tin enum value to the request property

    • info

      added the new ba_tin enum value to the request property

    • info

      added the new bb_tin enum value to the request property

    • info

      added the new bd_bin enum value to the request property

    • info

      added the new bf_ifu enum value to the request property

    • info

      added the new bh_vat enum value to the request property

    • info

      added the new bj_ifu enum value to the request property

    • info

      added the new bs_tin enum value to the request property

    • info

      added the new by_tin enum value to the request property

    • info

      added the new ca_gst_hst enum value to the request property

    • info

      added the new cd_nif enum value to the request property

    • info

      added the new ch_vat enum value to the request property

    • info

      added the new cl_tin enum value to the request property

    • info

      added the new cm_niu enum value to the request property

    • info

      added the new co_nit enum value to the request property

    • info

      added the new cr_tin enum value to the request property

    • info

      added the new cv_nif enum value to the request property

    • info

      added the new ec_ruc enum value to the request property

    • info

      added the new eg_tin enum value to the request property

    • info

      added the new et_tin enum value to the request property

    • info

      added the new ge_vat enum value to the request property

    • info

      added the new gn_nif enum value to the request property

    • info

      added the new hk_br enum value to the request property

    • info

      added the new id_npwp enum value to the request property

    • info

      added the new in_gst enum value to the request property

    • info

      added the new is_vat enum value to the request property

    • info

      added the new jp_trn enum value to the request property

    • info

      added the new ke_pin enum value to the request property

    • info

      added the new kg_tin enum value to the request property

    • info

      added the new kh_tin enum value to the request property

    • info

      added the new kr_brn enum value to the request property

    • info

      added the new kz_bin enum value to the request property

    • info

      added the new la_tin enum value to the request property

    • info

      added the new li_vat enum value to the request property

    • info

      added the new lk_vat enum value to the request property

    • info

      added the new ma_vat enum value to the request property

    • info

      added the new md_vat enum value to the request property

    • info

      added the new me_pib enum value to the request property

    • info

      added the new mk_vat enum value to the request property

    • info

      added the new mr_nif enum value to the request property

    • info

      added the new mx_rfc enum value to the request property

    • info

      added the new my_sst enum value to the request property

    • info

      added the new ng_tin enum value to the request property

    • info

      added the new no_vat enum value to the request property

    • info

      added the new np_pan enum value to the request property

    • info

      added the new nz_gst enum value to the request property

    • info

      added the new om_vat enum value to the request property

    • info

      added the new pe_ruc enum value to the request property

    • info

      added the new ph_tin enum value to the request property

    • info

      added the new rs_pib enum value to the request property

    • info

      added the new ru_inn enum value to the request property

    • info

      added the new sa_vat enum value to the request property

    • info

      added the new sg_gst enum value to the request property

    • info

      added the new sn_ninea enum value to the request property

    • info

      added the new sr_fin enum value to the request property

    • info

      added the new th_vat enum value to the request property

    • info

      added the new tj_tin enum value to the request property

    • info

      added the new tr_tin enum value to the request property

    • info

      added the new tw_vat enum value to the request property

    • info

      added the new tz_vat enum value to the request property

    • info

      added the new ua_vat enum value to the request property

    • info

      added the new ug_tin enum value to the request property

    • info

      added the new uy_ruc enum value to the request property

    • info

      added the new uz_vat enum value to the request property

    • info

      added the new vn_tin enum value to the request property

    • info

      added the new za_vat enum value to the request property

    • info

      added the new zm_tin enum value to the request property

    • info

      added the new zw_tin enum value to the request property

    • info

      added the optional property ///// to the response with the status

    • info

      added the media type application/json for the response with the status