Pagseguro Modelo Aplicacoes

Guia de Integrao
Modelo de Aplicaes
MODELO DE APLICAES
Histrico de Verses
DATA
26/02/2013
13/03/2013
03/05/2013
24/01/2014
11/03/2014
28/08/2014
05/01/2015
14/10/2015
DESCRIO
Viso Geral
Reviso
Adio de sugesto de criao de conta
Reviso
Incluso do parmetro DIRECT_PAYMENT
Reviso
Reviso da consulta de autorizaes por data
Incluso da publicKey
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 so
de propriedade de seus respectivos proprietrios.
As informaes contidas neste documento pertencem ao UNIVERSO ONLINE S/A. Todos os direitos
reservados. UNIVERSO ONLINE S/A. - Av. Faria Lima, 1384, 6 andar, So Paulo / SP, CEP 01452-002,
Brasil.
O servio PagSeguro no , nem pretende ser comparvel a servios financeiros oferecidos por
instituies financeiras ou administradoras de cartes de crdito, consistindo apenas de uma forma de
facilitar e monitorar a execuo das transaes de comrcio electrnico atravs da gesto de
pagamentos. Qualquer transao efetuada atravs do PagSeguro est sujeita e deve estar em
conformidade com as leis da Repblica Federativa do Brasil.
Aconselhamos que voc leia os termos e condies cuidadosamente.
Aviso Legal
O UOL no oferece garantias de qualquer tipo (expressas, implcitas ou estatutrias) com relao s
informaes nele contidas. O UOL no assume nenhuma responsabilidade por perdas e danos (diretos
ou indiretos), causados por erros ou omisses, ou resultantes da utilizao deste documento ou a
informao contida neste documento ou resultantes da aplicao ou uso do produto ou servio aqui
descrito. O UOL reserva o direito de fazer qualquer tipo de alteraes a quaisquer informaes aqui
contidas sem aviso prvio.
VERSO 1.0.4
MODELO DE APLICAES
O PagSeguro prov todas as ferramentas necessrias para

que voc efetue a sua integrao de forma rpida e fcil.
Confira abaixo nossas ferramentas e canais:
Documentaes
Acessando a rea de documentaes do PagSeguro voc tem acesso a todas as APIs
disponveis pelo PagSeguro.
Acesse: https://pagseguro.uol.com.br/v2/guia-de-integracao/visao-geral.html
Sandbox
Teste sua integrao de pagamento sem alterar as transaes reais.
Acesse: https://sandbox.pagseguro.uol.com.br/
Frum
Participe da comunidade PagSeguro postando suas dvidas e auxiliando outros
desenvolvedores em nosso frum. Nossa equipe est sempre presente para lhe
auxiliar.
Acesse: http://forum.pagseguro.uol.com.br/
Mdulos
Desenvolvemos mdulos 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 vrias 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
VERSO 1.0.4
MODELO DE APLICAES
ndice
Histrico de Verses ...................................................................................................................... 2
Copyright ....................................................................................................................................... 2
Aviso Legal ..................................................................................................................................... 2
ndice ............................................................................................................................................. 4
Viso Geral..................................................................................................................................... 6
Etapas da Integrao ..................................................................................................................... 6
Aplicaes ...................................................................................................................................... 7
Autorizao.................................................................................................................................. 10
Informando os dados da requisio ................................................................................... 11
Parmetros de autenticao............................................................................................... 11
Parmetros de requisio ................................................................................................... 12
Dados do cliente e sugesto para cadastro ........................................................................ 13
Resposta da API de Autorizao ......................................................................................... 20
Direcionando o comprador para o fluxo de autorizao .................................................... 21
Fluxo de autorizao ........................................................................................................... 21
Notificaes ................................................................................................................................. 23
Configurando o recebimento de notificaes .................................................................... 24
Recebendo uma notificao de autorizao ...................................................................... 24
Consultas ..................................................................................................................................... 25
Consultando uma autorizao pelo cdigo de notificao ................................................ 25
Consultando uma autorizao pelo seu cdigo .................................................................. 26
VERSO 1.0.4
MODELO DE APLICAES
Consulta de autorizaes da aplicao por data ................................................................ 29

Utilizando as APIs do PagSeguro ................................................................................................. 32
API de Pagamentos ............................................................................................................. 32
API de Notificaes ............................................................................................................. 34
API de Consultas ................................................................................................................. 34
Criao de Assinaturas ........................................................................................................ 35
Revogao de autorizao .................................................................................................. 36
Tabela de Erros ............................................................................................................................ 37
VERSO 1.0.4
MODELO DE APLICAES
Viso Geral
O modelo de aplicaes do PagSeguro permite que sua aplicao crie checkouts, receba notificaes de
pagamento entre outras funes em nome do cliente sem a necessidade de configurar tokens, URL de
retorno e outras informaes em sua conta PagSeguro.
Assim, o seu cliente pode se cadastrar em sua plataforma, autoriza-la e comear a vender sem a necessidade
de inserir informaes ou entrar na conta PagSeguro para efetuar configuraes.
O modelo de aplicaes do PagSeguro est disponvel para contas do tipo Vendedor e Empresarial.
Etapas da Integrao
A integrao possui algumas etapas bsicas:
1. Aplicaes
Crie e gerencie uma aplicao.
2. Autorizaes
Obtenha a permisso do seu cliente para criar checkouts, efetuar

consultas entre outras aes.
3. Notificaes
Receba notificaes informando o status da autorizao e das

cobranas.
4. Consulta
Faa consultas ao PagSeguro para acompanhar a qualquer

momento as suas transaes.
importante seguir os passos acima para o correto entendimento da ferramenta.
VERSO 1.0.4
MODELO DE APLICAES
Aplicaes
Para utilizar o modelo de aplicaes do PagSeguro necessrio que voc crie uma aplicao. Esta aplicao
ser responsvel por centralizar as autorizaes concedidas pelos seus clientes.
Ateno: Como o modelo de aplicaes uma ferramenta liberada apenas para alguns
parceiros, o acesso a esta feito atravs de algumas URLs diretas que voc ver no
decorrer da documentao.
Para criar uma nova aplicao, acesse o link https://pagseguro.uol.com.br/aplicacao/listagem.jhtml e clique
em criar suas aplicaes conforme apresentado na Imagem 1:
Imagem 1
Voc tambm pode acessar diretamente a pgina de cadastro atravs do link

https://pagseguro.uol.com.br/aplicacao/cadastro.jhtml.
Na pgina de criao, voc deve preencher os dados solicitados que so:
PARMETRO
Nome da aplicao
DESCRIO
Esse nome ir aparecer para voc e para os outros clientes que
usaro sua aplicao.
O ID da aplicao ser o cdigo que identifica esta aplicao no

