> ## Documentation Index
> Fetch the complete documentation index at: https://docs.easyfy.click/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar a Amazon

> Configure a integração com Amazon Associados via Creators API.

A Amazon Associados usa a **Creators API** (OAuth 2.0) para integrar contas de
afiliado. É a API oficial atual da Amazon.

<Note>
  A antiga PAAPI5 foi descontinuada em 15/05/2026. Se você ainda usa, migre
  para a Creators API para manter a geração automática de links com dados do
  produto.
</Note>

***

## Pré-requisitos

<Check>Estar aprovado no [Amazon Associados Brasil](https://associados.amazon.com.br).</Check>
<Check>Ter acesso à seção **Creators API** no portal.</Check>

## Onde pegar as credenciais

<Steps>
  <Step title="Acesse o portal de Associados">
    Entre em [associados.amazon.com.br](https://associados.amazon.com.br) com
    sua conta.
  </Step>

  <Step title="Vá até Ferramentas → Creators API">
    No menu superior, procure pela seção de APIs ou ferramentas de
    desenvolvedor.
  </Step>

  <Step title="Gere uma credencial">
    Clique em **Criar Credencial** e dê um nome (ex: "Easyfy"). A
    Amazon mostra a versão da credencial — pra contas Brasil aparece
    **2.1** ou **3.1** (ambas funcionam no Easyfy).
  </Step>

  <Step title="Copie os valores">
    Você receberá:

    * **Credential ID** — identificador da credencial
    * **Credential Secret** — segredo (mostrado **uma única vez**)
    * **Partner Tag** — sua tag de afiliado (ex: `seunome-20`)

    <Warning>
      Guarde o **Credential Secret** com cuidado. Se perder, é necessário gerar
      uma nova credencial.
    </Warning>
  </Step>
</Steps>

## Configurando no Easyfy

Vá em **Configurações → Credenciais → Amazon** e preencha:

| Campo            | Valor                                       |
| ---------------- | ------------------------------------------- |
| Versão           | A versão exibida no portal (`2.1` ou `3.1`) |
| ID da credencial | O ID copiado no passo anterior              |
| Segredo          | O segredo gerado                            |
| Partner Tag      | Sua tag de afiliado (`seunome-20`)          |

<Tip>
  Use **exatamente** a versão que aparece no portal Amazon Associados.
  Se for `3.1`, selecione `3.1`.
</Tip>

## Problemas comuns

<AccordionGroup>
  <Accordion title="'Não autorizado' ao testar a Creators API">
    Confira se a versão selecionada bate com a do portal (`2.1` ou
    `3.1`). O que NÃO funciona é misturar: credencial `3.1` com versão
    `2.1` selecionada, por exemplo.
  </Accordion>

  <Accordion title="Erro ao gerar link mesmo com credenciais corretas">
    A Creators API exige que a conta esteja aprovada no Amazon Associados.
    Contas em análise não têm acesso à API ainda — aguarde a aprovação.
    A elegibilidade também exige **pelo menos 10 vendas qualificadas
    nos últimos 30 dias**.
  </Accordion>

  <Accordion title="Posso usar a antiga PAAPI5?">
    Não. A PAAPI5 foi descontinuada em 15/05/2026. A Creators API é o único
    caminho oficial atual.
  </Accordion>

  <Accordion title="Qual versão escolher (2.1 ou 3.1)?">
    Ambas funcionam no Easyfy. Selecione a mesma que o portal Amazon
    mostrou na criação da credencial. Se gerou uma nova, a Amazon
    costuma atribuir `3.1`.
  </Accordion>
</AccordionGroup>

## Recursos úteis

<CardGroup cols={2}>
  <Card title="Amazon Associados" icon="external-link" href="https://associados.amazon.com.br">
    Portal de afiliados Brasil
  </Card>

  <Card title="Docs Creators API" icon="book-open" href="https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction">
    Documentação oficial
  </Card>
</CardGroup>