Pagseguro Checkout Transparente

Guia de Integração
Checkout Transparente
CHECKOUT TRANSPARENT E 2
Histórico de Versões
DATA DESCRIÇÃO
26/02/2013 Visão Geral
13/09/2013 Revisão
05/03/2014 Revisão
21/05/2014 Inclusão de informação sobre o getSenderHash
26/08/2014 Inclusão de informações sobre o getPaymentMethods
06/10/2014 Inclusão de informações sobre parcelamento sem juros
02/02/2015 Revisão da tabela de erros
20/08/2015 Inclusão do parâmetro amount no método getPaymentMethods
Copyright
Todos os direitos reservados. O UOL é uma marca comercial do UNIVERSO ONLINE S / A. O logotipo do
UOL é uma marca comercial do UNIVERSO ONLINE S / A. Outras marcas, nomes, logotipos e marcas são
de propriedade de seus respectivos proprietários.
As informações contidas neste documento pertencem ao UNIVERSO ONLINE S/A. Todos os direitos
reservados. UNIVERSO ONLINE S/A. - Av. Faria Lima, 1384, 6º andar, São Paulo / SP, CEP 01452-002,
Brasil.
O serviço PagSeguro não é, nem pretende ser comparável a serviços financeiros oferecidos por
instituições financeiras ou administradoras de cartões de crédito, consistindo apenas de uma forma de
facilitar e monitorar a execução das transações de comércio electrónico através da gestão de
pagamentos. Qualquer transação efetuada através do PagSeguro está sujeita e deve estar em
conformidade com as leis da República Federativa do Brasil.
Aconselhamos que você leia os termos e condições cuidadosamente.
Aviso Legal
O UOL não oferece garantias de qualquer tipo (expressas, implícitas ou estatutárias) com relação às
informações nele contidas. O UOL não assume nenhuma responsabilidade por perdas e danos (diretos
ou indiretos), causados por erros ou omissões, ou resultantes da utilização deste documento ou a
informação contida neste documento ou resultantes da aplicação ou uso do produto ou serviço aqui
descrito. O UOL reserva o direito de fazer qualquer tipo de alterações a quaisquer informações aqui
contidas sem aviso prévio.
VERSÃO 1.0.2
O PagSeguro provê todas as ferramentas necessárias para

que você efetue a sua integração de forma rápida e fácil.
Confira abaixo nossas ferramentas e canais:
Documentações
Acessando a área de documentações do PagSeguro você tem acesso a todas as APIs
disponíveis pelo PagSeguro.
Acesse: https://pagseguro.uol.com.br/v2/guia-de-integracao/visao-geral.html
Sandbox
Teste sua integração de pagamento sem alterar as transações reais.
Acesse: https://sandbox.pagseguro.uol.com.br/
Fórum
Participe da comunidade PagSeguro postando suas dúvidas e auxiliando outros
desenvolvedores em nosso fórum. Nossa equipe está sempre presente para lhe
auxiliar.
Acesse: http://forum.pagseguro.uol.com.br/
Módulos
Desenvolvemos módulos para que você possa integrar o PagSeguro em diversas
plataformas de e-commerce com ainda mais facilidade.
Acesse: https://pagseguro.uol.com.br/v2/guia-de-integracao/downloads.html
Bibliotecas
Disponibilizamos bibliotecas em várias linguagens e tutoriais para que você possa
integrar o PagSeguro com em sua loja virtual, site ou blog.
Acesse: https://pagseguro.uol.com.br/v2/guia-de-integracao/downloads.html
VERSÃO 1.0.2
Índice
Histórico de Versões ............................................................................................................ 2
Copyright ............................................................................................................................ 2
Aviso Legal .......................................................................................................................... 2
Visão Geral.......................................................................................................................... 5
Integração ………………………………………………………………………………………………………………………………..5
Iniciando uma sessão de pagamento .................................................................................... 5
Integrações no browser ....................................................................................................... 6
Obter identificação do comprador................................................................................ 6
Obter os meios de pagamento...................................................................................... 7
Obter bandeira do cartão de crédito ............................................................................. 9
Obter token do cartão de crédito ................................................................................10
Obter opções de parcelamento ...................................................................................11
API do Checkout Transparente………………………………………………………………………………………………..12
Exemplo de chamada para Boleto........................................................................................13
Exemplo de chamada para Débito .......................................................................................14
Exemplo de chamada para Cartão de Crédito .......................................................................15
Retorno da API do Checkout Transparente……………………………………………………………………………..16
Listagem de Parâmetros………………………………………………………………………………………………………….17
Autenticação ......................................................................................................................17
Parâmetros da API do Checkout Transparente......................................................................18
Parâmetros de retorno da API do Checkout Transparente .....................................................28
Tabela de Erros……………………………………………………………………………………………………………………….39
Anexos……………………………………………………………………………………………………………………………………45
Exemplo de chamada para Boleto........................................................................................45
Exemplo de chamada para Débito .......................................................................................47
Exemplo de chamada para Cartão de Crédito .......................................................................48
VERSÃO 1.0.2
Visão Geral
A API do Checkout Transparente oferece maior controle e flexibilidade sobre o processo de pagamento. Com
essa integração o cliente fica no ambiente do seu e-commerce ou site durante todo o processo de compra,
sem necessidade de cadastro ou páginas intermediárias de pagamento. Com ele é possível disponibilizar em
seu site os meios de pagamento Cartão de Crédito, Débito Online e Boleto.
O Checkout Transparente está disponível para contas do tipo Vendedor e Empresarial.

As seções seguintes indicarão como é possível integrar seu sistema de pagamentos ao Checkout
Transparente do PagSeguro.
O Checkout Transparente pode ser utilizado em ambiente Sandbox. Para utilizar o

ambiente de testes basta adicionar o prefixo sandbox nas URLs. Durante a
documentação, os prefixos serão apresentados em vermelho.
Atenção: A biblioteca Java do PagSeguro já possui suporte ao Checkout Transparente.

Para saber mais sobre esta biblioteca acesse: https://pagseguro.uol.com.br/v2/guia-de-
integracao/tutorial-da-biblioteca-pagseguro-em-java.html
Integração
Para fazer a integração do Checkout Transparente, você precisa seguir os seguintes passos:
Iniciar uma sessão de pagamento (Todos os meios de pagamento)

Obter os meios de pagamento (Todos os meios de pagamento)
Obter a bandeira do cartão de crédito (Apenas para Cartão de Crédito)
Obter o token do cartão de crédito (Apenas para Cartão de Crédito)
Verificar as opções de parcelamento (Apenas para Cartão de Crédito)
Obter a identificação do comprador (Todos os meios de pagamento)
Efetuar o pagamento utilizando a API do Checkout Transparente (Todos os meios de pagamento)
Iniciando uma sessão de pagamento

Para iniciar um Checkout Transparente é necessário ter um ID de sessão válido. Este serviço retorna o ID de
sessão que será usado nas chamadas JavaScript. A chamada deve ser efetuada para a URL abaixo utilizando o
método POST.
URL:
POST https://ws.sandbox.pagseguro.uol.com.br/v2/sessions
Exemplo:
curl https://ws.sandbox.pagseguro.uol.com.br/v2/sessions/ -d\
"[email protected]\
&token=95112EE828D94278BD394E91C4388F20\
VERSÃO 1.0.2
Retorno:
1. <?xml version="1.0" encoding="ISO-8859-1"?>

2. <session>
3. <id>620f99e348c24f07877c927b353e49d3</id>
4. </session>
Integrações no browser
A API do Checkout Transparente possui funções JavaScript para algumas operações que deve m ser
executadas no browser do cliente, funções que serão descritas mais adiante. Para essas funções uma API
JavaScript deve ser importada no final da página dos meios de pagamento:
<script type="text/javascript" src=

