Guia de Integração

Frete

Integre o Frete em sua loja. O cálculo é feito de forma automática, permitindo uma experiência de compra mais rápida para seus clientes. O PagSeguro disponibiliza para sua loja três tipos de frete: por valor fixo, por peso ou frete adicional com valor fixo.
Saiba mais sobre os tipos de frete.

Formas de envio

Código Significado
1 Encomenda normal (PAC)
2 SEDEX
3 Tipo de frete não especificado

Se você selecionar a opção Frete por peso em suas preferências, ao passar uma das formas de envio na criação do fluxo de pagamento (shippingType = 1 ou 2) seu cliente poderá utilizar somente a forma de envio passada no shippingType durante a criação do fluxo de pagamento. Caso você não informe o shippingType (shippingType=3), seu cliente poderá optar entre as opções PAC e SEDEX.

Ao selecionar a opção Frete fixo ou Frete fixo com valor adicional em suas configurações, a forma de envio será apenas informativa durante o fluxo de pagamento.

Cálculo de frete

Para utilizar o cálculo de frete do PagSeguro, o tipo de frete selecionado na página de configurações de frete deve ser "frete por peso". Depois de configurado o tipo de frete, basta observar com atenção os pontos a seguir ao passar as informações dos itens em cada requisição de pagamento:

Somatório do peso dos itens:

  • Se os pesos dos itens não forem informados ou forem informados com valor zero, o valor do frete será zero.
  • O valor mínimo para o cálculo do frete nos Correios é 300g, se o somatório dos pesos dos itens for diferente de zero e menor que 300g, o frete será calculado utilizando o valor mínimo (300g).
  • O valor máximo que pode ser utilizado no cálculo do frete é 30Kg (30.000g), se o somatório do peso dos itens ultrapassar este valor, o frete não será calculado e será assumido o valor zero.

Somatório do valor dos itens: O valor máximo do somatório dos itens que pode ser utilizado no cálculo de frete é R$10.000,00, se este valor for ultrapassado o frete não será calculado e será assumido valor zero.

Conheça as 3 formas de integração

O frete pode ser integrado à sua loja usando Pagamento via HTML ou a API de Pagamentos (em formato HTTP ou XML). Veja abaixo alguns exemplos de integração:

1. Pagamento via HTML

Dados do endereço de entrega

Nos parâmetros abaixo, você pode passar o endereço para onde o produto será enviado. Isso torna o fluxo de pagamento no PagSeguro mais simples e rápido.

	<input type="hidden" name="shippingType" value="1">
	<input type="hidden" name="shippingAddressPostalCode" value="01452002">
	<input type="hidden" name="shippingAddressStreet" value="Av. Brig. Faria Lima">
	<input type="hidden" name="shippingAddressNumber" value="1384">
	<input type="hidden" name="shippingAddressComplement" value="5o andar">
	<input type="hidden" name="shippingAddressDistrict" value="Jardim Paulistano">
	<input type="hidden" name="shippingAddressCity" value="Sao Paulo">
	<input type="hidden" name="shippingAddressState" value="SP">
	<input type="hidden" name="shippingAddressCountry" value="BRA">

Além do endereço, você pode passar as informações relacionadas ao custo do frete, respeitando a modalidade de frete configurada no seu menu de preferências de frete. Caso as informações não sejam passadas o PagSeguro entende como frete grátis.
Veja como funciona:

Frete fixo e Adicional com valor fixo

Caso tenho configurado em sua conta um desses dois tipos de frete, basta adicionar junto às demais informações de cada item, o parâmetro abaixo. No caso de não haver frete, basta deixar o valor igual à Zero.

	<input type="hidden" name="itemShippingCost1" value="10.00">

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

Frete por peso

Ao optar por esta modalidade de frete, você deverá passar por parâmetro o peso de cada item. Caso não queira utilizar o frete, basta deixar o valor igual à Zero.

	<input type="hidden" name="itemWeight1" value="750">

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

2. API de Pagamentos - informando os dados em parâmetros HTTP

Dados do endereço de entrega

Nos parâmetros abaixo, você pode passar o endereço para onde o produto será enviado. Isso torna o fluxo de pagamento no PagSeguro mais simples e rápido.

&shippingAddressStreet=Av. Brig. Faria Lima
&shippingAddressNumber=1384
&shippingAddressComplement=5o andar
&shippingAddressDistrict=Jardim Paulistano
&shippingAddressPostalCode=01452002
&shippingAddressCity=Sao Paulo
&shippingAddressState=SP
&shippingAddressCountry=BRA

Além do endereço, você pode passar as informações relacionadas ao custo do frete, respeitando a modalidade de frete configurada no seu menu de preferências de frete. Caso as informações não sejam passadas o PagSeguro entende como frete grátis. Veja como funciona:

Frete fixo e Adicional com valor fixo

Caso tenho configurado em sua conta um desses dois tipos de frete, basta adicionar junto às demais informações de cada item, o parâmetro abaixo. No caso de não haver frete, basta deixar o valor igual à Zero.

&itemShippingCost1=10.00

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

Frete por peso

Ao optar por esta modalidade de frete, você deverá passar por parâmetro o peso de cada item. Caso não queira utilizar o frete, basta deixar o valor igual à Zero

&itemWeight1=1000

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

3. API de Pagamentos - informando os dados em formato XML

Dados do endereço de entrega

Nos parâmetros abaixo, você pode passar o endereço para onde o produto será enviado. Isso torna o fluxo de pagamento no PagSeguro mais simples e rápido.

	<shipping>
		<type>1</type>
		<address>
			<street>Av. Brig. Faria Lima</street>
			<number>1384</number>
			<complement>Notebook Rosa</complement>
			<district>Jardim Paulistano</district>
			<postalCode>01452002</postalCode>
			<city>Sao Paulo</city>
			<state>SP</state>
			<country>BRA</country>
		</address>
	</shipping>

Além do endereço, você pode passar as informações relacionadas ao custo do frete, respeitando a modalidade de frete configurada no seu menu de preferências de frete. Caso as informações não sejam passadas o PagSeguro entende como frete grátis. Veja como funciona:

Frete fixo e Adicional com valor fixo

Caso tenho configurado em sua conta um desses dois tipos de frete, basta adicionar junto às demais informações de cada item, o parâmetro abaixo. No caso de não haver frete, basta deixar o valor igual à Zero.

<shippingCost>10.00</shippingCost>

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

Frete por peso

Ao optar por esta modalidade de frete, você deverá passar por parâmetro o peso de cada item. Caso não queira utilizar o frete, basta deixar o valor igual à Zero.

<weight>1000</weight>

Ver detalhes de validações e obrigatoriedade do parâmetro no Guia de Integração

Atenção: Os valores de frete por peso calculados pelo PagSeguro são apenas uma estimativa obtida junto aos Correios e devem ser confirmados no ato da postagem.

Tem alguma sugestão ou dúvida? desenvolvedores@pagseguro.com.br.