PagSeguro.
ID da Aplicao
Obs.: O PagSeguro ir sugerir um ID a partir do nome que voc
escolheu no campo anterior.
VERSO 1.0.4
MODELO DE APLICAES
PARMETRO
Descrio da aplicao
URL da aplicao
DESCRIO
Escreva a descrio que ir aparecer para os usurios em sua
aplicao. Procure ser objetivo e explicar resumidamente a sua
funo.
Digite a url em que a sua aplicao estar disponvel para acesso na

internet.
Informe o endereo (URL) da sua logomarca ou faa upload do

arquivo de imagem.
Logomarca
Obs.: Mximo de 500kbytes, Formatos aceitos: JPG, GIF, PNG, BMP.

Sua logomarca poder ser reduzida para as propores mximas de
150 x 55 pixels.
URL de notificao
Digite a url em que voc receber as notificaes feitas em sua

aplicao.
URL de redirecionamento
Digite a url que o usurio ir ser levado aps a finalizao do

pagamento.
Tambm possvel habilitar o redirecionamento com o cdigo de transao. Com a opo habilitada, o
PagSeguro ir enviar como parmetro, via GET, o cdigo da autorizao que foi gerado. Sua aplicao poder
utilizar esse cdigo para exibir informaes da autorizao ao cliente.
Caso habilite esta opo, voc poder escolher o nome do parmetro GET que ser utilizado conforme a
Imagem 2.
Imagem 2
VERSO 1.0.4
MODELO DE APLICAES
Aps criar a sua aplicao ser apresentado um resumo com os dados da aplicao, inclusive a chave da sua
aplicao (ou appKey) como apresentado na Imagem 3.
Imagem 3
Ateno: Guarde bem a sua chave de aplicao, pois ela essencial para que voc possa
efetuar as iteraes com as APIs de Pagamento e Assinatura.
Aps guardar bem a sua chave da aplicao, voc pode clicar em Ir para Minhas Aplicaes para visualizar
a listagem de aplicaes. A listagem apresentada conforme a Imagem 4.
Imagem 4
VERSO 1.0.4
10
MODELO DE APLICAES
Voc pode editar as informaes da sua aplicao, inclusive gerar uma nova appKey a qualquer momento
clicando em Editar aplicao > Gerar nova chave. Com exceo do ID da aplicao, todos os campos da
aplicao so editveis.
Tambm possvel excluir uma aplicao. Ao excluir uma aplicao, todas as permisses concedidas a ela
so perdidas, ou seja:
Ela no poder mais criar checkouts

Ela no poder mais receber pagamentos a partir de checkouts criados antes da remoo
Ela poder continuar recebendo notificaes
Ela no ser exibida mais na listagem de aplicaes do integrador
Ela no ser mais exibida na listagem de autorizaes concedidas
Autorizao
Aps criar uma aplicao voc poder pedir a autorizao do seu cliente para criar checkout, criar
assinaturas, efetuar consultas entre outras aes em.
O fluxo de autorizao exemplificado na Imagem 5:
Imagem 5
VERSO 1.0.4
11
MODELO DE APLICAES
Informando os dados da requisio

A requisio API de Autorizaes feita informando os dados de autorizao via XML em conjunto com os
parmetros de autenticao da sua aplicao (appId e appKey) utilizando o mtodo POST.
URL da API de Autorizaes do PagSeguro:
POST https://ws.pagseguro.uol.com.br/v2/authorizations/request?appId={appId}
&appKey={appKey}
Parmetros de autenticao
PARMETRO
DESCRIO
appId
ID da Aplicao.
Presena: Obrigatria.
Tipo: Texto.
Formato: Uma sequncia de at 60 caracteres.
appKey
Especifica o token correspondente aplicao PagSeguro que est

realizando a requisio.
Tipo: Texto.
Formato: Uma sequncia de 32 caracteres.
Veja abaixo os cabealhos HTTP necessrios para fazer uma requisio API de autorizao do PagSeguro
informando os dados no formato XML.
O cabealho Content-Type deve ser informado como no exemplo abaixo:
Content-Type: application/xml; charset=ISO-8859-1
Observao: caso sua aplicao ou loja no utilize o conjunto de caracteres ISO-8859-1, p.e.(UTF-8),
necessrio substituir o parmetro charset do exemplo acima.
Veja abaixo exemplo de XML estruturado para representar os dados de uma requisio:
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<authorizationRequest>
<reference>REF1234</reference>
<permissions>
<code>CREATE_CHECKOUTS</code>
<code>RECEIVE_TRANSACTION_NOTIFICATIONS</code>
<code>SEARCH_TRANSACTIONS</code>
<code>MANAGE_PAYMENT_PRE_APPROVALS</code>
</permissions>
<redirectURL>http://seusite.com.br/redirect</redirectURL>
<notificationURL>http://seusite.com.br/notification</notificationURL>
</authorizationRequest>
Parmetros de requisio
VERSO 1.0.4
12
MODELO DE APLICAES
Os parmetros esperados pela API de Requisio so Case sensitive e esto descritos na tabela abaixo:
PARMETRO XML
<reference>
DESCRIO
Identificador usado para fazer referncia autorizao da sua requisio.
Presena: Opcional.
Tipo: Texto.
Formato: Livre, com limite total de 20 caracteres.
Permisses a serem autorizadas
Tipo: Texto.
Valores aceitos:
VALOR
DESCRIO
A aplicao poder direcionar
compradores para o PagSeguro
e intermediar pagamentos
RECEIVE_TRANSACTION_NOTIFICATIONS A aplicao poder receber e
consultar notificaes das
transaes que ela intermediou
SEARCH_TRANSACTIONS
A aplicao poder consultar as
MANAGE_PAYMENT_PRE_APPROVALS
A aplicao poder gerenciar e
utilizar pr-aprovaes de
pagamentos
DIRECT_PAYMENT
A aplicao poder gerenciar
pagamentos via checkout
transparente.
Ateno: necessrio liberao
atravs da rea comercial do
PagSeguro
CREATE_CHECKOUTS
<permissions>
<redirectURL>
URL para onde o comprador ser redirecionado aps a finalizao do fluxo de

autorizao. Caso seja informado na chamada, ser utilizada esta ao invs da
URL informada no cadastro da aplicao.
Tipo: Texto.
Formato: Uma URL vlida, com limite de 255 caracteres.
<notificationURL>
URL para onde a notificao ser direcionada aps a finalizao do fluxo de

autorizao. Caso seja informado na chamada, ser utilizada esta ao invs da
URL informada no cadastro da aplicao.
Tipo: Texto.
Formato: Uma URL vlida, com limite de 255 caracteres.
VERSO 1.0.4
13
MODELO DE APLICAES
Dados do cliente e sugesto para cadastro