"https://stc.sandbox.pagseguro.uol.com.br/pagseguro/api/v2/checkout/pagseguro.directpayment.js "></
script>
Esse JavaScript possui um objeto chamado PagSeguroDirectPayment, que é a interface de acesso aos
métodos. Após importar o arquivo, deve ser executado o método setSessionId com o ID de sessão gerado
anteriormente.
<script type="text/javascript">
PagSeguroDirectPayment.setSessionId('ID_DA_SESSÃO');
</script>
Nas funções abaixo os eventos de sucesso e erro ocorrem em chamadas callback no JavaScript que são
passadas via JSON.
Para isso basta passar três funções JavaScript com nome ‘success’, ‘error’ e ‘complete’ via JSON na chamada
dos métodos. A função ‘complete’ será chamada independente do retorno e as funções ‘success’ e ‘error’
serão chamadas dependendo do retorno, ou seja, se o retorno não possuir erro a função chamada será a
‘success’ e se possuir erro a função chamada será a ‘error’.
Obter identificação do comprador

Para realizar o Checkout Transparente é necessário enviar um identifilcador do comprador gerado pelo
JavaScript. Para isso você deve utilizar o método getSenderHash. Este método não possui parâmetros e
retorna um identificador. O identificador é obrigatório para todos os meios de pagamento.
Sintaxe:
PagSeguroDirectPayment.getSenderHash();
Atenção: Este método possui algumas dependências e, por isso, recomendamos que o
getSenderHash não seja executado no onLoad da página. Você pode executa-lo, por
exemplo quando o cliente clicar no botão de conclusão de pagamento.
VERSÃO 1.0.2
Obter os meios de pagamento

Nesse processo você pode obter todos os meios de pagamento disponíveis em sua conta para exibição no
checkout. Para isso você deverá utilizar o método getPaymentMethods. Esse método recebe opcionalmente
o valor da transação e retorna um JSON que contém os meios de pagamentos disponíveis no PagSeguro,
compatíveis com o valor informado. Caso não seja informado o valor, será retornado todos os meios de
pagamento. O JSON possui informações como o nome utilizado na API, nome de exibição, status
(Disponibilidade) e também o caminho para as imagens do meio de pagamento.
Veja abaixo um JSON de exemplo (o JSON foi reduzida para melhor visualização):
Sintaxe:
1. PagSeguroDirectPayment.getPaymentMethods({
2. amount: {valor da transação}
3. success: {função de callback para chamadas bem sucedidas},
4. error: {função de callback para chamadas que falharam},
5. complete: {função de callback para todas chamadas}
6. });
Exemplo:
1. PagSeguroDirectPayment.getPaymentMethods({
2. amount: 500.00
3. success: function(response) {
4. //meios de pagamento disponíveis
5. },
6. error: function(response) {
7. //tratamento do erro
8. },
9. complete: function(response) {
10. //tratamento comum para todas chamadas
11. }
12. });
Retorno
1. {
2. "error":false,
3. "paymentMethods":{
4. "BOLETO":{
5. "name":"BOLETO",
6. "options":{
7. "BOLETO":{
8. "name":"BOLETO",
9. "displayName":"Boleto",
10. "status":"AVAILABLE",
11. "code":202,
12. "images":{
13. "SMALL":{
14. "size":"SMALL",
15. "path":"/public/img/payment-methods-flags/42x20/booklet.png"
16. },
VERSÃO 1.0.2
17. "MEDIUM":{
18. "size":"MEDIUM",
19. "path":"/public/img/payment-methods-flags/68x30/booklet.png"
20. }
21. }
22. }
23. },
24. "code":2
25. },
26. "ONLINE_DEBIT":{
27. "name":"ONLINE_DEBIT",
28. "options":{
29. "BANCO_BRASIL":{
30. "name":"BANCO_BRASIL",
31. "displayName":"Banco do Brasil",
33. "code":304,
34. "images":{
35. "SMALL":{
36. "size":"SMALL",
37. "path":"/public/img/payment-methods-flags/42x20/bb.png"
38. },
39. "MEDIUM":{
41. "path":"/public/img/payment-methods-flags/68x30/bb.png"
42. }
43. }
44. },
45. },
46. "code":3
47. },
48. "CREDIT_CARD":{
49. "name":"CREDIT_CARD",
50. "options":{
51. "MASTERCARD":{
52. "name":"MASTERCARD",
53. "displayName":"MasterCard",
55. "code":102,
56. "images":{
57. "SMALL":{
58. "size":"SMALL",
59. "path":"/public/img/payment-methods-flags/42x20/mastercard.png"
60. },
61. "MEDIUM":{
63. "path":"/public/img/payment-methods-flags/68x30/mastercard.png"
64. }
65. }
66. },
67. },
68. "code":1
69. }
70. }}
As imagens são disponibilizadas em dois tamanhos: 42x20 e 68x30 e podem ser obtidas através dos
caminhos apresentados no JSON, bastando incluir a URL https://stc.pagseguro.uol.com.br.
Veja abaixo dois exemplos de imagens e suas URLs:
Imagem Pequena
https://stc.pagseguro.uol.com.br/public/img/payment-methods-flags/42x20/visa.png
Imagem Grande
https://stc.pagseguro.uol.com.br/public/img/payment-methods-flags/68x30/visa.png
VERSÃO 1.0.2
Obter bandeira do cartão de crédito

Esse processo é necessário somente para o meio de pagamento cartão de crédito. O método getBrand é
utilizado para verificar qual a bandeira do cartão que está sendo digitado. Esse método recebe por
parâmetro o BIN do cartão (seis primeiros dígitos do cartão) e retorna dados como qual a bandeira, o
tamanho do CVV, se possui data de expiração e qual algoritmo de validação. A chamada desse serviço não é
obrigatória.
Sintaxe:
71. PagSeguroDirectPayment.getBrand({
72. cardBin: {BIN do número do cartão},
76. });
Exemplo:
1. PagSeguroDirectPayment.getBrand({
2. cardBin: $("input#cartao").val(),
4. //bandeira encontrada
5. },
8. },
11. }
12. });
Retorno:
1. {
2. "brand":{
3. "name":"visa",
4. "bin":411111,
5. "cvvSize":3,
6. "expirable":true,
7. "validationAlgorithm":"LUHN"
8. }
9. }
VERSÃO 1.0.2
Obter token do cartão de crédito

Esse processo é necessário somente para o meio de pagamento cartão de crédito. O método
createCardToken é utilizado para gerar o token que representará o cartão de crédito na chamada para a API
do Checkout Transparente. Este método recebe os seguintes dados: número do cartão (obrigatório), CVV
(opcional para alguns cartões), data de expiração (opcional para alguns cartões) e a bandeira (obrigatório).
Sintaxe:
1. PagSeguroDirectPayment.createCardToken({
2. cardNumber: {número},
3. brand: {bandeira},
4. cvv: {código de segurança},
5. expirationMonth: {mês de expiração},
6. expirationYear: {ano de expiração},
10. });
Exemplo:
1. var param = {
2. cardNumber: $("input#cartao").val(),
3. cvv: $("input#cvv").val(),
4. expirationMonth: $("input#validadeMes").val(),
5. expirationYear: $("input#validadeAno").val(),
7. //token gerado, esse deve ser usado na chamada da API do Checkout Transparente
8. },
11. },
14. }
15. }
16.
17. //parâmetro opcional para qualquer chamada
18. if($("input#bandeira").val() != '') {
19. param.brand = $("input#bandeira").val();
20. }
21.
22. PagSeguroDirectPayment.createCardToken(param);
VERSÃO 1.0.2
Retorno:
1. {
2. "card":{
3. "token":"653fe9044cf149f9b7db562431cb130d"
4. }
5. }
Obter opções de parcelamento

Esse processo é necessário apenas para o meio de pagamento cartão de crédito. Caso queira mostrar as
opções de parcelamento para o comprador, você deverá utilizar o método getInstallments. Esse método
recebe o valor a ser parcelado (obrigatório), a quantidade de parcelas sem juros e a bandeira que se deseja
obter o parcelamento, retornando as configurações de cada parcela sendo: valor total do pagamento (que
deve ser enviado junto na API do Checkout Transparente), valor e quantidade da parcela (que também
devem ser informados na API do Checkout Transparente) e um indicador se aquela parcela tem juros ou não
(caso o vendedor tenha configurado uma promoção no PagSeguro).
Se não for informado uma bandeira como parâmetro na chamada, o método retornará os dados para todas
bandeiras aceitas pelo PagSeguro.
Sintaxe:
1. PagSeguroDirectPayment.getInstallments({
2. amount: {valor do pagamento},
3. maxInstallmentNoInterest: {quantidade de parcelas sem juros},
4. brand: {bandeira do cartão},
8. });
Exemplo:
1. PagSeguroDirectPayment.getInstallments({
2. amount: $("input#valorPagto").val(),
3. brand: $("input#bandeira").val(),
4. maxInstallmentNoInterest: 2,
6. //opções de parcelamento disponível
7. },
10. },
13. }
14. });
VERSÃO 1.0.2
Retorno:
1. {
2. "error":false,
3. "installments":{
4. "visa":[
5. {
6. "quantity":1,
7. "totalAmount":16,
8. "installmentAmount":16,
9. "interestFree":true
10. },{
11. "quantity":2,
12. "totalAmount":16.48,
13. "installmentAmount":8.24,
14. "interestFree":false
15. }
16. ]
17. }
18. }
API do Checkout Transparente

