Como começar

1. Configure sua conta

Para integrar seu negócio com o PagSeguro você precisa ter uma conta do tipo Vendedor ou Empresarial.

2. Integração básica ou completa?

Integração básica (Botão de Pagamento)

Indicada para negócios com baixo volume de vendas, onde é possível gerenciar os produtos manualmente e controlar os pedidos por e-mail.

Saiba mais

Caso você tenha um volume maior de vendas, ou use um sistema de gestão de vendas ou de controle de estoque, o ideal é integrar seu sistema ao PagSeguro de forma completa, usando os recursos de automação oferecidos.

Documentação Referência da API

3. Autenticação (Token ou App)

Após ter criado a sua conta Vendedor/Empresarial no PagSeguro você poderá se identificar utilizando E-mail e Token ou Aplicação.

4. Faça seu primeiro checkout

PASSO 1: Requisição

URL em Produção: POST https://ws.pagseguro.uol.com.br/v2/checkout

URL em Sandbox: POST https://ws.sandbox.pagseguro.uol.com.br/v2/checkout

Atenção: Certifique-se que você está utilizando a URL correta em produção antes de iniciar as suas vendas.

Exemplo em Sandbox:

curl https://ws.sandbox.pagseguro.uol.com.br/v2/checkout -d\
  "email=(insira o seu email aqui)\
&token=(insira o token obtido no passo anterior aqui)\
&currency=BRL\
&itemId1=0001\
&itemDescription1=Produto PagSeguroI\
&itemAmount1=99999.99\
&itemQuantity1=1\
&itemWeight1=1000\
&itemId2=0002\
&itemDescription2=Produto PagSeguroII\
&itemAmount2=99999.98\
&itemQuantity2=2\
&itemWeight2=750\
&reference=REF1234\
&senderName=Jose Comprador\
&senderAreaCode=99\
&senderPhone=99999999\
&senderEmail=comprador@uol.com.br\
&shippingType=1\
&shippingAddressStreet=Av. PagSeguro\
&shippingAddressNumber=9999\
&shippingAddressComplement=99o andar\
&shippingAddressDistrict=Jardim Internet\
&shippingAddressPostalCode=99999999\
&shippingAddressCity=Cidade Exemplo\
&shippingAddressState=SP\
&shippingAddressCountry=ATA"

PASSO 2: Resposta da API de Pagamentos

<?xml version="1.0" encoding="ISO-8859-1"?>
<checkout>
  <code>8CF4BE7DCECEF0F004A6DFA0A8243412</code>
  <date>2010-12-02T10:11:28.000-02:00</date>
</checkout>

PASSO 3: Direcionando o comprador para o fluxo de pagamento

URL em Produção: GET https://pagseguro.uol.com.br/v2/checkout/payment.html?code=(insira o código da resposta da API de Pagamentos aqui)

URL em Sandbox: GET https://sandbox.pagseguro.uol.com.br/v2/checkout/payment.html?code=(insira o código da resposta da API de Pagamentos aqui)