Criação de checkout

O fluxo de criação de um checkout é bem simples, basicamente é necessário fazer uma autenticação com a conta de lojista no ambiente da Pagaleve, capturar esse token, para ser usado na chamada de criação de checkout, que irá retornar o checkout_id e a checkout_url para ser usada em qualquer tipo de integração front end.

Exemplos Práticos da API em ambiente Sandbox

1. Autenticação

Para obter um token de acesso, faça uma requisição POST para o endpoint de autenticação:

curl -X POST https://sandbox-api.pagaleve.io/v1/authentication \
  -H "Content-Type: application/json" \
  -d '{
    "username": "seu_email_merchant",
    "password": "sua_senha"
  }'

Resposta:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

2. Criação de Checkout

Com o token obtido, crie um checkout:

Importante preencher os campos na demonstração abaixo com os deeplinks para caso a compra esteja realizada com sucesso ou ou para qualquer outro caso que o cliente não realizado o pagamento, com os deeplinks da aplicação.

aprove_url: retorna quando a compra foi paga com sucesso
cancel_url: todos os casos em que a compra não foi paga

curl -X POST https://sandbox-api.pagaleve.io/v1/checkouts \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: pedido-123-$(date +%s)" \
  -d '{
    "approve_url": "seu-app://success",
    "cancel_url": "seu-app://cancel",
    "order": {
      "reference": "PEDIDO_123",
      "amount": 10000,
      "description": "Produto Exemplo",
      "items": [
        {
          "name": "Produto Exemplo",
          "price": 10000,
          "quantity": 1,
          "sku": "PROD_001"
        }
      ],
      "shipping": {
        "amount": 1000,
        "pickup": false,
        "address": {
          "name": "Casa",
          "street": "Rua Exemplo",
          "number": "123",
          "neighborhood": "Centro",
          "city": "São Paulo",
          "state": "SP",
          "zip_code": "01234567",
          "phone_number": "11987654321"
        }
      }
    },
    "shopper": {
      "first_name": "João",
      "last_name": "Silva",
      "email": "[email protected]",
      "phone": "11987654321",
      "cpf": "12345678901",
      "billing_address": {
        "name": "Endereço de Cobrança",
        "street": "Rua Exemplo",
        "number": "123",
        "neighborhood": "Centro",
        "city": "São Paulo",
        "state": "SP",
        "zip_code": "01234567",
        "phone_number": "11987654321"
      }
    }
  }'

Resposta:

{
  "checkout_url": "https://checkout.pagaleve.com.br/checkout/abc123...",
  "checkout_id": "checkout_id_aqui"
}

3. Utilize a checkout_url ob no App

Após capturar a checkout_url, adicione na uri da Webview, e após o cliente realizar o pagamento ou qualquer outro caso de cancelamento, no final dos processos, será chamado o aprove_url ou cancel_url, com o deeplink devidamente configurado na aplicação, pode ser enviado o cliente automaticamente para as páginas de sucesso ou pagamento.

Agora use a checkout_url recebida no seu WebView:

// React Native
<WebView
  source={{ uri: "https://checkout.pagaleve.com.br/checkout/abc123..." }}
/>

Esses mesmos campos estão presentes na URL completa, o que também pode ser alterado ou interceptado o comportamento pelo evento de onMessage da própria webview.