Após obter os dados de pagamento você deve efetuar a chamada para o serviço do checkout transparente
enviando os dados do comprador e do pagamento para realizar a cobrança. A chamada deve ser efetuada
utilizando o método POST.
URL:
POST https://ws.sandbox.pagseguro.uol.com.br/v2/transactions
O cabeçalho Content-Type deve ser informado como no exemplo abaixo:

Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1
Observação: caso sua aplicação ou loja não utilize o conjunto de caracteres ISO-8859-1, p.e.(UTF-8), é
necessário substituir o parâmetro charset do exemplo acima.
Cada pagamento pode conter um ou mais itens. Cada item representa um produto ou qualquer outro bem
que está sendo comprado. Os parâmetros associados a itens têm seu nome terminando em um número.
Por exemplo: os parâmetros itemId1, itemDescription1, itemAmount1 e itemQuantity1 referem-se ao

primeiro item do pagamento, enquanto que os parâmetros itemId2, itemDescription2, itemAmount2 e
itemQuantity2 referem-se ao segundo item do pagamento.
Abaixo apresentamos um exemplo dos parâmetros da chamada via http para cada um dos meios de
pagamento. Os exemplos em XML serão apresentados no final da documentação devido ao tamanho dos
XMLs.
VERSÃO 1.0.2
Exemplo de chamada para Boleto
curl https://ws.sandbox.pagseguro.uol.com.br/v2/transactions/ -d\

"[email protected]\
&token=95112EE828D94278BD394E91C4388F20\
&paymentMode=default\
&paymentMethod=boleto\
&[email protected]\
&currency=BRL\
&extraAmount=1.00
&itemId1=0001\
&itemDescription1=Notebook Prata\
&itemAmount1=24300.00\
&itemQuantity1=1\
&notificationURL=https://sualoja.com.br/notifica.html \
&reference=REF1234\
&senderName=Jose Comprador\
&senderCPF=22111944785\
&senderAreaCode=11\
&senderPhone=56273440\
&[email protected]\
&senderHash=abc123\
&shippingAddressStreet=Av. Brig. Faria Lima\
&shippingAddressNumber=1384\
&shippingAddressComplement=5o andar\
&shippingAddressDistrict=Jardim Paulistano\
&shippingAddressPostalCode=01452002\
&shippingAddressCity=Sao Paulo\
&shippingAddressState=SP\
&shippingAddressCountry=BRA
&shippingType=1
&shippingCost=1.00"
Os parâmetros em XML desta chamada estão disponíveis no anexo desta documentação e devem conter o
cabeçalho Content-Type como o exemplo abaixo:
Content-Type: application/xml; charset=ISO-8859-1
Observação: caso sua aplicação ou loja não utilize o conjunto de caracteres ISO-8859-1, p.e.(UTF-8), é
necessário substituir o parâmetro charset do exemplo acima.
VERSÃO 1.0.2
Exemplo de chamada para Débito

"[email protected]\
&token=95112EE828D94278BD394E91C4388F20\
&paymentMethod=eft\
&bankName=itau\
&[email protected]\
&currency=BRL\
&extraAmount=1.00
&itemId1=0001\
&itemQuantity1=1\
&reference=REF1234\
&senderCPF=22111944785\
&senderAreaCode=11\
&[email protected]\
&senderHash=abc123\
&shippingType=1
&shippingCost=1.00"
Os parâmetros em XML desta chamada estão disponíveis no anexo desta documentação.
VERSÃO 1.0.2
Exemplo de chamada para Cartão de Crédito

"[email protected]\
&token=95112EE828D94278BD394E91C4388F20\
&paymentMethod=creditCard\
&[email protected]\
&currency=BRL\
&extraAmount=1.00
&itemId1=0001\
&itemQuantity1=1\
&reference=REF1234\
&senderCPF=22111944785\
&senderAreaCode=11\
&[email protected]\
&senderHash=abc123\
&shippingType=1
&shippingCost=1.00
&creditCardToken=4as56d4a56d456as456dsa\
&installmentQuantity=5\
&installmentValue=125.22\
&noInterestInstallmentQuantity=2\
&creditCardHolderName=Jose Comprador\
&creditCardHolderCPF=22111944785\
&creditCardHolderBirthDate=27/10/1987\
&creditCardHolderAreaCode=11\
&creditCardHolderPhone=56273440
&billingAddressStreet=Av. Brig. Faria Lima\
&billingAddressNumber=1384\
&billingAddressComplement=5o andar\
&billingAddressDistrict=Jardim Paulistano\
&billingAddressPostalCode=01452002\
&billingAddressCity=Sao Paulo\
&billingAddressState=SP\
&billingAddressCountry=BRA\"
Os parâmetros em XML desta chamada estão disponíveis no anexo desta documentação.
VERSÃO 1.0.2
Retorno da API do Checkout Transparente

Após a chamada para a API do Checkout Transparente, é retornado um XML com todos os dados da
transação conforme o exemplo abaixo:
1. <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>

2. <transaction>
3. <date>2011-02-05T15:46:12.000-02:00</date>
4. <lastEventDate>2011-02-15T17:39:14.000-03:00</lastEventDate>
5. <code>9E884542-81B3-4419-9A75-BCC6FB495EF1</code>
6. <reference>REF1234</reference>
7. <type>1</type>
8. <status>3</status>
9. <paymentMethod>
10. <type>1</type>
11. <code>101</code>
12. </paymentMethod>
13. <paymentLink>
14. https://pagseguro.uol.com.br/checkout/imprimeBoleto.jhtml?code=314601B208B24A5CA53260000F7BB0D
15. </paymentLink>
16. <grossAmount>49900.00</grossAmount>
17. <discountAmount>0.00</discountAmount>
18. <feeAmount>0.00</feeAmount>
19. <netAmount>49900.50</netAmount>
20. <extraAmount>0.00</extraAmount>
21. <installmentCount>1</installmentCount>
22. <itemCount>2</itemCount>
23. <items>
24. <item>
25. <id>0001</id>
26. <description>Notebook Prata</description>
27. <quantity>1</quantity>
28. <amount>24300.00</amount>
29. </item>
30. <item>
31. <id>0002</id>
32. <description>Notebook Rosa</description>
35. </item>
36. </items>
37. <sender>
38. <name>José Comprador</name>
39. <email>[email protected]</email>
40. <phone>
41. <areaCode>11</areaCode>
42. <number>56273440</number>
43. </phone>
44. </sender>
45. <shipping>
46. <address>
47. <street>Av. Brig. Faria Lima</street>
49. <complement>5o andar</complement>
50. <district>Jardim Paulistano</district>
51. <postalCode>01452002</postalCode>
VERSÃO 1.0.2
52. <city>Sao Paulo</city>

53. <state>SP</state>
54. <country>BRA</country>
55. </address>
56. <type>1</type>
57. <cost>21.50</cost>
58. </shipping>
59. </transaction>
Caso ocorra algum erro na chamada por erro nos parâmetros informados um XML de erro será retornado.
Ele indicará os erros identificados na chamada. Veja o exemplo abaixo:
1. <errors>
2. <error>
3. <code>53031</code>
4. <message>shipping address city is required.</message>
5. </error>
6. </errors>
No exemplo acima a chamada foi efetuada com um valor inválido para o parâmetro preApprovalFinalDate.
Os parâmetros deste retorno estão descritos na listagem de parâmetros.
Para os meios Boleto e Débito, o XML possui o item paymentLink que retorna um link acesso,
respectivamente, a imagem do boleto e para a página de pagamento do banco selecionado.
Atenção: A página do banco não deve ser aberta em um IFrame.
Listagem de Parâmetros
Veja abaixo a listagem completa de todos os parâmetros. Todos os parâmetros são Case sensitive:
Autenticação
PARÂMETRO DESCRIÇÃO
Especifica o e-mail associado à conta PagSeguro que está realizando a requisição.

