Ir a contenido
Crea una cuenta o Inicia sesión
Logotipo de Stripe Docs
/
Crear una cuentaIniciar sesión
ResumenActualiza tu integración
Pagos electrónicos
ResumenEncuentra tu caso de usoUsar pagos administrados
Pagos en persona
Métodos de pago
Escenarios de pago
Más allá de los pagos

Cobra por el envío

Crea diferentes tasas de envío para tus clientes.

Las tarifas de envío te permiten mostrar varias opciones de envío, como estándar, exprés y al día siguiente, con estimaciones de entrega más precisas. Cobra a tu cliente por el envío con diferentes productos de Stripe. Antes de crear una tarifa de envío, aprende a recopilar las direcciones de pagos y de envío.

Crear una tarifa de envío
Dashboard
Lado del servidor

Las tarifas de envío solo admiten valores de monto fijo para todo el pedido. No puedes ajustar la tarifa de envío en función de la cantidad de artículos del pedido.

Para agregar una tarifa de envío usando el Dashboard:

  1. Haz clic en Crea una tarifa de envío.
  2. Introduce un importe, una descripción y una estimación de envío opcional.
  3. Haz clic en Guardar y copia el ID de la tarifa de envío (shr_123456).

Introduce los datos de la tarifa de envío

Actualiza una tarifa de envío

No puedes actualizar una tarifa de envío en el Dashboard. Para actualizar una tarifa de envío en el Dashboard, debes archivarla y luego crear una nueva.

Archiva una tarifa de envío

Para archivar una tarifa de envío:

  1. En la pestaña Tarifas de envío, selecciona la tarifa de envío aplicable.
  2. Haz clic en el menú de contenido adicional y selecciona Archivar.

Para desarchivar la tarifa de envío, haz clic en el menú de contenido adicional y selecciona Desarchivar tarifa de envío.

Crea una sesión de Checkout
Lado del servidor

Para crear una Checkout Session que incluya tu tarifa de envío, especifica el ID de la tarifa de envío generado en el parámetro shipping_options. Si quieres crear la tarifa de envío al mismo tiempo que una Checkout Session, usa el parámetro shipping_rate_data con shipping_options. Solo las Checkout Sessions en modo de pago admiten opciones de envío.

En el siguiente ejemplo de código se agregan dos opciones de envío a la Checkout Session:

  • Envío gratuito con entrega estimada de cinco a siete días hábiles.
  • Envío por Next Day Air, con un costo de USD 15.00 y una entrega estimada de un día hábil.

En este ejemplo, la primera opción de la matriz shipping_options se preselecciona para el cliente en la página de confirmación de compra. Sin embargo, los clientes pueden elegir cualquiera de las dos opciones.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Si se realiza correctamente, el selector de envíos aparece en tu flujo de compra:

El selector de envíos en el flujo de compra

El selector de envíos en el flujo de compra

OpcionalGestionar transacciones finalizadas

Una vez que el pago se efectúa correctamente, puedes recuperar el importe del envío en el atributo amount_total del shipping_cost. También puedes recuperar la tarifa de envío seleccionada usando el atributo shipping_rate en shipping_cost. Para acceder a la propiedad shipping_cost, debes crear un controlador de eventos para administrar las Checkout Sessions completadas. Puedes probar un controlador instalando la CLI de Stripe y usando stripe listen --forward-to localhost:4242/webhook para enviar eventos a tu servidor local. En el siguiente ejemplo de código, el controlador permite que el usuario acceda a shipping_property:

Ruby
Python
PHP
Java
Node.js
Ir
.NET
No results
# 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 = 
"sk_test_BQokikJOvBiI2HlWgH4olfQ2"


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

OpcionalDefinir una estimación de envío

Puedes configurar tarifas de envío mediante una serie de combinaciones de estimaciones de envío. La siguiente tabla contiene algunos ejemplos de estimaciones de envío en lenguaje sencillo y sus correspondientes valores delivery_estimate.minimum y delivery_estimate.maximum:

Estimación de envíoMínimoMáximo
1 día
{
  unit: 'day',
  value: 1,
}

{
  unit: 'day',
  value: 1,
}
1 día hábil
{
  unit: 'business_day',
  value: 1,
}

{
  unit: 'business_day',
  value: 1,
}
Al menos 2 días hábiles
{
  unit: 'business_day',
  value: 2,
}

null
3 a 7 días
{
  unit: 'day',
  value: 3,
}

{
  unit: 'day',
  value: 7,
}
4 a 8 horas
{
  unit: 'hour',
  value: 4,
}

{
  unit: 'hour',
  value: 8,
}
4 horas a 2 días hábiles
{
  unit: 'hour',
  value: 4,
}


{
  unit: 'business_day',
  value: 2,
}

OpcionalCobrar impuesto por envío

Puedes usar Stripe Tax para calcular automáticamente los impuestos sobre las comisiones de envío estableciendo tax_behavior y tax_code en la tarifa de envío. Stripe Tax determina automáticamente si el envío está sujeto a impuestos, (ya que esta condición varía según el estado y el país), y aplica la tasa impositiva correcta, si corresponde.

Cuando creas una tarifa de envío con shipping_rate_data o a través de Crear una tarifa de envío, puedes agregarle los parámetros tax_behavior y tax_code.

Te recomendamos configurar el tax_code en Shipping (txcd_92010001) para asegurarte de que siempre cobres el impuesto que corresponde. También puedes configurar la tarifa de envío tax_code en Nontaxable (txcd_00000000) si no quieres cobrar impuestos.

En este ejemplo, establecemos tax_behavior en exclusive, que es habitual en los EE. UU. Obtén más información sobre el comportamiento fiscal.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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"

Tu cliente puede ver el importe del impuesto calculado para la tarifa de envío incluido en el impuesto sobre las ventas total en tu flujo de compra:

Importe del impuesto calculado para la tarifa de envío en la página de confirmación de compra

Importe del impuesto calculado para la tarifa de envío en el flujo de compra

¿Te fue útil esta página?
SíNo