Ao criar uma autorizao voc tambm pode encaminhar os dados do cliente. Assim, caso o e-mail do
vendedor enviado via API j esteja cadastrado na base, ser sugerido o login com este e-mail. Caso ele no
tenha conta, os dados sero utilizados como sugesto para o cadastro e assim facilitando o cadastro do
cliente.
Ateno: uantos mais dados corretos forem informados, maior a chance de converso
do vendedor no cadastrado nesse fluxo.
possvel encaminhar os dados tanto de um cliente Vendedor (utilizando CPF) quanto para um cliente
Empresarial (Utilizando o CNPJ).
Veja abaixo exemplo de XML estruturado para representar os dados de uma autorizao com a sugesto de
uma conta Vendedor:
1. <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
2. <authorizationRequest>
3.
<reference>123</reference>
4.
<permissions>
5.
6.
7.
8.
</permissions>
9.
10.
11.
<account>
12.
<email>usuario@seusite.com.br</email>
13.
<type>SELLER</type>
14.
<person>
15.
<name>Antonio Carlos</name>
16.
<documents>
17.
<document>
18.
<type>CPF</type>
19.
<value>23606838450</value>
20.
</document>
21.
</documents>
22.
<birthDate>1982-02-05</birthDate>
23.
<phones>
24.
<phone>
25.
<type>HOME</type>
26.
<areaCode>11</areaCode>
27.
<number>30302323</number>
28.
</phone>
29.
<phone>
VERSO 1.0.4
14
MODELO DE APLICAES
30.
<type>MOBILE</type>
31.
32.
33.
</phone>
34.
</phones>
35.
<address>
36.
<postalCode>01452002</postalCode>
37.
<street>Av. Brig. Faria Lima</street>
38.
39.
<complement>5o andar</complement>
40.
<district>Jardim Paulistano</district>
41.
<city>Sao Paulo</city>
42.
<state>SP</state>
43.
<country>BRA</country>
44.
</address>
45.
46.
</person>
</account>
47. </authorizationRequest>
Veja abaixo exemplo de XML estruturado para representar os dados de uma autorizao com a sugesto de
uma conta Empresarial:
1. <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
3.
4.
<permissions>
5.
6.
</permissions>
7.
8.
9.
<account>
10.
<email>usuario@seusite.com.br</email>
11.
<type>COMPANY</type>
12.
<company>
13.
14.
15.
<name>Seu Site</name>
<documents>
<document>
16.
<type>CNPJ</type>
17.
<value>17302417000101</value>
18.
19.
</document>
</documents>
20.
<displayName>Seu Site</displayName>
21.
<websiteURL>http://www.seusite.com.br</websiteURL>
22.
<partner>
23.
VERSO 1.0.4
<name>Antonio Carlos</name>
15
MODELO DE APLICAES
24.
<documents>
25.
<document>
26.
<type>CPF</type>
27.
<value>34163749160</value>
28.
</document>
29.
</documents>
30.
<birthDate>1982-02-05</birthDate>
31.
</partner>
32.
<phones>
33.
<phone>
34.
<type>BUSINESS</type>
35.
36.
37.
</phone>
38.
<phone>
39.
<type>BUSINESS</type>
40.
41.
42.
</phone>
43.
</phones>
44.
<address>
45.
<postalCode>01452002</postalCode>
46.
<street>Av. Brig. Faria Lima</street>
47.
48.
<complement>5o andar</complement>
49.
<district>Jardim Paulistano</district>
50.
<city>Sao Paulo</city>
51.
<state>SP</state>
52.
<country>BRA</country>
53.
</address>
54.
</company>
55.
</account>
Os parmetros abaixo ficam aninhados dentro da tag <authorizationRequest>.
PARMETRO XML
DESCRIO
<account>
Este campo a raiz do arquivo XML e engloba os dados do cadastro.

Presena: Opcional.
<account>
<email>
Conta a ser cadastrada
VERSO 1.0.4
16
MODELO DE APLICAES
PARMETRO XML
DESCRIO
Presena: Opcional.
Tipo: Texto.
Formato: um e-mail vlido (p.e., usuario@site.com.br), com no
mximo 60 caracteres.
<account>
<type>
Tipo da conta.
Presena: Opcional.
Tipo: Texto.
Formato: Os tipos de contas so: PERSONAL, SELLER ou COMPANY
<account>
<person>
Agrupa os dados de vendedor.
<account>
<seller>
<name>
Nome completo do vendedor
<account>
<seller>
<documents>
Agrupa a informao de documento do vendedor.
<account>
<seller>
<documents>
<document>
Agrupa a informao de documento do vendedor.

Presena: Opcional (CPF).
<account>
<seller>
<documents>
<document>
<type>
Tipo do documento
<account>
<seller>
<documents>
<document>
<type>
<value>
CPF do vendedor
<account>
<seller>
<birthDate>
Data de nascimento do Vendedor
VERSO 1.0.4
Presena: Opcional.
Tipo: Texto.
Formato: Livre, com o limite de 50 caracteres.
Presena: Obrigatria, se informada a tag document.

Tipo: Texto.
Formato: O tipo documento permitido para o vendedor somente
CPF
Presena: Obrigatria, se informada a tag document.

Tipo: Nmero.
Formato: Aceitar apenas nmeros de CPF vlidos e no restritos (no
PagSeguro/UOL).
Presena: Opcional.
Tipo: Texto.
Formato: DD/MM/AAAA.
17
MODELO DE APLICAES
PARMETRO XML
DESCRIO
<account>
<seller>
<phones>
Agrupa as informaes de telefone do vendedor.
<account>
<seller>
<phones>
<phone>
Agrupa as informaes de telefone do vendedor.

Presena: Opcional.
Tipo de telefone
<account>
<seller>
<phones>
<phone>
<type>
Presena : Obrigatria, se informada a tag phone.

Tipo: Texto.
Formato: Os tipos de telefone permitidos so HOME, MOBILE e
BUSINESS.
<account>
<seller>
<phones>
<phone>
<areaCode>
Cdigo de rea do telefone
<account>
<seller>
<phones>
<phone>
<number>
Nmero do telefone
<account>
<company>
Agrupa os dados de empresa
<account>
<company>
<displayName>
Nome completo da empresa
<account>
<company>
<documents>
Agrupa as informaes de documentos do responsvel legal pela

empresa e empresa
<account>
<company>
<documents>
<document>
Agrupa as informaes de documentos do responsvel legal pela

empresa e empresa
Presena: Opcional (CPF e CNPJ)
VERSO 1.0.4
Presena: Obrigatria, se informada a tag phone.