Presença: Obrigatória.
email Tipo: Texto.
Formato: Um e-mail válido associado a uma conta PagSeguro do tipo Vendedor ou
Empresarial.
Especifica o token correspondente à conta PagSeguro que está realizando a

requisição.
token Presença: Obrigatória.
Tipo: Texto.
Formato: Uma sequência de 32 caracteres.
VERSÃO 1.0.2
Parâmetros da API do Checkout Transparente

Parâmetro HTTP: Especifica o e-mail que deve vai receber o pagamento

receiverEmail
Presença: Opcional.
Tipo: Texto.
Elemento XML:
Formato: Um e-mail válido, com limite de 60 caracteres. O e-mail informado
<payment>
deve estar vinculado à conta PagSeguro que está realizando a chamada à
<receiver>
API.
<e mai l >
Parâmetro HTTP: URL para envio de notificações.

notificationURL
Presença: Opcional
Elemento XML: Tipo: Texto
<payment> Formato: Uma URL válida, com limite de 255 caracteres.
<noti fi cati onURL
Parâmetro HTTP: Moeda utilizada.

currency
Indica a moeda na qual o pagamento será feito. No momento, a única opção
disponível é BRL (Real).
Elemento XML:
<payment> Presença: Obrigatória.
<curre ncy> Tipo: Texto.
Formato: Somente o valor BRL é aceito.
Parâmetro HTTP: Meio de pagamento

paymentMethod
Elemento XML: Tipo: Texto.
<payment> Formato: creditCard, boleto ou eft.
<me thod>
Parâmetro HTTP: Modo do pagamento

paymentMode
Presença: Obrigatório.
<payment> Formato: aceita a opção default.
<mode >
Parâmetro HTTP: Identificadores dos itens.

itemId1, itemId2, etc.
Identificam os itens sendo pagos. Você pode escolher códigos que tenham
significado para seu sistema e informá-los nestes parâmetros. O PagSeguro
Elemento XML:
não realiza qualquer validação sobre esses identificadores, mas eles não
<checkout>
podem se repetir em um mesmo pagamento.
<items>
<item> Presença: Obrigatória.
<i d> Tipo: Texto.
Formato: Livre, com limite de 100 caracteres.
VERSÃO 1.0.2
Parâmetro HTTP: Descrições dos itens.

itemDescription1,
Descrevem os itens sendo pagos. A descrição é o texto que o PagSeguro
itemDescription2, etc.
mostra associado a cada item quando o comprador está finalizando o
pagamento, portanto é importante que ela seja clara e explicativa.
Elemento XML:
<payment> Presença: Obrigatória.
<items> Tipo: Texto.
<item> Formato: Livre, com limite de 100 caracteres.
<de scri pti on>
Parâmetro HTTP: Valores unitários dos itens.

itemAmount1, itemAmount2,
Representam os preços unitários de cada item sendo pago. Além de poder
etc.
conter vários itens, o pagamento também pode conter várias unidades do
mesmo item. Este parâmetro representa o valor de uma unidade do item,
Elemento XML:
que será multiplicado pela quantidade para obter o valor total dentro do
<checkout>
<items> pagamento.
<amount> Tipo: Número.
Formato: Decimal, com duas casas decimais separadas por ponto (p.e.,
1234.56), maior que 0.00 e menor ou igual a 9999999.00.
Parâmetro HTTP: Quantidades dos itens.

itemQuantity1,
Representam as quantidades de cada item sendo pago. Além de poder
itemQuantity2, etc.
conter vários itens, o pagamento também pode conter várias unidades do
mesmo item. Este parâmetro representa a quantidade de um item, que será
Elemento XML:
multiplicado pelo valor unitário para obter o valor total dentro do
<payment>
<items> pagamento.
<quanti ty> Tipo: Número.
Formato: Um número inteiro maior ou igual a 1 e menor ou igual a 999.
Parâmetro HTTP: Código de referência.

reference
Define um código para fazer referência ao pagamento. Este código fica
associado à transação criada pelo pagamento e é útil para vincular as
Elemento XML:
transações do PagSeguro às vendas registradas no seu sistema.
<payment>
<re fe re nce > Presença: Opcional.
Tipo: Texto.
Formato: Livre, com o limite de 200 caracteres.
Parâmetro HTTP: Valores extras a serem cobrados

extraAmount
Elemento XML: Tipo: Número.
<payment> Formato: Decimal, com duas casas decimais separadas por ponto (p.e.,
<e xtraAmount> 1234.56), maior que 0.00 e menor ou igual a 9999999.00.
VERSÃO 1.0.2
Elemento XML:
<payment> Dados do comprador.
<se nde r>
Parâmetro HTTP: E-mail do comprador.

senderEmail
Especifica o e-mail do comprador que está realizando o pagamento.
Elemento XML: Presença: Obrigatório.
<payment> Tipo: Texto.
<sender> Formato: um e-mail válido (p.e., [email protected]), com no máximo 60
<e mai l > caracteres.
Parâmetro HTTP: Nome completo do comprador.

senderName
Especifica o nome completo do comprador que está realizando o
pagamento.
Elemento XML:
<payment>
<sender>
<name > Presença: Obrigatório.
Tipo: Texto.
Formato: No mínimo duas sequências de caracteres, com o limite total de 50
caracteres.
Elemento XML:
<payment>
Lista de documentos do comprador.
<sender>
<docume nts>
Elemento XML:
<payment>
<sender> Representa um documento do comprador.
<documents>
<docume nt>
Elemento XML: Tipo de documento do comprador.

<payment>
Especifica o tipo de documento do comprador que está realizando o
<sender>
pagamento. Este campo é opcional e você pode enviá-lo caso já tenha
<documents>
capturado os dados do comprador em seu sistema e queira evitar que ele
<document>
preencha esses dados novamente no PagSeguro.
<type >
Tipo: Texto.
Formato: Case sensitive. Os valores CPF e CNPJ são aceitos.
VERSÃO 1.0.2
Parâmetro HTTP: CPF do comprador

senderCPF
<payment> Formato: Número.
<sender>
<documents>
<document>
<val ue >
Parâmetro HTTP: CNPJ do comprador

senderCNPJ
<payment> Formato: Número.
<sender>
<documents>
<document>
<val ue >
Parâmetro HTTP: DDD do comprador.

senderAreaCode
Especifica o código de área (DDD) do comprador que está realizando o
Elemento XML: pagamento.
<payment> Presença: Obrigatório.
<sender> Tipo: Número.
<phone> Formato: Um número de 2 dígitos correspondente a um DDD válido.
<are aCode >
Parâmetro HTTP: Número do telefone do comprador.

senderPhone
Especifica o número do telefone do comprador que está realizando o
Elemento XML: pagamento
<payment> Presença: Obrigatório.
<sender> Tipo: Número.
<phone> Formato: Um número de 7 a 9 dígitos.
<numbe r>
Parâmetro HTTP: Identificador do vendedor.

senderHash
Identificador do vendedor (fingerprint) gerado pelo JavaScript do PagSeguro
<sender> Formato: Obtido a partir de uma chamada javascript
<hash> PagseguroDirectPayment.getSenderHash()
Elemento XML:
<payment> Dados da Entrega
<shi ppi ng>
VERSÃO 1.0.2
Parâmetro HTTP: Forma de envio do produto.

shippingType
Presença: Obrigatório caso seja informado o shippingCost.
<payment> Formato: 1 – PAC, 2 – SEDEX, 3 - Desconhecido
<shipping>
<type >
Parâmetro HTTP: Valor do frete

shippingCost
<payment> Formato: Decimal, com duas casas decimais separadas por ponto (p.e.,
<shipping> 1234.56), maior que 0.00 e menor ou igual a 9999999.00.
<cost>
Elemento XML: Dados do endereço de envio

<payment>
<shipping>
<addre ss>
Parâmetro HTTP: País do endereço de envio.

