---
title: "Yampi: Integrando com a plataforma (legado)"
url: "https://devcenter.stone.com.br/legacy-plataforma-yampi"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~WWFtcGk6IEludGVncmFuZG8gY29tIGEgcGxhdGFmb3JtYSAobGVnYWRvKQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktcGxhdGFmb3JtYS15YW1waSI,s_4Zb6oXXXZIHgOOWB.png"
---

# Yampi: Integrando com a plataforma

Passo a passo para integrar sua loja Yampi à Pagar.me: formulário, chaves de API e criptografia e checagem da integração.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [1\. Veja como começar o processo de integração](#_1-veja-como-começar-o-processo-de-integração)

Acesse seu [painel de controle](https://beta.dashboard.pagar.me/#/account/login) Pagar.me e clique em Configurações no menu vertical ao lado esquerdo da tela.

![1396](https://files.readme.io/eb43f18-Betalabs1.png "Betalabs1.png")

Nas Configurações, procure por Chaves de API, selecione a Versão 2 (2017-07-17) e salve esses códigos. Você utilizará as chaves de API e Criptografia na configuração da Yampi.

![1396](https://files.readme.io/1fd4423-betalabs2.png "betalabs2.png")

## [2\. Agora, é hora de acessar seu painel de controle na Yampi](#_2-agora-é-hora-de-acessar-seu-painel-de-controle-na-yampi)

Na barra superior da página inicial, clique em **Configurações** e selecione **Checkout**.

Nas configurações do Checkout procure pela sessão de Afiliações e clique no botão + **Nova Afiliação** e selecione o Pagar.me.

![1396](https://files.readme.io/d367d35-yampi.png "yampi.png")

![1396](https://files.readme.io/bc8ca03-yampi2.png "yampi2.png")

## [3\. Preencha o formulário](#_3-preencha-o-formulário)

Um formulário será exibido com os seguintes campos:

-   **Nome**: defina um nome para essa afiliação. **Exemplo**: Pagar.me Loja de Pneus.
-   Capturar as transações automaticamente?  
    Sim: as transações serão automaticamente autorizadas e capturadas;  
    Não: as transações serão apenas autorizadas. A captura deverá ser realizada posteriormente pelo lojista em até 5 dias.
-   **Chave de API e Chave de Criptografia:** cole em seus respectivos campos as chaves de API e Criptografia que você encontrou no painel do Pagar.me.

![1396](https://files.readme.io/ddace93-yampi3.png "yampi3.png")

Salve as alterações ao final da modificação.

Observação importante sobre a Chave

Muita atenção às chaves de API e Criptografia utilizadas na configuração. Para que as transações do seu site de fato aconteçam e você receba o dinheiro das vendas, essas chaves devem estar na versão 2017-07-17 e os códigos devem começar com ak\_live e ek\_live. O termo live indica que essas são as chaves de produção, ou seja, geram vendas reais. Já as chaves de teste, começam com ak\_test e ek\_test. Então, certifique-se de você copiou os códigos certos de acordo com seu objetivo.

## [4\. Cole as chaves de API e criptografia](#_4-cole-as-chaves-de-api-e-criptografia)

Depois de colar as chaves de produção no campo demonstrado acima, sua integração estará completa!

## [5\. Para checar o sucesso da integração, você pode](#_5-para-checar-o-sucesso-da-integração-você-pode)

-   **Realizar uma compra por boleto:** faça o caminho do comprador no seu site e finalize a compra com a opção de boleto bancário. O pedido deve ser criado na Yampi e o boleto gerado no painel do Pagar.me.
-   **Realizar uma compra por cartão de crédito:** faça o caminho do comprador no seu site e finalize a compra com a opção de cartão de crédito. Você pode utilizar um número de cartão fictício (sugerimos 4242424242424242) para que a compra seja recusada. A transação deve aparecer como recusada no painel do Pagar.me.

## [Boas vendas!](#boas-vendas)

---

**Jornada: [Conectar minha plataforma de e-commerce](https://devcenter.stone.com.br/legacy-plataformas)**  
Etapa 26 de 26

[**Etapa anterior**BetaLabs](https://devcenter.stone.com.br/legacy-plataforma-betalabs)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.