Tipo: Nmero.
Formato: Um nmero de 2 dgitos correspondente a um DDD vlido.
Presena: Obrigatria, se informada a tag phone.

Tipo: Nmero.
Formato: Aceita apenas nmeros de 8 a 9 dgitos.
Presena: Opcional.
Tipo: Texto.
18
MODELO DE APLICAES
PARMETRO XML
DESCRIO
<account>
<company>
<documents>
<document>
<type>
CNPJ da empresa
<account>
<company>
<websiteURL>
URL do website da empresa
<account>
<company>
<partner>
Agrupa os dados do responsvel legal pela empresa.
<account>
<company>
<partner>
<name>
Nome do responsvel legal pela empresa
<account>
<seller>
<documents>
<document>
<type>
<value>
CPF do vendedor
<account>
<company>
<partner>
<birthDate>
Data de nascimento do Vendedor
<account>
<address>
Agrupa os dados de endereo do vendedor ou empresa.
Presena: Obrigatria se informada a tag document.

Tipo: Nmero.
Formato: Aceitar apenas nmeros de CNPJ vlidos e no restritos
(no PagSeguro/UOL).
Presena: Opcional.
Tipo: Texto.
Formato: Uma URL vlida com no mximo 256 caracteres.
Presena: Opcional.
Tipo: Texto.
Presena: Obrigatria se informada a tag document.

Tipo: Nmero.
Formato: Quando o type for CPF aceitar apenas nmero de CPF
vlido e no restrito (no PagSeguro/UOL).
Presena: Opcional.
Tipo: Texto.
Formato: DD/MM/AAAA.
Presena: Opcional.
<account>
<address>
<postalCode>
VERSO 1.0.4
CEP do endereo do vendedor ou da empresa.

Presena: Opcional.
Tipo: Nmero.
Formato: Um nmero de 8 dgitos correspondente a um CEP vlido.
19
MODELO DE APLICAES
PARMETRO XML
DESCRIO
<account>
<address>
<street>
Nome da rua do endereo do vendedor ou da empresa.
<account>
<address>
<number>
Nmero do endereo do vendedor ou da empresa.
<account>
<address>
<complement>
Complemento do endereo do vendedor ou da empresa.
<account>
<address>
<district>
Bairro do endereo do vendedor ou da empresa.
<account>
<address>
<city>
Cidade do endereo do vendedor ou da empresa.
<account>
<address>
<state>
Estado do endereo do vendedor ou da empresa.
VERSO 1.0.4
Presena: Opcional.
Tipo: Texto.
Formato: Texto com nmeros, letras (sem acento), espaos e os
caracteres . (ponto) e - hfen, com no mximo 80 caracteres.
O valor deste campo s ser cadastrado quando CEP informado no
tiver nome de rua associado.
Presena: Opcional.
Tipo: Texto.
Formato: Texto livre com no mximo 20 caracteres.
Presena: Opcional.
Tipo: Texto.
Presena: Opcional.
Tipo: Texto.
O valor deste campo s ser cadastrado quando CEP informado no
tiver bairro associado.
Presena: Opcional.
Tipo: Texto.
Formato: Texto livre. Ser cadastrada a cidade associada ao CEP
informado.
Presena: Opcional.
Tipo: Texto.
Formato: Texto livre. Ser cadastrado o estado associado ao CEP
informado.
20
MODELO DE APLICAES
PARMETRO XML
<account>
<address>
<country>
DESCRIO
Cdigo ISO do pas do endereo do vendedor ou da empresa
Presena: Opcional.
Tipo: Texto.
Formato: de 2 a 10 nmeros, letras e o caractere - (hfen).
Resposta da API de Autorizao

A resposta dada em formato XML. O exemplo abaixo mostra uma resposta de sucesso a uma chamada
API de autorizao:
2.
<code>D8DD848AC9C98D9EE44C5FB3A1E53913</code>
3.
<date>2011-02-25T11:40:50.000-03:00</date>
As tabelas abaixo descrevem os parmetros retornados.

PARMETRO
<code>
DESCRIO
Raiz do arquivo XML de resposta. Contm os dados do cdigo de
autorizao criado.
Cdigo de redirecionamento criado. Este cdigo deve ser usado para
direcionar o comprador para o fluxo de autorizao.
Tipo: Texto.
Data da requisio.
<date>
Tipo: Data/Hora.
Formato: YYYY-MM-DDThh:mm:ss.sTZD.
Caso ocorra algum erro na chamada API de Autorizao uma resposta de erro ser retornada, como no
exemplo abaixo. Ela indicar todos os erros identificados na chamada:
1. <errors>
2.
<error>
3.
<code>11064</code>
4.
<message>redirectURL must have the same domain as application URL.</message>
5.
</error>
6. </errors>
VERSO 1.0.4
21
MODELO DE APLICAES
As tabelas abaixo descrevem os parmetros retornados.

PARMETRO
DESCRIO
<errors>
Lista de erros.
<errors>
<error>
Dados do erro encontrado.
<errors>
<error>
<code>
Cdigo do erro.
Tipo: Texto.
Formato: Ver Tabela de Erros na pgina 34.
< errors >

<error >
<message>
Mensagem descritiva.
Tipo: Texto.
Direcionando o comprador para o fluxo de autorizao

Aps realizar uma chamada com sucesso API, voc deve direcionar o comprador para o fluxo de
autorizao, usando o cdigo de requisio retornado. O exemplo abaixo mostra uma URL montada para
que o usurio inicie um fluxo de autorizao.
https://pagseguro.uol.com.br/v2/authorization/request.jhtml?code={resquestCode}
A tabela abaixo descreve o parmetro utilizado