shippingAddressCountry
Informa o país do endereço de envio do produto.
<shipping> Formato: No momento, apenas o valor BRA é permitido.
<address>
<country>
Parâmetro HTTP: Estado do endereço de envio.

shippingAddressState
Informa o estado do endereço de envio do produto.
<shipping> Formato: Duas letras, representando a sigla do estado brasileiro
<address> correspondente.
<state >
Parâmetro HTTP: Cidade do endereço de envio.

shippingAddressCity
Informa a cidade do endereço de envio do produto.
<shipping> Formato: Livre. Deve ser um nome válido de cidade do Brasil, com no
<address> mínimo 2 e no máximo 60 caracteres.
<ci ty>
VERSÃO 1.0.2
Parâmetro HTTP: CEP do endereço de envio.

shippingAddressPostalCode
Informa o CEP do endereço de envio do produto.
<payment> Tipo: Número.
<shipping> Formato: Um número de 8 dígitos.
<address>
<postal Code >
Parâmetro HTTP: Bairro do endereço de envio.

shippingAddressDistrict
Informa o bairro do endereço de envio do produto.
<shipping> Formato: Livre, com limite de 60 caracteres.
<address>
<di stri ct>
Parâmetro HTTP: Nome da rua do endereço de envio.

shippingAddressStreet
Informa o nome da rua do endereço de envio do produto.
<address>
<stre e t>
Parâmetro HTTP: Número do endereço de envio.

shippingAddressNumber Informa o número do endereço de envio do produto.

<address>
<numbe r>
Parâmetro HTTP: Complemento do endereço de envio.

shippingAddressComplement
Informa o complemento (bloco, apartamento, etc.) do endereço de envio do
produto.
Elemento XML:
<payment> Presença: Opcional.
<shipping> Tipo: Texto.
<address> Formato: Livre, com limite de 40 caracteres.
<compl e me nt>
VERSÃO 1.0.2
DADOS PARA TRANSAÇÕES VIA DÉBITO ONLINE
Elemento XML:
<payment> Dados do banco.
<bank>
Parâmetro HTTP: Nome do Banco

bankName
Nome de banco para qual vai ser gerado o link de redirecionamento
Elemento XML:
<payment> Presença: Obrigatório para Débito Online.
<bank> Tipo: Texto
<name > Formato: bradesco, itau, bancodobrasil, banrisul ou hsbc
DADOS PARA TRANSAÇÕES VIA CARTÃO DE CRÉDITO
Parâmetro HTTP: Token do Cartão de Crédito

creditCardToken
Token retornado no serviço de obtenção de token do cartão de crédito
Elemento XML: (pág.: 9).
<payment> Presença: Obrigatório para Cartão de Crédito
<creditCard> Tipo: Texto
<toke n> Formato: Não tem limite de caracteres
Parâmetro HTTP: Quantidade de parcelas

installmentQuantity Quantidade de parcelas escolhidas pelo cliente.
Elemento XML: Presença: Obrigatório para Cartão de Crédito.

<payment> Tipo: Inteiro
<creditCard> Valores aceitos: [1, 18]
<installment>
<quanti ty>
Parâmetro HTTP: Valor das parcelas

installmentValue
Valor das parcelas obtidas no serviço de opções de parcelamento.
Elemento XML:
<payment> Presença: Obrigatório para Cartão de Crédito.
<creditCard> Tipo: Número
<installment> Formato: Numérico com 2 casas decimais e separado por ponto. Ex: 1111.11
<val ue >
VERSÃO 1.0.2
Parâmetro HTTP: Quantidade de parcelas sem juros

noInterestInstallmentQuantity
Quantidade de parcelas sem juros oferecidas ao cliente. O valor deve ser o
mesmo indicado no método getInstallments, no parâmetro
Elemento XML: maxInstallmentNoInterest.
<payment>
<creditCard> Presença: Obrigatório caso tenha sido informado o valor no parâmetro
<installment> maxInstallmentNoInterest do método getInstallments.
<noInterestInstallmentQuantity> Tipo: Número
Formato: Inteiro. Ex: 10
Parâmetro HTTP: Nome impresso no cartão de crédito

creditCardHolderName
Presença: Obrigatório para Cartão de Crédito.
<payment> Formato: min = 1, max = 50 caracteres
<creditCard>
<holder>
<name >
Parâmetro HTTP: Data de nascimento do dono do cartão de crédito

creditCardHolderBirthDate
Elemento XML: Tipo: dd/MM/yyyy
<payment> Formato: 31/12/2013
<creditCard>
<holder>
<bi rthDate >
Elemento XML: Lista de documentos do dono do cartão de crédito.

<payment>
<creditCard>
<holder>
<docume nts>
Elemento XML: Representa um documento do dono do cartão de crédito.

<payment>
<creditCard>
<holder>
<documents>
<docume nt>
Elemento XML: Tipo de documento do dono do cartão de crédito.

<payment> Especifica o tipo de documento do dono do cartão de crédito que está
<creditCard> sendo usado para realizar o pagamento.
<holder>
<documents> Presença: Obrigatório para Cartão de Crédito.
<document> Tipo: Texto.
<type > Formato: Case sensitive. Somente o valor CPF é aceito.
VERSÃO 1.0.2
Parâmetro HTTP: CPF do dono do cartão de crédito

creditCardHolderCPF
<payment>
<creditCard>
<holder>
<documents>
<document>
<val ue >
Elemento XML: Telefone do dono do cartão de crédito.

<payment>
<creditCard>
<holder>
<phone >
Parâmetro HTTP: Código de área

creditCardHolderAreaCode
Elemento XML: Tipo: Número
<payment> Formato: Um número de 2 dígitos correspondente a um DDD válido.
<creditCard>
<holder>
<phone>
<are aCode >
Parâmetro HTTP: Telefone

creditCardHolderPhone
Elemento XML: Tipo: Número
<payment> Formato: Um número entre 7 e 9 dígitos.
<creditCard>
<holder>
<phone>
<numbe r>
DADOS DE ENDEREÇO DE COBRANÇA
Elemento XML: Endereço de cobrança.

<payment>
<creditCard>
<bi l l i ngAddress>
VERSÃO 1.0.2
Parâmetro HTTP: CEP do endereço de cobrança

billingAddressPostalCode
Elemento XML: Formato: Um número de 8 dígitos correspondente a um CEP válido (p.e,
<payment> 01452002).
<creditCard>
<billingAddress>
<postal Code >
Parâmetro HTTP: Nome da Rua

billingAddressStreet
Elemento XML: Formato: Livre, com limite de 80 caracteres.
<payment>
<creditCard>
<billingAddress>
<stre e t>
Parâmetro HTTP: Número

billingAddressNumber
<payment>
<creditCard>
<billingAddress>
<numbe r>
Parâmetro HTTP: Complemento

billingAddressComplement
Presença: Opcional para Cartão de Crédito.
<payment>
<creditCard>
<billingAddress>
<compl e me nt>
Parâmetro HTTP: Bairro

billingAddressDistrict
<payment> Formato: Livre, com limite de 60 caracteres.
<creditCard>
<billingAddress>
<di stri ct>
VERSÃO 1.0.2
Parâmetro HTTP: Cidade

billingAddressCity
Elemento XML: Formato: Deve ser um nome válido de cidade do Brasil, com no mínimo 2 e
<payment> no máximo 60 caracteres.
<creditCard>
<billingAddress>
<ci ty>
Parâmetro HTTP: Estado

billingAddressState
Elemento XML: Formato: Duas letras, representando a sigla do estado brasileiro
<payment> correspondente (p.e, SP).
<creditCard>
<billingAddress>
<state >
Parâmetro HTTP: País

billingAddressCountry
Elemento XML: Formato: Reconhece apenas o valor BRA.
<payment>
<creditCard>
<billingAddress>
<country>
Parâmetros de retorno da API do Checkout Transparente

CAMPO DESCRIÇÃO
<transaction> Este campo é a raiz do XML e engloba os dados da transação.
<transaction> Data da criação da transação.

<date>
Informa o momento em que a transação foi criada.
Tipo: Data/hora.
Formato: YYYY-MM-DDThh:mm:ss.sTZD, o formato oficial do W3C
para datas. Veja mais sobre formatação de datas.
<transaction> Data do último evento.

