# Cobrar a tarifa de envio

Crie tarifas de envio diferentes para os clientes.

As taxas de envio permitem exibir várias opções de remessa, como padrão, expressa e dia seguinte, com estimativas de entrega mais precisas. Cobre o cliente pelo envio usando diferentes produtos Stripe. Antes de criar uma taxa de envio, saiba como [coletar endereços de cobrança e entrega](https://docs.stripe.com/payments/collect-addresses.md).

# Página hospedada

> This is a Página hospedada for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/during-payment/charge-shipping?payment-ui=stripe-hosted.

## Criar tarifa de envio [Dashboard] [Lado do servidor]

As tarifas de envio só aceitam valores fixos para todo o pedido. Não é possível ajustar a taxa de envio com base no número de itens no pedido.

#### Dashboard

Para adicionar um [tarifa de frete](https://dashboard.stripe.com/test/shipping-rates) usando o Dashboard:

1. Clique em **Criar tarifa de envio**.
1. Insira um valor, uma descrição e, opcionalmente, um prazo estimado de entrega.
1. Clique em **Salvar** e copie o ID da tarifa de envio (`shr_123456`).
![](https://b.stripecdn.com/docs-statics-srv/assets/create-shipping-rate-dashboard.ddd79821d5edee523d7da9d22682be59.png)

Insira os detalhes da tarifa de envio

### Atualizar uma tarifa de envio

Não é possível atualizar o valor de uma moeda que já foi definida em uma tarifa de envio. Depois de definir uma moeda e um valor em uma tarifa de envio, ela só pode ser atualizada para incluir novas moedas. Para atualizar uma tarifa de envio no Dashboard, você deve arquivar a tarifa de envio e criar uma nova.

### Arquivar uma taxa de envio

Para arquivar uma taxa de envio:

1. Na guia [Taxas de envio](https://dashboard.stripe.com/test/shipping-rates), selecione a taxa de envio aplicável.
1. Clique no menu de navegação ⋯ e selecione **Arquivar**.

Para desarquivar a taxa de envio, clique no menu de navegação ⋯ e selecione **Desarquivar taxa de envio**.

#### API

> #### Você tem interesse em atualizações dinâmicas das tarifas de envio?
> 
> O Checkout permite atualizar dinamicamente as tarifas de envio com base no endereço informado pelo cliente ou no valor do pedido. Consulte [Personalizar dinamicamente as opções de envio](https://docs.stripe.com/payments/checkout/custom-shipping-options.md) sobre esse recurso de prévia.

[Criar tarifa de envio](https://docs.stripe.com/api/shipping_rates.md), que, no mínimo, requer os parâmetros `type` e `display_name`. O exemplo de código a seguir usa esses dois parâmetros junto com `fixed_amount` e `delivery_estimate` para criar uma tarifa de envio:

```curl
curl https://api.stripe.com/v1/shipping_rates \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "display_name=Ground shipping" \
  -d type=fixed_amount \
  -d "fixed_amount[amount]=500" \
  -d "fixed_amount[currency]=usd" \
  -d "delivery_estimate[minimum][unit]=business_day" \
  -d "delivery_estimate[minimum][value]=5" \
  -d "delivery_estimate[maximum][unit]=business_day" \
  -d "delivery_estimate[maximum][value]=7"
```

### Atualizar uma tarifa de envio

Para [atualizar uma tarifa de envio](https://docs.stripe.com/api/shipping_rates/update.md), chame `Stripe::ShippingRate.update` e atualize os parâmetros conforme necessário.

## Criar uma Checkout Session [Lado do servidor]

Para criar uma sessão do Checkout que inclua sua taxa de envio, passe o ID da taxa de envio gerada para o parâmetro [shipping_options](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options). Se quiser criar a taxa de envio ao mesmo tempo que uma sessão do Checkout, use o parâmetro `shipping_rate_data` com `shipping_options`. Somente sessões do Checkout no [modo pagamento](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) aceitam opções de envio.

O exemplo de código a seguir adiciona duas opções de envio à sessão do Checkout:

- Frete grátis, com uma entrega estimada de 5 a 7 dias úteis.
- Transporte aéreo no dia seguinte, a um custo de US$ 15,00, com uma entrega estimada em exatamente 1 dia útil.

Neste exemplo, a primeira opção na matriz `shipping_options` é pré-selecionada para o cliente na página de checkout. No entanto, os clientes podem escolher qualquer uma das opções.

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "shipping_address_collection[allowed_countries][0]=US" \
  -d "shipping_address_collection[allowed_countries][1]=CA" \
  -d "shipping_options[0][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]=0" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[0][shipping_rate_data][display_name]=Free shipping" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]=5" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]=7" \
  -d "shipping_options[1][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][amount]=1500" \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[1][shipping_rate_data][display_name]=Next day air" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][value]=1" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][value]=1" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  --data-urlencode "success_url=https://example.com/success"
```

Se bem-sucedido, o seletor de envio aparece no seu fluxo de checkout:
![O seletor de envio no fluxo de checkout](https://b.stripecdn.com/docs-statics-srv/assets/example-checkout-session.5807984bdc0a25ddb53aab00768dd079.jpg)

O seletor de envio no fluxo de checkout

## Optional: Gerenciar transações concluídas

Após a conclusão do pagamento, você pode acessar o valor de frete no atributo [amount_total](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-amount_total) do [shipping_cost](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-shipping_cost). Você também pode recuperar a tarifa de envio selecionada usando o atributo `shipping_rate` em `shipping_cost`. Para acessar a propriedade `shipping_cost`, você deve [criar um gerenciador de eventos](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) para gerenciar sessões do Checkout concluídas. Você pode testar um gerenciador [instalando o Stripe CLI](https://docs.stripe.com/stripe-cli.md) e usando `stripe listen --forward-to localhost:4242/webhook` para [encaminhar eventos ao seu servidor local](https://docs.stripe.com/webhooks.md#test-webhook). No exemplo de código a seguir, o manipulador permite que o usuário acesse `shipping_property`:

#### Ruby

```ruby
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = "<<YOUR_SECRET_KEY>>"

require 'sinatra'

# You can find your endpoint's secret in your webhook settings
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)selected_shipping_rate = Stripe::ShippingRate.retrieve(checkout_session.shipping_cost.shipping_rate)
  shipping_total = checkout_session.shipping_cost.amount_total

  # TODO: Remove error and implement...
  raise NotImplementedError.new(<<~MSG)
    Given the Checkout Session "#{checkout_session.id}" load your internal order from the database then implement your own fulfillment logic.
  MSG
end
```

## Optional: Definir uma estimativa de entrega

É possível configurar tarifas de frete usando uma série de combinações de estimativa de entrega. A tabela a seguir contém alguns exemplos de estimativas de entrega em inglês simples e seus valores correspondentes para `delivery_estimate.minimum` e `delivery_estimate.maximum`:

| Estimativa de entrega  | Mínimo                                                       | Máximo                                                       |
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 1 dia                  | ```es6
  {
    unit: 'day',
    value: 1,
  }
  ```          | ```es6
  {
    unit: 'day',
    value: 1,
  }
  ```          |
| 1 dia útil             | ```es6
  {
    unit: 'business_day',
    value: 1,
  }
  ``` | ```es6
  {
    unit: 'business_day',
    value: 1,
  }
  ``` |
| No mínimo 2 dias úteis | ```es6
  {
    unit: 'business_day',
    value: 2,
  }
  ``` | ```es6
  null
  ```                                          |
| 3 a 7 dias             | ```es6
  {
    unit: 'day',
    value: 3,
  }
  ```          | ```es6
  {
    unit: 'day',
    value: 7,
  }
  ```          |
| 4 a 8 horas            | ```es6
  {
    unit: 'hour',
    value: 4,
  }
  ```         | ```es6
  {
    unit: 'hour',
    value: 8,
  }
  ```         |
| 4 horas a 2 dias úteis | ```es6
  {
    unit: 'hour',
    value: 4,
  }
  
  ```      | ```es6
  {
    unit: 'business_day',
    value: 2,
  }
  ``` |

## Optional: Cobrar o imposto da tarifa de envio

Use o [Stripe Tax](https://docs.stripe.com/tax/checkout.md) para calcular automaticamente o imposto sobre tarifas de envio, definindo um `tax_code` e `tax_behavior` na sua tarifa de envio. O Stripe Tax decide automaticamente se o envio é tributável ([a tributação depende do estado e do país](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#shipping-tax-code)) e aplica a alíquota correta, se houver.

Ao criar uma tarifa de envio com `shipping_rate_data` ou usando [Criar tarifa de envio](https://docs.stripe.com/api/shipping_rates/create.md), é possível adicionar os parâmetros `tax_behavior` e `tax_code` à tarifa de envio.

Recomendamos configurar `tax_code` como `Shipping` (`txcd_92010001`) para garantir a cobrança correta de impostos. Você também pode definir o `tax_code` da tarifa de envio como `Nontaxable` (`txcd_00000000`) se não quiser cobrar imposto.

Neste exemplo, definimos o `tax_behavior` como `exclusive`, o que é comum nos EUA. Saiba mais sobre [comportamento fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]=US" \
  -d "shipping_address_collection[allowed_countries][1]=CA" \
  -d "shipping_options[0][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]=0" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[0][shipping_rate_data][display_name]=Free shipping" \
  -d "shipping_options[0][shipping_rate_data][tax_behavior]=exclusive" \
  -d "shipping_options[0][shipping_rate_data][tax_code]=txcd_92010001" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]=5" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]=7" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][price_data][tax_behavior]=exclusive" \
  -d "line_items[0][quantity]=1" \
  -d "automatic_tax[enabled]=true" \
  -d mode=payment \
  --data-urlencode "success_url=https://example.com/success"
```

Seu cliente pode ver o valor calculado do imposto sobre a tarifa de envio incluído no total do imposto sobre vendas no fluxo de checkout:
![Valor do imposto calculado para a tarifa de envio na página de checkout](https://b.stripecdn.com/docs-statics-srv/assets/taxed-shipping.14e1bb580c37e035fcf2f0016680db5a.jpg)

Valor do imposto calculado para a tarifa de envio no fluxo de checkout


# Página integrada

> This is a Página integrada for when payment-ui is embedded-form. View the full page at https://docs.stripe.com/payments/during-payment/charge-shipping?payment-ui=embedded-form.

## Criar tarifa de envio [Dashboard] [Lado do servidor]

As tarifas de envio só aceitam valores fixos para todo o pedido. Não é possível ajustar a taxa de envio com base no número de itens no pedido.

#### Dashboard

Para adicionar um [tarifa de frete](https://dashboard.stripe.com/test/shipping-rates) usando o Dashboard:

1. Clique em **Criar tarifa de envio**.
1. Insira um valor, uma descrição e, opcionalmente, um prazo estimado de entrega.
1. Clique em **Salvar** e copie o ID da tarifa de envio (`shr_123456`).
![](https://b.stripecdn.com/docs-statics-srv/assets/create-shipping-rate-dashboard.ddd79821d5edee523d7da9d22682be59.png)

Insira os detalhes da tarifa de envio

### Atualizar uma tarifa de envio

Não é possível atualizar o valor de uma moeda que já foi definida em uma tarifa de envio. Depois de definir uma moeda e um valor em uma tarifa de envio, ela só pode ser atualizada para incluir novas moedas. Para atualizar uma tarifa de envio no Dashboard, você deve arquivar a tarifa de envio e criar uma nova.

### Arquivar uma taxa de envio

Para arquivar uma taxa de envio:

1. Na guia [Taxas de envio](https://dashboard.stripe.com/test/shipping-rates), selecione a taxa de envio aplicável.
1. Clique no menu de navegação ⋯ e selecione **Arquivar**.

Para desarquivar a taxa de envio, clique no menu de navegação ⋯ e selecione **Desarquivar taxa de envio**.

#### API

> #### Você tem interesse em atualizações dinâmicas das tarifas de envio?
> 
> O Checkout permite atualizar dinamicamente as tarifas de envio com base no endereço informado pelo cliente ou no valor do pedido. Consulte [Personalizar dinamicamente as opções de envio](https://docs.stripe.com/payments/checkout/custom-shipping-options.md) sobre esse recurso de prévia.

[Criar tarifa de envio](https://docs.stripe.com/api/shipping_rates.md), que, no mínimo, requer os parâmetros `type` e `display_name`. O exemplo de código a seguir usa esses dois parâmetros junto com `fixed_amount` e `delivery_estimate` para criar uma tarifa de envio:

```curl
curl https://api.stripe.com/v1/shipping_rates \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "display_name=Ground shipping" \
  -d type=fixed_amount \
  -d "fixed_amount[amount]=500" \
  -d "fixed_amount[currency]=usd" \
  -d "delivery_estimate[minimum][unit]=business_day" \
  -d "delivery_estimate[minimum][value]=5" \
  -d "delivery_estimate[maximum][unit]=business_day" \
  -d "delivery_estimate[maximum][value]=7"
```

### Atualizar uma tarifa de envio

Para [atualizar uma tarifa de envio](https://docs.stripe.com/api/shipping_rates/update.md), chame `Stripe::ShippingRate.update` e atualize os parâmetros conforme necessário.

## Criar uma Checkout Session [Lado do servidor]

Para criar uma sessão do Checkout que inclua sua taxa de envio, passe o ID da taxa de envio gerada para o parâmetro [shipping_options](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-shipping_options). Se quiser criar a taxa de envio ao mesmo tempo que uma sessão do Checkout, use o parâmetro `shipping_rate_data` com `shipping_options`. Somente sessões do Checkout no [modo pagamento](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-mode) aceitam opções de envio.

O exemplo de código a seguir adiciona duas opções de envio à sessão do Checkout:

- Frete grátis, com uma entrega estimada de 5 a 7 dias úteis.
- Transporte aéreo no dia seguinte, a um custo de US$ 15,00, com uma entrega estimada em exatamente 1 dia útil.

Neste exemplo, a primeira opção na matriz `shipping_options` é pré-selecionada para o cliente na página de checkout. No entanto, os clientes podem escolher qualquer uma das opções.

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]=US" \
  -d "shipping_address_collection[allowed_countries][1]=CA" \
  -d "shipping_options[0][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]=0" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[0][shipping_rate_data][display_name]=Free shipping" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]=5" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]=7" \
  -d "shipping_options[1][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][amount]=1500" \
  -d "shipping_options[1][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[1][shipping_rate_data][display_name]=Next day air" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][minimum][value]=1" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[1][shipping_rate_data][delivery_estimate][maximum][value]=1" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

Se bem-sucedido, o seletor de envio aparece no seu fluxo de checkout:
![O seletor de envio no fluxo de checkout](https://b.stripecdn.com/docs-statics-srv/assets/example-checkout-session.5807984bdc0a25ddb53aab00768dd079.jpg)

O seletor de envio no fluxo de checkout

## Optional: Gerenciar transações concluídas

Após a conclusão do pagamento, você pode acessar o valor de frete no atributo [amount_total](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-amount_total) do [shipping_cost](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-shipping_cost). Você também pode recuperar a tarifa de envio selecionada usando o atributo `shipping_rate` em `shipping_cost`. Para acessar a propriedade `shipping_cost`, você deve [criar um gerenciador de eventos](https://docs.stripe.com/checkout/fulfillment.md#create-payment-event-handler) para gerenciar sessões do Checkout concluídas. Você pode testar um gerenciador [instalando o Stripe CLI](https://docs.stripe.com/stripe-cli.md) e usando `stripe listen --forward-to localhost:4242/webhook` para [encaminhar eventos ao seu servidor local](https://docs.stripe.com/webhooks.md#test-webhook). No exemplo de código a seguir, o manipulador permite que o usuário acesse `shipping_property`:

#### Ruby

```ruby
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/apikeys
Stripe.api_key = "<<YOUR_SECRET_KEY>>"

require 'sinatra'

# You can find your endpoint's secret in your webhook settings
endpoint_secret = 'whsec_...'

post '/webhook' do
  event = nil

  # Verify webhook signature and extract the event
  # See https://stripe.com/docs/webhooks#verify-events for more information.
  begin
    sig_header = request.env['HTTP_STRIPE_SIGNATURE']
    payload = request.body.read
    event = Stripe::Webhook.construct_event(payload, sig_header, endpoint_secret)
  rescue JSON::ParserError => e
    # Invalid payload
    return status 400
  rescue Stripe::SignatureVerificationError => e
    # Invalid signature
    return status 400
  end

  if event['type'] == 'checkout.session.completed'
    checkout_session = event['data']['object']

    fulfill_order(checkout_session)
  end

  status 200
end

def fulfill_order(checkout_session)selected_shipping_rate = Stripe::ShippingRate.retrieve(checkout_session.shipping_cost.shipping_rate)
  shipping_total = checkout_session.shipping_cost.amount_total

  # TODO: Remove error and implement...
  raise NotImplementedError.new(<<~MSG)
    Given the Checkout Session "#{checkout_session.id}" load your internal order from the database then implement your own fulfillment logic.
  MSG
end
```

## Optional: Definir uma estimativa de entrega

É possível configurar tarifas de frete usando uma série de combinações de estimativa de entrega. A tabela a seguir contém alguns exemplos de estimativas de entrega em inglês simples e seus valores correspondentes para `delivery_estimate.minimum` e `delivery_estimate.maximum`:

| Estimativa de entrega  | Mínimo                                                       | Máximo                                                       |
| ---------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 1 dia                  | ```es6
  {
    unit: 'day',
    value: 1,
  }
  ```          | ```es6
  {
    unit: 'day',
    value: 1,
  }
  ```          |
| 1 dia útil             | ```es6
  {
    unit: 'business_day',
    value: 1,
  }
  ``` | ```es6
  {
    unit: 'business_day',
    value: 1,
  }
  ``` |
| No mínimo 2 dias úteis | ```es6
  {
    unit: 'business_day',
    value: 2,
  }
  ``` | ```es6
  null
  ```                                          |
| 3 a 7 dias             | ```es6
  {
    unit: 'day',
    value: 3,
  }
  ```          | ```es6
  {
    unit: 'day',
    value: 7,
  }
  ```          |
| 4 a 8 horas            | ```es6
  {
    unit: 'hour',
    value: 4,
  }
  ```         | ```es6
  {
    unit: 'hour',
    value: 8,
  }
  ```         |
| 4 horas a 2 dias úteis | ```es6
  {
    unit: 'hour',
    value: 4,
  }
  
  ```      | ```es6
  {
    unit: 'business_day',
    value: 2,
  }
  ``` |

## Optional: Cobrar o imposto da tarifa de envio

Use o [Stripe Tax](https://docs.stripe.com/tax/checkout.md) para calcular automaticamente o imposto sobre tarifas de envio, definindo um `tax_code` e `tax_behavior` na sua tarifa de envio. O Stripe Tax decide automaticamente se o envio é tributável ([a tributação depende do estado e do país](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#shipping-tax-code)) e aplica a alíquota correta, se houver.

Ao criar uma tarifa de envio com `shipping_rate_data` ou usando [Criar tarifa de envio](https://docs.stripe.com/api/shipping_rates/create.md), é possível adicionar os parâmetros `tax_behavior` e `tax_code` à tarifa de envio.

Recomendamos configurar `tax_code` como `Shipping` (`txcd_92010001`) para garantir a cobrança correta de impostos. Você também pode definir o `tax_code` da tarifa de envio como `Nontaxable` (`txcd_00000000`) se não quiser cobrar imposto.

Neste exemplo, definimos o `tax_behavior` como `exclusive`, o que é comum nos EUA. Saiba mais sobre [comportamento fiscal](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#tax-behavior).

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d billing_address_collection=required \
  -d "shipping_address_collection[allowed_countries][0]=US" \
  -d "shipping_address_collection[allowed_countries][1]=CA" \
  -d "shipping_options[0][shipping_rate_data][type]=fixed_amount" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][amount]=0" \
  -d "shipping_options[0][shipping_rate_data][fixed_amount][currency]=usd" \
  -d "shipping_options[0][shipping_rate_data][display_name]=Free shipping" \
  -d "shipping_options[0][shipping_rate_data][tax_behavior]=exclusive" \
  -d "shipping_options[0][shipping_rate_data][tax_code]=txcd_92010001" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][minimum][value]=5" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][unit]=business_day" \
  -d "shipping_options[0][shipping_rate_data][delivery_estimate][maximum][value]=7" \
  -d "line_items[0][price_data][currency]=usd" \
  -d "line_items[0][price_data][product_data][name]=T-shirt" \
  -d "line_items[0][price_data][unit_amount]=2000" \
  -d "line_items[0][price_data][tax_behavior]=exclusive" \
  -d "line_items[0][quantity]=1" \
  -d "automatic_tax[enabled]=true" \
  -d mode=payment \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

Seu cliente pode ver o valor calculado do imposto sobre a tarifa de envio incluído no total do imposto sobre vendas no fluxo de checkout:
![Valor do imposto calculado para a tarifa de envio na página de checkout](https://b.stripecdn.com/docs-statics-srv/assets/taxed-shipping.14e1bb580c37e035fcf2f0016680db5a.jpg)

Valor do imposto calculado para a tarifa de envio no fluxo de checkout