PARMETRO
Code
DESCRIO
Cdigo de requisio retornado pela chamada API de autorizao
do PagSeguro
Presena: Obrigatria
Fluxo de autorizao
Ao realizar a chamada com sucesso API de autorizao e redirecionar o cliente ao PagSeguro, ser exibido
uma tela com base nas informaes que voc encaminhou na chamada.
Se voc no encaminhou nenhum dado do cliente ou encaminhou os dados e o PagSeguro verificou que este
cliente no possui uma conta no PagSeguro, ser apresentado uma tela propondo a criao de uma conta
primariamente e abaixo a opo de efetuar o login no PagSeguro conforme a Imagem 6 abaixo:
VERSO 1.0.4
22
MODELO DE APLICAES
Imagem 6
Se voc encaminhou os dados e o PagSeguro verificou que este cliente possui uma conta no PagSeguro, ser
apresentado os campos para que ele possa efetuar o login no PagSeguro primariamente e abaixo a opo
propondo a criao de uma conta conforme a Imagem 7 abaixo:
Imagem 7
VERSO 1.0.4
23
MODELO DE APLICAES
Aps ter criado a conta ou ter entrado com sua senha, ser apresentado uma tela informando ao cliente que
a sua aplicao deseja ter acesso s permisses enviadas na chamada de autorizao. apresentada
tambm ao cliente a explicao de cada uma das permisses e a opo de autorizar ou no a aplicao
conforme a Imagem 8 abaixo:
Imagem 8
Aps a deciso do cliente, clicando em Autorizar ou No autorizar, ele ser redirecionado para a sua URL de
retorno. Neste retorno o PagSeguro encaminha via GET o cdigo de notificao da autorizao para que
voc possa consultar na hora o resultado desta autorizao.
O retorno ser feito como o exemplo a seguir:
GET http://www.seusite.com.br/retorno?notificationCode={notificationCode}
Alm disso, o PagSeguro envia uma notificao para o seu site via POST.
Notificaes
Aps o comprador autorizar a aplicao, o PagSeguro enviar via POST uma notificao ao seu sistema com
o status da autorizao.
A Imagem 9 ilustra o funcionamento da notificao. Note que o PagSeguro que inicia o processo de
notificao ao enviar um cdigo para seu sistema.
VERSO 1.0.4
24
MODELO DE APLICAES
Imagem 9
Configurando o recebimento de notificaes

Para utilizar a API de Notificaes voc deve primeiramente ter criado uma aplicao. O endereo (URL) de
notificao configurado no momento da criao da aplicao, porm pode ser passado tambm como
parmetro na chamada como vimos anteriormente.
A visualizao ou alterao desta URL em uma aplicao j existente pode ser feito atravs da pgina de
listagem de aplicaes no endereo https://pagseguro.uol.com.br/aplicacao/listagem.jhtml, clicando no
boto Editar aplicao.
Recebendo uma notificao de autorizao

Uma vez configurado o endereo para onde o PagSeguro ir enviar notificaes, o prximo passo preparar
seu sistema para receber o cdigo de notificao.
O PagSeguro envia as notificaes para a URL que voc configurou usando o protocolo HTTP, pelo
mtodo POST.
Veja abaixo um exemplo de notificao enviada pelo PagSeguro (as linhas foram quebradas para facilitar a
leitura):
POST http://lojamodelo.com.br/notificacao HTTP/1.1
Host:pagseguro.uol.com.br
Content-Length:85
Content-Type:application/x-www-form-urlencoded
notificationCode=766B9C-AD4B044B04DA-77742F5FA653-E1AB24
&notificationType=applicationAuthorization
VERSO 1.0.4
25
MODELO DE APLICAES
PARMETRO
notificationCode
DESCRIO
O cdigo que identifica a notificao. Este cdigo deve ser usado
para consultar a notificao e obter os dados da
transao/assinatura associada. Note que o cdigo que identifica a
notificao no o mesmo que o cdigo que identifica a transao.
Tipo: Texto.
O tipo da notificao enviada.
notificationType
Tipo: Texto.
Formato: Para notificaes de autorizao ser
applicationAuthorization
Note que a notificao no possui nenhuma informao sobre a autorizao. Portanto, assim que seu
sistema recebe uma notificao, ele deve consulta-la para obter os dados, como descrito adiante.
Lembre-se que, enquanto seu sistema no consultar uma notificao enviada, o PagSeguro ir envia-la
novamente a cada 2 horas, at um mximo de 5 tentativas. Se seu sistema ficou indisponvel por um
perodo maior que este e no recebeu nenhum dos envios da notificao, ainda assim possvel obter os
dados de suas autorizaes usando a Consulta de Autorizaes.
Consultas
O PagSeguro conta com uma API de Consultas para que voc possa obter os dados de suas autorizaes de
forma fcil, rpida e segura.
Veja abaixo como efetuar uma consulta:
Consultando uma autorizao pelo cdigo de notificao

Esta consulta deve ser utilizada para consultar uma notificao recebida atravs do POST encaminhado pelo
PagSeguro ou atravs do parmetro GET (notificationCode) encaminhado atravs do redirect da pgina de
autorizao do PagSeguro a fim de obter os dados da autorizao. A chamada deve ser efetuada utilizando o
mtodo GET.
URL de consulta:
https://ws.pagseguro.uol.com.br/v2/authorizations/notifications/{notificationCode}?appId={appId}&a
ppKey={appKey}
VERSO 1.0.4
26
MODELO DE APLICAES
PARMETRO
DESCRIO
ID da Aplicao.
appId
Tipo: Texto.
appKey
Tipo: Texto.
PARMETRO
DESCRIO
Cdigo identificador da notificao.
notificationCode (aps notifications/)
Informa o cdigo da notificao que voc quer consultar. O cdigo

deve ser informado no caminho da URL. Voc deve usar o cdigo
que recebeu pelo parmetro notificationCode no envio da
notificao.
Tipo: Texto.
Consultando uma autorizao pelo seu cdigo

Esta consulta possibilita o acesso a todos os dados de uma autorizao a partir de seu cdigo identificador. A
chamada deve ser efetuada utilizando o mtodo GET.
URL de consulta:
https://ws.pagseguro.uol.com.br/v2/authorizations/{authorizationCode}?appId={appId}&appKey={appKey
}
VERSO 1.0.4
27
MODELO DE APLICAES
PARMETRO
DESCRIO
ID da Aplicao.
appId
Tipo: Texto.
appKey
Tipo: Texto.
PARMETRO
authorizationCode (aps
authorizations /)
DESCRIO
Cdigo que identifica a autorizao a ser consultada/cancelada.
Presena: Obrigatria na consulta de uma autorizao.
Tipo: Texto.
Para ambas as consultas acima, a resposta dada em formato XML, como no exemplo abaixo.
1. <authorization>
2.
<code>9D7FF2E921216F1334EE9FBEB7B4EBBC</code>
3.
<creationDate>2011-03-30T14:20:13.000-03:00</creationDate>
4.
<reference>REF1234</reference>
5.
<account>
6.
<publicKey>PUB9B3227C6228848ACBFFCF46DD04C3211</publicKey>
7.
</account>
8.
<permissions>
9.
<permission>
10.
11.
<status>APPROVED</status>
12.
<lastUpdate>2011-03-30T15:35:44.000-03:00</lastUpdate>
13.
</permission>
14.
<permission>
15.
16.
17.
18.
</permission>
19.
</permissions>
20. </authorization>
VERSO 1.0.4
28
MODELO DE APLICAES
As tabelas abaixo descrevem os parmetros retornados pelas consultas.