<lastEventDate>
Informa o momento em que ocorreu a última alteração no status da
transação.
Tipo: Data/hora.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
<transaction> Código identificador da transação

<code>
Retorna o código que identifica a transação de forma única.
Tipo: Texto.
Formato: Uma sequência de 36 caracteres.
<transaction>
Código de referência da transação.
<reference>
Informa o código que foi usado para fazer referência ao pagamento.
Este código foi fornecido no momento do pagamento e é útil para
vincular as transações do PagSeguro às vendas registradas no seu
sistema.
Tipo: Texto.
Formato: Livre, com o limite de 200 caracteres.
<transaction>
<type> Tipo da transação.
Representa o tipo da transação recebida. Os valores mais comuns para
este campo e seus respectivos resultados são descritos abaixo.
Código Significado
Pagamento: a transação foi criada por um comprador

1 fazendo um pagamento. Este é o tipo mais comum de
transação que você irá receber.
Outros tipos menos comuns de transações foram omitidos. Note que

novos tipos podem ser adicionados em versões futuras da API.
Tipo: Número.
Formato: Inteiro.
<transaction>
Status da transação.
<status>
Informa o código representando o status da transação, permitindo que
você decida se deve liberar ou não os produtos ou serviços adquiridos.
Os valores possíveis estão descritos no diagrama de status de
transações e são apresentados juntamente com seus respectivos
códigos na tabela abaixo.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
Código Significado
Aguardando pagamento: o comprador iniciou a

1 transação, mas até o momento o PagSeguro não
recebeu nenhuma informação sobre o pagamento.
Em análise: o comprador optou por pagar com um

2 cartão de crédito e o PagSeguro está analisando o risco
da transação.
Paga: a transação foi paga pelo comprador e o

3 PagSeguro já recebeu uma confirmação da instituição
financeira responsável pelo processamento.
Disponível: a transação foi paga e chegou ao final de

4 seu prazo de liberação sem ter sido retornada e sem
que haja nenhuma disputa aberta.
Em disputa: o comprador, dentro do prazo de liberação

5
da transação, abriu uma disputa.
Devolvida: o valor da transação foi devolvido para o

6
comprador.
Cancelada: a transação foi cancelada sem ter sido

7
finalizada.
Outros status menos relevantes foram omitidos. Em resumo, você deve

considerar transações nos status de Paga para liberação de produtos
ou serviços.
Tipo: Número.
Formato: Inteiro.
<transaction>
Origem do cancelamento.
<cancellationSource>
Informa a origem do cancelamento da transação: pelas instituições
financeiras (Banco Emissor ou Operadora do Cartão) ou pelo
PagSeguro.
Valor Significado
INTERNAL PagSeguro
EXTERNAL Instituições Financeiras
Presença: Opcional (somente quando transactionStatus igual a 7).
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
Tipo: Texto.
Formato: Valores possíveis INTERNAL ou EXTERNAL.
<transaction>
Dados do meio de pagamento usado pelo comprador.
<paymentMethod>
<transaction>
Tipo do meio de pagamento.
<paymentMethod>
<type> Informa o tipo do meio de pagamento usado pelo comprador. Este tipo
agrupa diversos meios de pagamento e determina de forma geral o
comportamento da transação. A tabela abaixo descreve os valores
disponíveis e seus significados.
Código Significado
Cartão de crédito: o comprador escolheu pagar a

1
transação com cartão de crédito.
Boleto: o comprador optou por pagar com um boleto

2
bancário.
Débito online (TEF): o comprador optou por pagar a

3 transação com débito online de algum dos bancos
conveniados.
Saldo PagSeguro: o comprador optou por pagar a

4
transação utilizando o saldo de sua conta PagSeguro.
Oi Paggo *: o comprador escolheu pagar sua transação

5
através de seu celular Oi.
Depósito em conta: o comprador optou por fazer um

depósito na conta corrente do PagSeguro. Ele precisará
ir até uma agência bancária, fazer o depósito, guardar o
7 comprovante e retornar ao PagSeguro para informar os
dados do pagamento. A transação será confirmada
somente após a finalização deste processo, que pode
levar de 2 a 13 dias úteis.
* Os tipos marcados não estão disponíveis para utilização.
Tipo: Número.
Formato: Inteiro.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
<transaction>
Link para o Pagamento.
<paymentLink>
Informa a URL para a exibição do boleto ou, quando o meio de
pagamento for TEF, a URL para abrir o pop-up do banco. Quando o
meio de pagamento for Cartão de crédito este parâmetro será omitido.
Presença: Somente para pagamentos via Boleto e TEF.
Tipo: Texto.
Formato: URL
<transaction>
Código identificador do meio de pagamento
<paymentMethod>
<code> Informa um código que identifica o meio de pagamento usado pelo
comprador. O meio de pagamento descreve a bandeira de cartão de
crédito utilizada ou banco escolhido para um débito online. A tabela
abaixo descreve os possíveis valores e seus significados.
Código Significado
101 Cartão de crédito Visa.
102 Cartão de crédito MasterCard.
103 Cartão de crédito American Express.
104 Cartão de crédito Diners.
105 Cartão de crédito Hipercard.
106 Cartão de crédito Aura.
107 Cartão de crédito Elo.
108 Cartão de crédito PLENOCard.
109 Cartão de crédito PersonalCard.
110 Cartão de crédito JCB.
111 Cartão de crédito Discover.
112 Cartão de crédito BrasilCard.
113 Cartão de crédito FORTBRASIL.
114 Cartão de crédito CARDBAN.
115 Cartão de crédito VALECARD.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
116 Cartão de crédito Cabal.
117 Cartão de crédito Mais!.
118 Cartão de crédito Avista.
119 Cartão de crédito GRANDCARD.
201 Boleto Bradesco. *
202 Boleto Santander.
301 Débito online Bradesco.
302 Débito online Itaú.
303 Débito online Unibanco. *
304 Débito online Banco do Brasil.
305 Débito online Banco Real. *
306 Débito online Banrisul.
307 Débito online HSBC.
401 Saldo PagSeguro.
501 Oi Paggo. *
701 Depósito em conta - Banco do Brasil
* Os meios de pagamento marcados não estão disponíveis para

utilização.
Tipo: Número.
Formato: Inteiro.
<transaction>
Valor bruto da transação.
<grossAmount>
Informa o valor bruto da transação, calculado pela soma dos preços de
todos os itens presentes no pagamento.
Tipo: Número.
Formato: Decimal, com duas casas decimais separadas por ponto (".").
Por exemplo, 1234.56.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
<transaction>
Valor do desconto dado.
<discountAmount>
Informa o valor do desconto dado a compradores que optaram por
pagar com débito online ou boleto. Este desconto aplica-se quando
você opta por incluir no preço dos produtos o custo do parcelamento
de pagamentos com cartão de crédito. O desconto é dado para não
onerar os compradores que optaram por meios à vista.
Tipo: Número.
<transaction>
Valor total das taxas cobradas.
<feeAmount>
Informa o valor total das taxas cobradas pelo PagSeguro nesta
transação.
Tipo: Número.
<transaction> Valor líquido da transação.

<netAmount>
Informa o valor líquido da transação, que corresponde ao valor bruto,
menos o valor das taxas. Caso presente, o valor de extraAmount (que
pode ser positivo ou negativo) também é considerado no cálculo.
Tipo: Número.
<transaction> Data de crédito.

<escrowEndDate>
Data em que o valor da transação estará disponível na conta do
vendedor.
Presença: Presente apenas quando o status da transação for um dos
seguintes valores:Paga (3), Disponível (4), Em disputa (5)
ou Devolvida (6).
Tipo: Data/hora.
<transaction> Valor extra.

