Documentação

Parcelamento sem acréscimo

Visão Geral

Com este complemento da API de Pagamentos você poderá definir, no momento da chamada para o PagSeguro, qual a quantidade de parcelas que você deseja oferecer sem acréscimo ao seu cliente.

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.

Integração

Para iniciar uma requisição de pagamento definindo a quantidade de parcelas sem acréscimo, você precisa fazer uma chamada à API de Pagamentos do PagSeguro informando os dados do pagamento e a quantidade de parcelas aceitas. 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.

Dados de parcelamento

Para definir o parcelamento você deverá utilizar três parâmetros: grupo, chave e valor. No parâmetro grupo você informará qual o meio pagamento que receberá as configurações. Para o parcelamento sem acréscimo você deve informar o meio de pagamento Cartão de crédito (CREDIT_CARD).

Após definir o grupo você deverá definir as configurações nos campos chave e valor. Estes devem ser definidos com a chave MAX_INSTALLMENTS_NO_INTEREST que define a configuração de parcelamento sem acréscimo e como valor o número de parcelas que você deseja assumir (de 2 a 18 parcelas).

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

Informando os dados em parâmetros HTTP

Veja abaixo um exemplo de como informar a quantidade de parcelas sem acréscimo para uma transação 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\
&paymentMethodGroup1=CREDIT_CARD\
&paymentMethodConfigKey1_1=MAX_INSTALLMENTS_NO_INTEREST\
&paymentMethodConfigValue1_1=6"

Informando os dados em parâmetros XML

Veja abaixo um exemplo de como informar a quantidade de parcelas sem acréscimo para uma transação via XML (linhas 35 à 47):

<?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>
    <paymentMethodConfigs>
        <paymentMethodConfig>
            <paymentMethod>
                <group>CREDIT_CARD</group>
            </paymentMethod>
            <configs>
                <config>
                    <key>MAX_INSTALLMENTS_NO_INTEREST</key>
                    <value>6</value>
                </config>
            </configs>
        </paymentMethodConfig>
    </paymentMethodConfigs>
</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 o parcelamento sem acréscimo. Veja abaixo um exemplo (Os dados estão marcados em amarelo):

$paymentRequest = new PagSeguroPaymentRequest();
[. . .]
$paymentRequest->addParameter('paymentMethodGroup1', 'CREDIT_CARD');
$paymentRequest->addParameter('paymentMethodConfigKey1_1', 'MAX_INSTALLMENTS_NO_INTEREST');
$paymentRequest->addParameter('paymentMethodConfigValue1_1', '6');