PARMETRO
<authorization>
DESCRIO
Raiz do arquivo XML de resposta. Contm os dados da autorizao.
<authorization>
<code>
Cdigo de autorizao.
Tipo: Texto.
<authorization>
<creationDate>
Data da criao da autorizao

Tipo: Texto.
<authorization>
<reference>
Identificador que foi usado para fazer referncia autorizao no momento

de sua requisio.
Tipo: Data/Hora.
<authorization>
<account>
<publicKey>
<authorization>
<permissions>
<authorization>
<permissions>
<permission>
Chave pblica do vendedor.

Tipo: Texto.
Representa as permisses retornadas pela autorizao.

Tipo: Texto.
Dados de uma permisso retornada pela consulta.

Tipo: Texto.
Cdigo da permisso.
Tipo: Texto.
Valor
Descrio
A aplicao poder direcionar
compradores para o PagSeguro
e intermediar pagamentos para
voc
RECEIVE_TRANSACTION_NOTIFICATIONS A aplicao poder receber e
consultar notificaes das
para voc
SEARCH_TRANSACTIONS
A aplicao poder consultar as
para voc
A aplicao poder gerenciar e
utilizar pr-aprovaes de
pagamentos para voc
CREATE_CHECKOUTS
<authorization>
<permissions>
<permission>
<code>
VERSO 1.0.4
29
MODELO DE APLICAES
PARMETRO
DESCRIO
Status da permisso do cliente.
Tipo: Texto.
<authorization>
<permissions>
<permission>
<status>
Valor
PENDING
APPROVED
DENIED
<authorization>
<permissions>
<permission>
<lastUpdate>
Descrio
Pendente de aprovao
Aprovado pelo cliente
Negado pelo cliente
Data/hora em que ocorreu a ltima alterao no status da permisso.

Tipo: Texto.
Consulta de autorizaes da aplicao por data

Atravs desta consulta voc poder verificar todas as autorizaes atreladas a sua aplicao dentro de um
determinado perodo. Para isso deve ser informado as credenciais, alm do range de data da consulta com o
intervalo mximo de 90 dias.
URL de consulta (As linhas foram quebradas para melhor visualizao):
GET https://ws.pagseguro.uol.com.br/v2/authorizations
?appId={appId}
&appKey={appKey}
&initialDate=2014-11-01T00:00&finalDate=2014-11-28T00:00
O resultado apresentado em XML conforme o exemplo abaixo:

1. <authorizationSearchResult>
2.
<date>2014-11-02T11:09:11.000-03:00</date>
3.
<authorizations>
4.
<authorization>
5.
<code>5A220D39B3B31E8BB4E3EFA4FCC4E6A3</code>
6.
<creationDate>2014-11-01T16:32:21.000-03:00</creationDate>
7.
8.
9.
10.
11.
<account>
<publicKey>PUB9B3227C6228848ACBFFCF46DD04C3211</publicKey>
</account>
<permissions>
12.
<permission>
13.
14.
15.
16.
</permission>
17.
<permission>
18.
19.
20.
VERSO 1.0.4
30
MODELO DE APLICAES
21.
</permission>
22.
<permission>
23.
24.
25.
26.
</permission>
27.
</permissions>
28.
29.
</authorization>
</authorizations>
30. </authorizationSearchResult>
As tabelas abaixo descrevem os parmetros retornados pelas consultas.

PARMETRO
DESCRIO
<authorizationSearchResult>
Raiz do arquivo XML de resposta. Contm os dados da consulta de

autorizaes.
<date>
Informa a data/hora em que a consulta foi realizada.
<authorizations>
<authorization>
Contm os dados da autorizao.
<authorizations>
<authorization>
<code>
Cdigo de autorizao.
Tipo: Texto.
<authorizations>
<authorization>
<creationDate>
Data da criao da autorizao

Tipo: Texto.
<authorizations>
<authorization>
<reference>
Identificador que foi usado para fazer referncia autorizao no

momento de sua requisio.
Tipo: Data/Hora.
<authorizations>
<authorization>
<reference>
<account> <publicKey>
Chave pblica do vendedor.

Tipo: Texto.
<authorizations>
<authorization>
<permissions>
Representa as permisses retornadas pela autorizao.

Tipo: Texto.
VERSO 1.0.4
31
MODELO DE APLICAES
PARMETRO
<authorizations>
<authorization>
<permissions>
<permission>
DESCRIO
Dados de uma permisso retornada pela consulta.

Tipo: Texto.
Cdigo da permisso.
Tipo: Texto.
Valor
<authorizations>
<authorization>
<permissions>
<permission>
<code>
<authorizations>
<authorization>
<permissions>
<permission>
<status>
<authorizations>
<authorization>
<permissions>
<permission>
<lastUpdate>
VERSO 1.0.4
Descrio
CREATE_CHECKOUTS
A aplicao poder
direcionar
compradores para o
PagSeguro e
intermediar
pagamentos para voc
RECEIVE_TRANSACTION_NOTIFICATIONS A aplicao poder
receber e consultar
notificaes das
transaes que ela
intermediou para voc
SEARCH_TRANSACTIONS
A aplicao poder
consultar as
transaes que ela
intermediou para voc
A aplicao poder
gerenciar e utilizar
pr-aprovaes de
pagamentos para voc
Status da permisso do cliente.

Tipo: Texto.
Valor
PENDING
APPROVED
DENIED
Descrio
Pendente de aprovao
Aprovado pelo cliente
Negado pelo cliente
Data/hora em que ocorreu a ltima alterao no status da

permisso.
Tipo: Texto.
32
MODELO DE APLICAES
Caso ocorra algum erro na chamada API de Consultas, seja algum erro nos parmetros informados ou
alguma falha tcnica no sistema, uma resposta de erro ser retornada, como no exemplo abaixo. Ela indicar
todos os erros identificados na chamada:
1. <errors>
2.
<error>
3.
<code>13014</code>
4.
<message>maxPageResults invalid value (must be between 1 and 1000).</message>
5.
</error>
6. </errors>
Abaixo so descritos os campos do XML de resposta da consulta a uma notificao de transao.

PARMETRO
DESCRIO
<errors>
Lista de erros.
<errors>
<error>
Dados do erro encontrado.
<errors>
<error>
<code>
Cdigo do erro.
Tipo: Texto.
<errors>
<error>
<message>
Mensagem descritiva.
Tipo: Texto.
Utilizando as APIs do PagSeguro