<extraAmount>
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
Informa um valor extra que foi somado ou subtraído do valor pago pelo
comprador. Este valor é especificado por você no pagamento e pode
representar um valor que você quer cobrar separadamente do
comprador ou um desconto que quer dar a ele.
Tipo: Número.
Formato: Decimal, com duas casas decimais separadas por ponto (“.”).
Por exemplo, 1234.56 ou -1234.56.
<transaction>
Número de parcelas.
<installmentCount>
Indica o número de parcelas que o comprador escolheu no pagamento
com cartão de crédito.
Tipo: Número.
Formato: Inteiro.
<transaction>
Número de itens da transação.
<itemCount>
Aponta o número de itens contidos nesta transação.
Tipo: Número.
Formato: Inteiro.
<transaction>
Lista de itens contidos na transação. O número de itens sob este
<items>
elemento corresponde ao valor de itemCount.
<transaction>
Representa um item da transação.
<items>
<item>
<transaction>
Identificador do item.
<items>
<item> Identifica o item da transação. Este identificador deve ser único por
<id> transação e foi informado por você no fluxo de pagamento.
Tipo: Texto.
Formato: Livre.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
<transaction>
Descrição do item.
<items>
<item> Descreve o item da transação. A descrição é um texto explicativo do
<description> item que você especificou no fluxo de pagamento.
Tipo: Texto.
Formato: Livre.
<transaction>
Valor unitário do item.
<items>
<item> Informa o preço unitário do item da transação. Este é o valor que foi
<amount> especificado no fluxo de pagamento.
Tipo: Número.
1234.56).
<transaction>
<items> Quantidade do item.
<item> Informa a quantidade do item da transação. Está é a quantidade que
<quantity> foi especificada no fluxo de pagamento.
Tipo: Número.
Formato: Um número inteiro maior ou igual a 1 e menor ou igual a 999.
<transaction>
Dados do comprador.
<sender>
<transaction>
E-mail do comprador.
<sender>
<email> Informa o e-mail do comprador que realizou a transação.
Tipo: Texto.
Formato: um e-mail válido (p.e., [email protected]), com no
máximo 60 caracteres.
<transaction>
Nome completo do comprador.
<sender>
<name> Informa o nome completo do comprador que realizou o pagamento.
Tipo: Texto.
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
Formato: No mínimo duas sequências de caracteres, com o limite total

de 50 caracteres.
<transaction>
Dados do telefone do comprador.
<sender>
<phone>
<transaction>
DDD do comprador.
<sender>
<phone> Informa o código de área (DDD) do comprador que realizou o
<areaCode> pagamento.
Tipo: Número.
Formato: Um número de 2 dígitos correspondente a um DDD válido.
<transaction> Número de telefone do comprador.

<sender>
Informa o número do telefone do comprador que realizou o
<phone>
pagamento.
<number>
Tipo: Número.
Formato: Um número de 7 a 9 dígitos.
<transaction>
Dados do frete.
<shipping>
<transaction>
Tipo de frete.
<shipping>
<type> Informa o tipo de frete a ser usado para o envio do produto. A tabela
abaixo informa os valores possíveis e seus significados.
Código Significado
1 Encomenda normal (PAC).
2 SEDEX.
3 Tipo de frete não especificado.
Tipo: Número.
Formato: Inteiro.
<transaction>
Custo total do frete.
<shipping>
<cost>
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
Informa o custo total do frete, a partir das opções de frete informadas

no fluxo de pagamento.
Tipo: Número.
1234.56).
<transaction>
Dados do endereço de envio.
<shipping>
<address>
<transaction>
País do endereço de envio.
<shipping>
<address> Informa o país do endereço de envio do produto.
<country>
Tipo: Texto.
Formato: No momento, apenas o valor BRA é permitido.
<transaction>
<shipping> Estado do endereço de envio.
<address> Informa o estado do endereço de envio do produto.
<state>
Tipo: Texto.
Formato: Duas letras, representando a sigla do estado brasileiro
correspondente.
<transaction> Cidade do endereço de envio.

<shipping>
Informa a cidade do endereço de envio do produto.
<address>
<city> Presença: Opcional.
Tipo: Texto.
Formato: Livre. Deve ser um nome válido de cidade do Brasil, de
acordo com os dados dos Correios.
<transaction> CEP do endereço de envio.

<shipping>
Informa o CEP do endereço de envio do produto.
<address>
<postalCode> Presença: Opcional.
Tipo: Número.
Formato: Um número de 8 dígitos.
<transaction>
Bairro do endereço de envio.
<shipping>
<address>
VERSÃO 1.0.2
CAMPO DESCRIÇÃO
<district>
Informa o bairro do endereço de envio do produto.
Tipo: Texto.
Formato: Livre.
<transaction>
<shipping> Nome da rua do endereço de envio.
<address> Informa o nome da rua do endereço de envio do produto.
<street>
Tipo: Texto.
Formato: Livre.
<transaction>
Número do endereço de envio.
<shipping>
<address> Informa o número do endereço de envio do produto.
<number>
Tipo: Texto.
Formato: Livre.
<transaction>
<shipping> Complemento do endereço de envio.
<address> Informa o complemento (bloco, apartamento, etc.) do endereço de
<complement> envio do produto.
Tipo: Texto.
Formato: Livre.
Tabela de Erros
Caso sua aplicação informe algum dado incorreto ou fora do padrão esperado pela aplicação, será retornado
uma mensagem informando o problema. Confira abaixo os erros que podem ser retornados:
HTTP 401 - Unauthorized

Ocorre quando sua aplicação encaminhou uma credencial (e -mail ou token) invalida ou inexistente.
HTTP 405 – Method Not Allowed

Ocorre quando sua aplicação efetuou a chamada utilizando um método não esperado. Neste caso verifique
se o método da chamada é GET ou POST.
HTTP 415 – Cannot consume content type

Ocorre quando não é encaminhado o Content-Type na chamada.
VERSÃO 1.0.2
HTTP 400 – Bad Request

Ocorre quando um ou mais dados foram encaminhados de forma incorreta ou fora do padrão. Este retorno
possui um XML no corpo na mensagem que identifica quais os erros presentes na chamada. O XML possui o
seguinte formato:
VERSÃO 1.0.2
CÓDIGO DESCRIÇÃO
10000 invalid creditcard brand.
10001 creditcard number with invalid length.
10002 invalid date format.
10003 invalid security field.
10004 cvv is mandatory.
10006 security field with invalid length.
53004 items invalid quantity.
53005 currency is required.
53006 currency invalid value: {0}
53007 reference invalid length: {0}
53008 notificationURL invalid length: {0}
53009 notificationURL invalid value: {0}
53010 sender email is required.
53011 sender email invalid length: {0}
53012 sender email invalid value: {0}
53013 sender name is required.
53014 sender name invalid length: {0}
53015 sender name invalid value: {0}
53017 sender cpf invalid value: {0}
53018 sender area code is required.
53019 sender area code invalid value: {0}
53020 sender phone is required.
53021 sender phone invalid value: {0}
53022 shipping address postal code is required.
53023 shipping address postal code invalid value: {0}
VERSÃO 1.0.2
CÓDIGO DESCRIÇÃO
53024 shipping address street is required.
53025 shipping address street invalid length: {0}
53026 shipping address number is required.
53027 shipping address number invalid length: {0}
53028 shipping address complement invalid length: {0}
53029 shipping address district is required.
53030 shipping address district invalid length: {0}
53031 shipping address city is required.
53032 shipping address city invalid length: {0}
53033 shipping address state is required.
53034 shipping address state invalid value: {0}
53035 shipping address country is required.
53036 shipping address country invalid length: {0}
53037 credit card token is required.
53038 installment quantity is required.
53039 installment quantity invalid value: {0}
53040 installment value is required.
53041 installment value invalid value: {0}
53042 credit card holder name is required.
53043 credit card holder name invalid length: {0}
53044 credit card holder name invalid value: {0}
53045 credit card holder cpf is required.
53046 credit card holder cpf invalid value: {0}
53047 credit card holder birthdate is required.
53048 credit card holder birthdate invalid value: {0}
VERSÃO 1.0.2
CÓDIGO DESCRIÇÃO
53049 credit card holder area code is required.
53050 credit card holder area code invalid value: {0}
53051 credit card holder phone is required.
53052 credit card holder phone invalid value: {0}
53053 billing address postal code is required.
53054 billing address postal code invalid value: {0}
53055 billing address street is required.
53056 billing address street invalid length: {0}
53057 billing address number is required.
53058 billing address number invalid length: {0}
53059 billing address complement invalid length: {0}
53060 billing address district is required.
53061 billing address district invalid length: {0}
53062 billing address city is required.
53063 billing address city invalid length: {0}
53064 billing address state is required.
53065 billing address state invalid value: {0}
53066 billing address country is required.
53067 billing address country invalid length: {0}
53068 receiver email invalid length: {0}
53069 receiver email invalid value: {0}
53070 item id is required.
53071 item id invalid length: {0}
53072 item description is required.
53073 item description invalid length: {0}
VERSÃO 1.0.2
CÓDIGO DESCRIÇÃO
53074 item quantity is required.
53075 item quantity out of range: {0}
53076 item quantity invalid value: {0}
53077 item amount is required.
53078 item amount invalid pattern: {0}. Must fit the patern: \\d+.\\d\{2\}
53079 item amount out of range: {0}
53081 sender is related to receiver.
53084 invalid receiver: {0}, verify receiver's account status and if it is a seller's account.
53085 payment method unavailable.
53086 cart total amount out of range: {0}
53087 invalid credit card data.
53091 sender hash invalid.
53092 credit card brand is not accepted.
53095 shipping type invalid pattern: {0}
53096 shipping cost invalid pattern: {0}
53097 shipping cost out of range: {0}
53098 cart total value is negative: {0}
53099 extra amount invalid pattern: {0}. Must fit the patern: -?\\d+.\\d\{2\}
53101 payment mode invalid value, valid values are default and gateway.
53102 payment method invalid value, valid values are creditCard, boleto e eft.
53104 shipping cost was provided, shipping address must be complete.
53105 sender information was provided, email must be provided too.
53106 credit card holder is incomplete.
53109 shipping address information was provided, sender email must be provided too.
53110 eft bank is required.
VERSÃO 1.0.2
CÓDIGO DESCRIÇÃO
53111 eft bank is not accepted.
53115 sender born date invalid value: {0}
53117 sender cnpj invalid value: {0}
53122 sender email invalid domain: {0}. You must use an email @sandbox.pagseguro.com.br
53140 installment quantity out of range: {0}. The value must be greater than zero.
53141 sender is blocked.
53142 credit card token invalid.
Anexos
Exemplo de chamada para Boleto

