# Configuração do snippet

> Endpoint que devolve a configuração de identificação da conta, lido pelo snippet ao carregar. Só é preciso se você escrever o próprio coletor.

Página: https://doc.rapidchargeback.com/canais/capture/config-do-snippet/

Devolve a configuração de identificação da conta. O [snippet](https://doc.rapidchargeback.com/canais/capture/instalar-o-snippet/) chama este endpoint ao carregar, antes do primeiro evento. Você só precisa dele se escrever o seu próprio coletor no navegador.

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/capture/{token}/config
```

## Autenticação

Nenhuma. O token publicável na URL identifica o merchant.

## Parâmetros de URL

| Campo | Tipo | Descrição |
|---|---|---|
| `token` | string | Token publicável do merchant, gerado no painel |

## Validações

| Regra | Resposta |
|---|---|
| Token desconhecido, inativo ou sem merchant | `404 NOT_FOUND` |

## Cache

A resposta vem com `cache-control: public, max-age=300`. Respeite o cache: a configuração muda raras vezes e o snippet não precisa consultá-la a cada página.

## Exemplo de requisição

```bash
curl https://api.rapidchargeback.com/api/v1/capture/seu_token_publicavel/config
```

## Exemplos de resposta

### Sucesso (200), com Fingerprint ativo

```json
{
  "data": {
    "fp_public_key": "pk_exemplo_123456",
    "fp_region": "us"
  }
}
```

| Campo | Descrição |
|---|---|
| `fp_public_key` | Chave pública do Fingerprint a usar no navegador. `null` quando a identificação não está ativa |
| `fp_region` | Região do Fingerprint: `us`, `eu` ou `ap` |

Com a chave, o coletor carrega o agente do Fingerprint e obtém dois valores: o identificador do visitante e o identificador da consulta. Mande-os no evento de `checkout` como `device_id` e `fp_request_id`, que a Rapid valida o par do lado servidor. Ver [O evento `checkout`](https://doc.rapidchargeback.com/canais/capture/payload/#o-evento-checkout).

### Sucesso (200), sem Fingerprint ativo

```json
{
  "data": {
    "fp_public_key": null,
    "fp_region": "us"
  }
}
```

`fp_public_key` nulo não impede a captura. O evento continua sendo registrado, apenas sem a parte de identificação validada do aparelho.

### Erro: token desconhecido (404)

```json
{ "error": { "code": "NOT_FOUND" } }
```

## Próximos passos

- [Instalar o snippet](https://doc.rapidchargeback.com/canais/capture/instalar-o-snippet/)
- [Enviar evento pelo navegador](https://doc.rapidchargeback.com/canais/capture/enviar-evento-navegador/)