Aps obter a autorizao, sua aplicao possui a possibilidade de utilizar os servios do PagSeguro em nome
do vendedor.
Para utilizar as APIs do PagSeguro utilizando a autorizao concedida pelo cliente, basta que voc substitua
as credenciais email e token pelas credenciais appId, appKey e pelo authorizationCode gerado pela
aplicao.
Veja abaixo como utilizar as APIs disponveis no PagSeguro com o Modelo de Aplicao:
API de Pagamentos
Sem a utilizao do Modelo de Aplicaes, a chamada para o PagSeguro feita utilizando o e-mail e token
do cliente. Veja abaixo um exemplo da chamada sem o Modelo de Aplicaes para a API de Pagamentos (as
linhas foram quebradas para facilitar a leitura):
VERSO 1.0.4
MODELO DE APLICAES
33
curl https://ws.pagseguro.uol.com.br/v2/checkout/ -d\

"email=suporte@lojamodelo.com.br\
&token=95112EE828D94278BD394E91C4388F20\
&currency=BRL\
&itemId1=0001\
&itemDescription1=Notebook Prata\
&itemAmount1=24300.00\
&itemQuantity1=1\
&itemWeight1=1000\
&reference=REF1234\
&senderName=Jose Comprador\
&senderAreaCode=11\
&senderPhone=56273440\
&senderEmail=comprador@uol.com.br\
&shippingType=1\
&shippingAddressStreet=Av. Brig. Faria Lima\
&shippingAddressNumber=1384\
&shippingAddressComplement=5o andar\
&shippingAddressDistrict=Jardim Paulistano\
&shippingAddressPostalCode=01452002\
&shippingAddressCity=Sao Paulo\
&shippingAddressState=SP\
&shippingAddressCountry=BRA"
Com a utilizao do Modelo de Aplicaes, a chamada para o PagSeguro feita utilizando o appId, o appKey
e o authorizationCode do cliente. Veja abaixo um exemplo da mesma chamada utilizando o Modelo de
Aplicaes (as linhas foram quebradas para facilitar a leitura):
curl https://ws.pagseguro.uol.com.br/v2/checkout/ -d\
"appId=lojamodelo\
&appKey=CAD9C79F4141DF222401CF940D6F0682\
&authorizationCode=D8DD848AC9C98D9EE44C5FB3A1E53913\
&currency=BRL\
&itemId1=0001\
&itemDescription1=Notebook Prata\
&itemAmount1=24300.00\
&itemQuantity1=1\
&itemWeight1=1000\
&reference=REF1234\
&senderName=Jose Comprador\
&senderAreaCode=11\
&senderPhone=56273440\
&senderEmail=comprador@uol.com.br\
VERSO 1.0.4
MODELO DE APLICAES
34
&shippingType=1\
&shippingAddressStreet=Av. Brig. Faria Lima\
&shippingAddressNumber=1384\
&shippingAddressComplement=5o andar\
&shippingAddressDistrict=Jardim Paulistano\
&shippingAddressPostalCode=01452002\
&shippingAddressCity=Sao Paulo\
&shippingAddressState=SP\
&shippingAddressCountry=BRA"
API de Notificaes
A API de Notificaes a nica API onde no necessrio o authorizationCode. Veja abaixo um exemplo da
chamada para esta API sem o Modelo de (as linhas foram quebradas para facilitar a leitura):
https://ws.pagseguro.uol.com.br/v2/transactions/notifications
/9E884542-81B3-4419-9A75-BCC6FB495EF1
?email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20
Utilizando o modelo de aplicaes basta que voc passe, ao invs do e-mail e token do cliente, o appId e
appKey da sua aplicao conforme abaixo (as linhas foram quebradas para facilitar a leitura):
https://ws.pagseguro.uol.com.br/v2/transactions/notifications
/9E884542-81B3-4419-9A75-BCC6FB495EF1
?appId=lojamodelo
&appKey=D8DD848AC9C98D9EE44C5FB3A1E53913
API de Consultas
Veja abaixo um exemplo da chamada para esta API de Consulta de Transaes sem o Modelo de (as linhas
foram quebradas para facilitar a leitura):
https://ws.pagseguro.uol.com.br/v2/transactions
/9E884542-81B3-4419-9A75-BCC6FB495EF1
?email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20
VERSO 1.0.4
MODELO DE APLICAES
35
Utilizando o modelo de aplicaes basta que voc passe, ao invs do e-mail e token do cliente, o appId,
appKey e o authorizationCode conforme abaixo (as linhas foram quebradas para facilitar a leitura):
https://ws.pagseguro.uol.com.br/v2/transactions
/9E884542-81B3-4419-9A75-BCC6FB495EF1
?appId=lojamodelo
&appKey=D8DD848AC9C98D9EE44C5FB3A1E53913
&authorizationCode=D8DD848AC9C98D9EE44C5FB3A1E53913
O mesmo processo pode ser aplicado para as consultas de Histrico de transaes e para a consulta de
Transaes abandonadas.
Criao de Assinaturas
Veja abaixo um exemplo da chamada para esta API de Assinaturas sem o Modelo de (as linhas foram
quebradas para facilitar a leitura):
curl -k https://ws.pagseguro.uol.com.br/v2/pre-approvals/request -d\
"email=suporte@lojamodelo.com.br\
&token=95112EE828D94278BD394E91C4388F20\
&reference=REF1234\
&redirectURL=http://www.notebookprata.com.br/retorno.php\
&reviewURL=http://www.notebookprata.com.br/revisao.php\
&preApprovalCharge=manual\
&preApprovalName=Seguro contra roubo do Notebook Prata\
&preApprovalDetails=Seguro contra roubo do Notebook Prata.\
&preApprovalAmountPerPayment=100.00\
&preApprovalPeriod=Monthly\
&preApprovalDayOfMonth=28\
&preApprovalMaxPaymentsPerPeriod=1\
&preApprovalMaxAmountPerPeriod=100.00\
&preApprovalInitialDate=2013-09-01T00:00:000-03:00\
&preApprovalFinalDate=2013-12-01T00:00:000-03:00\
&preApprovalMaxTotalAmount=400.00
Com a utilizao do Modelo de Aplicaes, a chamada para o PagSeguro feita utilizando o appId, o appKey
e o authorizationCode do cliente. Veja abaixo um exemplo da mesma chamada utilizando o Modelo de
Aplicaes (as linhas foram quebradas para facilitar a leitura):
VERSO 1.0.4
36
MODELO DE APLICAES
curl -k https://ws.pagseguro.uol.com.br/v2/pre-approvals/request -d\

