> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.troquecommerce.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Coleta Cobrada

# Coleta cobrada via Pix💵📦
Com a coleta cobrada, seu cliente pode pedir que a transportadora busque o pacote no endereço dele, pagando uma taxa via Pix. O valor cai direto na conta Pagar.me da sua loja.

Disponível para a coleta dos **Correios**, da **Devoluxe** e do **Motoboy**.

A taxa nunca impede a troca ou devolução: se o cliente não pagar ou desistir, a solicitação segue normalmente.

Para ativar na sua loja, veja [__Como ativar__](#2-como-ativar).

## Como funciona para o cliente
**1. Escolha do envio.** No passo de envio da central de trocas, a coleta aparece com o valor da taxa, ao lado da postagem gratuita nos Correios.


![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/passo-de-envio_6sgucm.png)


**2. Pagamento.** Ao finalizar a solicitação, o cliente recebe um Pix (QR Code e código copia e cola) válido por **5 minutos**. Se mudar de ideia, pode desistir da coleta na mesma tela e postar nos Correios.


![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/tela-do-pix_1e06tio.png)


**3. Se fechar a página.** Ao abrir o pedido de novo na central, ele encontra o mesmo Pix enquanto o prazo não acabar.

## O que acontece depois do Pix
Depende de a reversa ser aprovada automaticamente pelas regras da sua loja:
| Situação | Com aprovação automática | Com aprovação manual |
| ---- | ---- | ---- |
| **Cliente pagou** | Coleta aprovada na hora, com o código de coleta | Fica Em Análise, e o dashboard avisa que a taxa já foi paga |
| **Não pagou em 5 minutos ou desistiu** | Vira postagem gratuita nos Correios, com o código de postagem | Fica Em Análise para você escolher a forma de envio |

O cliente recebe os e-mails de sempre. Quando ele não paga ou desiste, o e-mail começa com uma frase explicando o que aconteceu.

Se a sua loja não oferece postagem nos Correios, quem não paga fica Em Análise, mesmo com aprovação automática.

## No seu dashboard
Enquanto o Pix está aberto, a aprovação da reversa fica travada. Ela é liberada assim que o cliente paga ou o prazo acaba.


![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/aprovacao-no-dashboard_dwmcqf.png)

Na reversa, um aviso mostra a situação da taxa:
| Aviso | O que fazer |
| ---- | ---- |
| **Aguardando o pagamento** | Espere o cliente pagar ou o prazo de 5 minutos acabar |
| **Cliente já pagou** | Aprove normalmente. A coleta já está paga |
| **Não pagou a tempo ou desistiu** | Confira a forma de envio e aprove. Se a loja usa Correios, a postagem já vem selecionada |
| **Cobrança falhou** | O Pix não foi gerado. Aprove com a forma de envio que preferir. Se acontecer de novo, teste a chave Pagar.me (passo 3) |

* O valor pago aparece no campo **Taxa de coleta** da reversa. Pagamento, expiração e desistência ficam registrados no histórico.
* Se o cliente já pagou e você aprovar **sem envio** ou **com o cliente pagando o frete**, a coleta paga não será usada. O dashboard avisa antes de confirmar.
* Por padrão, se a reversa for cancelada depois do pagamento, a taxa não é devolvida ao cliente: o valor fica na sua conta Pagar.me. Para ativar o estorno automático, solicite ao time Troquecommerce.

## Como ativar
|| É só abrir o método de envio no dashboard e ativar a opção Cobrar taxa de coleta do cliente. Antes, crie a chave de API e o webhook na sua conta Pagar.me, como mostram os passos abaixo.

### Passo 1. Crie a chave de API na Pagar.me
|| 💡Você precisa ter uma conta Pagar.me ativa em nome da sua loja. Se ainda não possui, pode ser criada diretamente com a Pagar.me.
No menu lateral da Pagar.me, abra **Configurações > Chaves**, clique em **Criar chave** e preencha:
* **Nome da chave:** `TROQUECOMMERCE`
* **Módulos legados (Mundipagg):** deixe desmarcado
* **Acesso da chave:** Personalizado

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_1dyo0ef.png)


Clique em **Avançar**. Ligue só o escopo **Transacional**, com a permissão **Leitura e escrita**, e deixe **Financeiro** e **Recebedores** desligados. Digite sua senha e clique em **Criar chave**.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_azqgy3.png)

Copie a chave gerada (começa com `sk_`) e guarde em local seguro. A Pagar.me mostra essa chave uma única vez.

### Passo 2. Cadastre o webhook na Pagar.me
O webhook avisa a Troquecommerce quando o cliente paga. Em **Configurações > Webhooks**, clique em **+ Criar webhook** e preencha:
| Campo | Valor |
| ---- | ---- |
| **Status** | Ativo |
| **URL** | `https://www.troquecommerce.com.br/api/webhook/pagarme` |
| **Máximo de tentativas** | Deixe o padrão |
| **Habilitar autenticação** | Desligado |


![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_15698kg.png)


Em **Eventos**, marque só estes três e salve no fim da página:
| Seção | Eventos |
| ---- | ---- |
| **PEDIDO** | `order.paid` e `order.canceled` |
| **COBRANÇA** | `charge.paid` |


![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_te88uj.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/f/f/2/e/ff2e9ea7a06be000/image_1v6fahu.png)




### Passo 3. Configure a taxa no dashboard da Troquecommerce
Acesse **Configurações > Métodos de Envio** e vá até o card da transportadora: **Correios**, **Devoluxe** ou **Motoboy**. Nos Correios, a opção **Habilitar Coleta** precisa estar ligada.
1. Ligue **Cobrar taxa de coleta do cliente**.
2. Preencha o **Valor da taxa de coleta**.
3. Cole a chave do passo 1 em **Chave de API** **Pagar.me** e clique em **Testar chave** **Pagar.me**. Deve aparecer **Chave** **Pagar.me** **válida** (o teste exige usuário Administrador).
4. Salve as alterações.

Para definir quem paga a taxa:
* **Só em algumas regiões:** ligue **Cobrar a taxa apenas em CEPs específicos** e cadastre as faixas de CEP. Fora delas, a coleta continua gratuita.
* **Coleta grátis para alguns motivos (Correios):** os motivos marcados em **Habilitar Coleta** ficam com coleta gratuita. Nos demais, a coleta é oferecida com a taxa.

## Faça um teste
Depois de configurar, abra uma troca ou devolução de teste na central de trocas, usando um endereço da sua equipe (a coleta aprovada no teste é real):
1. Escolha a coleta com taxa e confira se o QR Code do Pix aparece.
2. Pague o Pix. O valor cai na sua própria conta Pagar.me.
3. Veja se a coleta é aprovada na hora, com o código de coleta. Se a reversa não entra nas suas regras de aprovação automática, ela fica Em Análise com o aviso de que o cliente já pagou.

Se a coleta aparecer sem taxa, confira os motivos e as faixas de CEP do passo 3.

| 💡Ficou com alguma dúvida? Fale com o time Troquecommerce.