Timeout para checkout

Visão Geral

Com este complemento da API de Pagamentos você poderá definir, no momento da chamada para o PagSeguro, qual o tempo máximo que o checkout ficará disponível para o cliente antes deste ser invalidado.

Atenção: Esta documentação abordará informações e termos da API de Pagamentos do PagSeguro. Caso você ainda não conheça a API de Pagamentos, recomendamos a leitura da nossa documentação no link a seguir: https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-pagamentos.html.

Integração

Para iniciar uma requisição de pagamento definindo o timeout do checkout, você precisa fazer uma chamada à API de Pagamentos do PagSeguro informando o tempo que o checkout poderá permanecer ativo. Esta requisição cria um código identificador e, com este código, você pode direcionar o comprador para o site do PagSeguro, onde ele realizará o pagamento.

Definindo o tempo de expiração

Para definir o tempo de expiração do checkout você deverá utilizar o parâmetro timeout. Neste parâmetro você informará qual o tempo em minutos que o checkout permanecerá ativo, lembrando que o tempo mínimo é de 20 minutos.

Ao chamar a API de Pagamentos, você pode informar a parâmetro de timeout de duas formas diferentes: em parâmetros HTTP ou em formato XML.

Informando os dados em parâmetros HTTP

Veja abaixo um exemplo de como informar o tempo de expiração do checkout via parâmetros HTTP (Os dados estão marcados em amarelo):

Observação Para utilizar a Sandbox PagSeguro para realizar a homologação da sua requisição, utilize o endpoint: https://ws.sandbox.pagseguro.uol.com.br/v2/checkout/ ao invés de https://ws.pagseguro.uol.com.br/v2/checkout/

curl https://ws.pagseguro.uol.com.br/v2/checkout/ -d\
"email=suporte@lojamodelo.com.br\
&token=CAD9C79F4141DF222401CF940D6F0682\
&currency=BRL\
&itemId1=0001\
&itemDescription1=Produto PagSeguroI\
&itemAmount1=99999.99\
&itemQuantity1=1\
&itemWeight1=1000\
&reference=REF1234\
&senderName=Jose Comprador\
&senderAreaCode=99\
&senderPhone=99999999\
&senderEmail=comprador@uol.com.br\
&shippingType=1\
&shippingAddressStreet=Av. PagSeguro\
&shippingAddressNumber=9999\
&shippingAddressComplement=99o andar\
&shippingAddressDistrict=Jardim Internet\
&shippingAddressPostalCode=99999999\
&shippingAddressCity=Cidade Exemplo\
&shippingAddressState=SP\
&shippingAddressCountry=ATA\
&timeout=25"

Informando os dados em parâmetros XML

Veja abaixo um exemplo de como informar o tempo de expiração do checkout via XML (linha 35):

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<checkout>
    <currency>BRL</currency>
    <items>
        <item>
            <id>0001</id>
            <description>Produto PagSeguroI</description>
            <amount>99999.99</amount>
            <quantity>1</quantity>
            <weight>1000</weight>
        </item>
    </items>
    <reference>REF1234</reference>
    <sender>
        <name>José Comprador</name>
        <email>comprador@uol.com.br</email>
        <phone>
            <areaCode>99</areaCode>
            <number>99999999</number>
        </phone>
    </sender>
    <shipping>
        <type>1</type>
        <address>
            <street>Av. PagSeguro</street>
            <number>9999</number>
            <complement>99o andar</complement>
            <district>Jardim Internet</district>
            <postalCode>99999999</postalCode>
            <city>Cidade Exemplo</city>
            <state>SP</state>
            <country>ATA</country>
        </address>
    </shipping>
    <timeout>25</timeout>
</checkout>

Informando os dados utilizando a biblioteca

O Pagseguro possui bibliotecas que facilitam a integração e a utilização das funcionalidades que o oferecemos na forma de APIs.

Se você já possui uma integração utilizando a nossa biblioteca, você pode utilizar o método addParameter para adicionar a informação sobre o tempo de expiração do checkout. Veja abaixo um exemplo (Os dados estão marcados em amarelo):

$paymentRequest = new PagSeguroPaymentRequest();
[. . .]
$paymentRequest->addParameter('timeout', '25');