"appId=lojamodelo\
&appKey=CAD9C79F4141DF222401CF940D6F0682\
&authorizationCode=D8DD848AC9C98D9EE44C5FB3A1E53913\
&reference=REF1234\
&redirectURL=http://www.notebookprata.com.br/retorno.php\
&reviewURL=http://www.notebookprata.com.br/revisao.php\
&preApprovalCharge=manual\
&preApprovalName=Seguro contra roubo do Notebook Prata\
&preApprovalDetails=Seguro contra roubo do Notebook Prata.\
&preApprovalAmountPerPayment=100.00\
&preApprovalPeriod=Monthly\
&preApprovalDayOfMonth=28\
&preApprovalMaxPaymentsPerPeriod=1\
&preApprovalMaxAmountPerPeriod=100.00\
&preApprovalInitialDate=2013-09-01T00:00:000-03:00\
&preApprovalFinalDate=2013-12-01T00:00:000-03:00\
&preApprovalMaxTotalAmount=400.00
Outras APIs seguem o mesmo processo.
Revogao de autorizao
O seu cliente pode revogar a qualquer momento a autorizao concedida para a aplicao. Para isso, ele
deve acessar o link a seguir, selecionar a aplicao desejada e clicar em Remover autorizao conforme a
Imagem 10.
Link: https://pagseguro.uol.com.br/aplicacao/listarAutorizacoes.jhtml
Imagem 10
VERSO 1.0.4
37
MODELO DE APLICAES
Tabela de Erros
Caso sua aplicao informe algum dado incorreto ou fora do padro esperado pela aplicao, ser retornado
uma mensagem informando o problema. Confira abaixo os erros que podem ser retornados:
HTTP 401 - Unauthorized
Ocorre quando sua aplicao encaminhou uma credencial (e-mail ou token) invalida ou inexistente.
HTTP 405 Method Not Allowed
Ocorre quando sua aplicao efetuou a chamada utilizando um mtodo no esperado. Neste caso verifique
se o mtodo da chamada GET ou POST.
HTTP 415 Cannot consume content type
Ocorre quando no encaminhado o Content-Type na chamada.
HTTP 400 Bad Request
Ocorre quando um ou mais dados foram encaminhados de forma incorreta ou fora do padro. Este retorno
possui um XML no corpo na mensagem que identifica quais os erros presentes na chamada. O XML possui o
seguinte formato:
PARMETRO
DESCRIO
12001
appId is required.
12002
appKey is required.
12003
permissions is required.
12004
redirectURL is required.
12005
appId invalid length: {0}
12006
appKey invalid length: {0}
12007
reference invalid length: {0}
12008
permissions invalid length: {0}
12009
redirectURL must have the same domain as application URL.
12010
permissions invalid: {0}
12011
inactive application: {0}
12012
redirectURL invalid length: {0}
12013
redirectURL invalid value: {0}
50110
Date must be like yyyy-MM-dd
VERSO 1.0.4
38
MODELO DE APLICAES
PARMETRO
DESCRIO
50128
The telephone does not respect the 8 or 9 digit pattern
50129
The telephone area code must have 2 digits
50130
The postal code must have 8 digits
50132
The CPF must have 11 digits
50133
The CNPJ must have 14 digits
50134
Seller must be over 18 years old
50135
Partner must be over 18 years old
50136
Invalid e-mail
50137
Invalid user type
50140
Email too big. Maximum = 60 characters
50141
Name too big. Maximum = 50 characters
50142
Address too big. Maximum = 80 characters
50143
Address Number too big. Maximum = 20 characters
50144
Address Complement too big. Maximum = 40 characters
50145
Address District too big. Maximum = 60 characters
50146
Company Name too big. Maximum = 50 characters
50147
Display Name too big. Maximum = 50 characters
50148
Website URL too big. Maximum = 256 characters
VERSO 1.0.4

Pagseguro Modelo Aplicacoes

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Pagseguro Modelo Aplicacoes

Transféré par

Droits d'auteur :

Formats disponibles

Guia de Integrao

O PagSeguro prov todas as ferramentas necessrias para

Consulta de autorizaes da aplicao por data ................................................................ 29

Crie e gerencie uma aplicao.

Obtenha a permisso do seu cliente para criar checkouts, efetuar

Receba notificaes informando o status da autorizao e das

Faa consultas ao PagSeguro para acompanhar a qualquer

importante seguir os passos acima para o correto entendimento da ferramenta.

Voc tambm pode acessar diretamente a pgina de cadastro atravs do link

O ID da aplicao ser o cdigo que identifica esta aplicao no

Digite a url em que a sua aplicao estar disponvel para acesso na

Informe o endereo (URL) da sua logomarca ou faa upload do

Obs.: Mximo de 500kbytes, Formatos aceitos: JPG, GIF, PNG, BMP.

Digite a url em que voc receber as notificaes feitas em sua

Digite a url que o usurio ir ser levado aps a finalizao do

Ela no poder mais criar checkouts

Informando os dados da requisio

Especifica o token correspondente aplicao PagSeguro que est

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

URL para onde o comprador ser redirecionado aps a finalizao do fluxo de

URL para onde a notificao ser direcionada aps a finalizao do fluxo de

Dados do cliente e sugesto para cadastro

<street>Av. Brig. Faria Lima</street>

<street>Av. Brig. Faria Lima</street>

Este campo a raiz do arquivo XML e engloba os dados do cadastro.

Conta a ser cadastrada

Agrupa os dados de vendedor.

Nome completo do vendedor

Agrupa a informao de documento do vendedor.

Agrupa a informao de documento do vendedor.

Data de nascimento do Vendedor

Presena: Obrigatria, se informada a tag document.

Presena: Obrigatria, se informada a tag document.

Agrupa as informaes de telefone do vendedor.

Agrupa as informaes de telefone do vendedor.

Presena : Obrigatria, se informada a tag phone.

Cdigo de rea do telefone

Agrupa os dados de empresa

Nome completo da empresa

Agrupa as informaes de documentos do responsvel legal pela

Agrupa as informaes de documentos do responsvel legal pela

Presena: Obrigatria, se informada a tag phone.

Presena: Obrigatria, se informada a tag phone.

URL do website da empresa

Agrupa os dados do responsvel legal pela empresa.

Nome do responsvel legal pela empresa

Data de nascimento do Vendedor

Agrupa os dados de endereo do vendedor ou empresa.

Presena: Obrigatria se informada a tag document.

Presena: Obrigatria se informada a tag document.

CEP do endereo do vendedor ou da empresa.

Nome da rua do endereo do vendedor ou da empresa.

Nmero do endereo do vendedor ou da empresa.

Complemento do endereo do vendedor ou da empresa.

Bairro do endereo do vendedor ou da empresa.

Cidade do endereo do vendedor ou da empresa.

Estado do endereo do vendedor ou da empresa.

Resposta da API de Autorizao

As tabelas abaixo descrevem os parmetros retornados.

<message>redirectURL must have the same domain as application URL.</message>

As tabelas abaixo descrevem os parmetros retornados.

Dados do erro encontrado.

< errors >

Direcionando o comprador para o fluxo de autorizao