Checkout de Serviços

Visão Geral

Aprenda como definir o checkout do Pagseguro como um checkout de serviços no momento da chamada da API de Pagamentos, para caso você tenha que integrar um serviço que não possua um endereço de entrega.

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 checkout como serviço, você precisa fazer uma chamada à API de Pagamentos do PagSeguro informando o parâmetro shippingAddressRequired com false. Assim, os parâmetros de shipping com os dados de endereço do comprador não devem ser informados.

Atenção: Este modelo está disponível apenas para os checkout Padrão e Lightbox.

Ao chamar a API de Pagamentos, você pode informar o parâmetro de duas formas diferentes: em parâmetros HTTP ou em formato XML. Veja abaixo como utiliza-las.

Informando os dados em parâmetros HTTP

Para realizar uma chamada a API de Pagamentos do PagSeguro, basta enviar uma requisição HTTP para o seguinte endpoint: https://ws.pagseguro.uol.com.br/v2/checkout/, passando os demais parâmetros necessários.

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/

Veja abaixo um exemplo de como definir o checkout de serviços via parâmetros HTTP:

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\
&senderEmail=comprador@uol.com.br\
&shippingAddressRequired=false”

Informando os dados em parâmetros XML

Veja abaixo no link um exemplo de como definir o checkout de serviços via XML:

<?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>  
        <item>  
            <id>0002</id>  
            <description>Produto PagSeguroII</description>  
            <amount>99999.98</amount>  
            <quantity>2</quantity>  
            <weight>750</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>  
    <shippingAddressRequired>false</shippingAddressRequired>  
</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 as informações sobre a configuração de meios de pagamento. Veja abaixo um exemplo de inclusão do parâmetro shippingAddressRequired:

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