2. <payment>
3. <mode>default</mode>
4. <method>boleto</method>
5. <sender>
6. <name>Fulano Silva</name>
8. <phone>
11. </phone>
12. <documents>
13. <document>
14. <type>CPF</type>
15. <value>11475714734</value>
16. </document>
17. </documents>
18. <hash>abc1234</hash>
19. </sender>
20. <currency>BRL</currency>
21. <notificationURL>https://sualoja.com.br/notificacao</notificationURL>
22. <items>
23. <item>
24. <id>1</id>
25. <description>Descricao do item a ser vendido</description>
28. </item>
29. </items>
31. <reference>R123456</reference>
VERSÃO 1.0.2
32. <shipping>
33. <address>
34. <street>Av. Brigadeiro Faria Lima</street>
36. <complement>1 andar</complement>
42. </address>
43. <type>3</type>
44. <cost>0.00</cost>
45. </shipping>
46. </payment>
VERSÃO 1.0.2
Exemplo de chamada para Débito

48. <payment>
50. <method>eft</method>
51. <bank>
52. <name>itau</name>
53. </bank>
54. <sender>
57. <phone>
60. </phone>
61. <documents>
62. <document>
64. <value>11475714734</value>
65. </document>
66. </documents>
68. </sender>
71. <items>
72. <item>
73. <id>1</id>
77. </item>
78. </items>
81. <shipping>
82. <address>
91. </address>
92. <type>3</type>
93. <cost>0.00</cost>
94. </shipping>
95. </payment>
VERSÃO 1.0.2
Exemplo de chamada para Cartão de Crédito

97. <payment>
99. <method>creditCard</method>
100. <sender>
103. <phone>
106. </phone>
107. <documents>
108. <document>
110. <value>11475714734</value>
111. </document>
112. </documents>
114. </sender>
117. <items>
118. <item>
119. <id>1</id>
123. </item>
124. </items>
127. <shipping>
128. <address>
137. </address>
138. <type>3</type>
139. <cost>0.00</cost>
140. </shipping>
141. <creditCard>
142. <token>4a56sd456a4d54asd65as4d56a4sd564</token>
143. <installment>
145. <value>5.50</value>
146. </installment>
147. <holder>
148. <name>Nome impresso no cartao</name>
149. <documents>
VERSÃO 1.0.2
150. <document>
152. <value>00722333665</value>
153. </document>
154. </documents>
155. <birthDate>20/10/1980</birthDate>
156. <phone>
158. <number>999991111</number>
159. </phone>
160. </holder>
161. <billingAddress>
170. </billingAddress>
171. </creditCard>
172. </payment>
VERSÃO 1.0.2

Pagseguro Checkout Transparente

Enviado por

Direitos autorais:

Formatos disponíveis

Pagseguro Checkout Transparente

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Pagseguro Checkout Transparente

Enviado por

Direitos autorais:

Formatos disponíveis

Guia de Integração

O PagSeguro provê todas as ferramentas necessárias para

Aviso Legal .......................................................................................................................... 2

Iniciando uma sessão de pagamento .................................................................................... 5

Integrações no browser ....................................................................................................... 6

Obter identificação do comprador................................................................................ 6

Obter os meios de pagamento...................................................................................... 7

Obter bandeira do cartão de crédito ............................................................................. 9

Obter token do cartão de crédito ................................................................................10

Obter opções de parcelamento ...................................................................................11

API do Checkout Transparente………………………………………………………………………………………………..12

Exemplo de chamada para Boleto........................................................................................13

Exemplo de chamada para Débito .......................................................................................14

Exemplo de chamada para Cartão de Crédito .......................................................................15

Retorno da API do Checkout Transparente……………………………………………………………………………..16

Parâmetros da API do Checkout Transparente......................................................................18

Parâmetros de retorno da API do Checkout Transparente .....................................................28

Exemplo de chamada para Boleto........................................................................................45

Exemplo de chamada para Débito .......................................................................................47

Exemplo de chamada para Cartão de Crédito .......................................................................48

O Checkout Transparente está disponível para contas do tipo Vendedor e Empresarial.

O Checkout Transparente pode ser utilizado em ambiente Sandbox. Para utilizar o

Atenção: A biblioteca Java do PagSeguro já possui suporte ao Checkout Transparente.

Iniciar uma sessão de pagamento (Todos os meios de pagamento)

Iniciando uma sessão de pagamento

1. <?xml version="1.0" encoding="ISO-8859-1"?>

<script type="text/javascript" src=

Obter identificação do comprador

Obter os meios de pagamento

Obter bandeira do cartão de crédito

Obter token do cartão de crédito

Obter opções de parcelamento

API do Checkout Transparente

O cabeçalho Content-Type deve ser informado como no exemplo abaixo:

Por exemplo: os parâmetros itemId1, itemDescription1, itemAmount1 e itemQuantity1 referem-se ao

Exemplo de chamada para Boleto

curl https://ws.sandbox.pagseguro.uol.com.br/v2/transactions/ -d\

Exemplo de chamada para Débito

curl https://ws.sandbox.pagseguro.uol.com.br/v2/transactions/ -d\

Os parâmetros em XML desta chamada estão disponíveis no anexo desta documentação.

Exemplo de chamada para Cartão de Crédito

curl https://ws.sandbox.pagseguro.uol.com.br/v2/transactions/ -d\

Os parâmetros em XML desta chamada estão disponíveis no anexo desta documentação.

Retorno da API do Checkout Transparente

1. <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>

52. <city>Sao Paulo</city>

Atenção: A página do banco não deve ser aberta em um IFrame.

Especifica o e-mail associado à conta PagSeguro que está realizando a requisição.

Especifica o token correspondente à conta PagSeguro que está realizando a

Parâmetros da API do Checkout Transparente

Parâmetro HTTP: Especifica o e-mail que deve vai receber o pagamento

Parâmetro HTTP: URL para envio de notificações.

Parâmetro HTTP: Moeda utilizada.

Parâmetro HTTP: Meio de pagamento

Parâmetro HTTP: Modo do pagamento

Parâmetro HTTP: Identificadores dos itens.

Parâmetro HTTP: Descrições dos itens.

Parâmetro HTTP: Valores unitários dos itens.

Parâmetro HTTP: Quantidades dos itens.

Parâmetro HTTP: Código de referência.