Perguntas Frequentes - Yampi Developer Portal

📡 Como funciona a estrutura de webhooks na Yampi?

A estrutura de webhooks da Yampi é flexível e orientada a eventos. Você pode registrar um único webhook para escutar múltiplos eventos, o que simplifica a integração e centraliza o tratamento de notificações.

Por exemplo, é possível utilizar a mesma URL para lidar com eventos como order.created e cart.reminder:

curl --request POST \
  --url https://api.dooki.com.br/v2/{alias}/webhooks \
  --header 'Content-Type: application/json' \
  --header 'User-Secret-Key: <api-key>' \
  --header 'User-Token: <api-key>' \
  --data '{
    "url": "https://suaurl.com/api/webhooks",
    "events": [
      "order.created",
      "cart.reminder"
    ],
    "name": "Nome do webhook"
  }'

Sempre que um evento for disparado, será feita uma requisição POST para a URL informada.
Sua aplicação deve responder com status 200 ou 201 em até 5 segundos — esse é o timeout recomendado.

A estrutura do payload recebido é a seguinte:

{
  "event": "order.status.updated",
  "time": "2025-05-12 12:11:19",
  "merchant": {
    "id": 109111,
    "alias": "teste-webhook"
  },
  "resource": {
    // Dados específicos do evento
  }
}

O campo event identifica o tipo do evento e resource contém os dados associados.

Com essa estrutura, sua integração se torna mais eficiente, escalável e segura.

🔗 Veja mais em Webhooks

🔐 O que é OAuth2?

📌 Suporte para Parceiros e Desenvolvedores

🛠️ Como usar a loja de testes?

🔌 Como integrar meu aplicativo à Yampi?

🛠️ Como acessar o Painel do Parceiro?

🔄 Como funciona a URL de redirecionamento?

📚 Onde encontro a documentação da API?

⏱️ Como funciona o rate-limit dos endpoints?

🤝 Quais plataformas integramos?

🧪 Minha conta de testes tem algum custo?

📘 Quais os principais retornos HTTP da API da Yampi?

🔁 Minha autenticação OAuth2 expira por inatividade do Lojista?

Não, o refresh_token tem validade de 30 dias. Enquanto estiver válido, você pode usá-lo para renovar o access_token sempre que necessário — lembrando que o access_token expira após 10 minutos.

O processo completo de autenticação só será necessário se o aplicativo não renovar os tokens antes do vencimento do refresh_token.

Ao atualizar o access_token, fazendo a chamada para /oauth/token, você também receberá um novo refresh_token.

Essa chamada de atualização é feita da seguinte forma:

POST 'https://auth.yampi.com.br/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'refresh_token=your-refresh-token' \
--data-urlencode 'grant_type=refresh_token' \
--data-urlencode 'client_id=your-app-client-id'

Ao executá-la com sucesso, ambos seus tokens serão atualizados automaticamente.

🔗 Atualize os tokens – Yampi API

​🔎 Qual sua dúvida?

🔎 Qual sua dúvida?