> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bonifiq.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Afiliados

> Endpoints para consultar informações do programa de afiliados

Os endpoints de afiliados permitem consultar informações e histórico do cliente quando ele participa do programa de afiliados.

## Status de Autenticação dos Endpoints

| Endpoint                                | Status      |
| --------------------------------------- | ----------- |
| `GET /pub/widget/affiliate/infohistory` | Autenticado |

***

## Consultar Histórico de Afiliado

Retorna o histórico e informações do cliente como afiliado.

### Requisição

`GET /pub/widget/affiliate/infohistory`

**Headers**

<ParamField header="X-Bq-Tenant" type="string" required>
  Identificador público da loja.
</ParamField>

<ParamField header="X-Bq-SecureToken" type="string" required>
  Token do usuário obtido no login seguro.
</ParamField>

### Exemplo

```bash theme={null}
curl -X GET "https://api.bonifiq.com.br/pub/widget/affiliate/infohistory" \
  -H "X-Bq-Tenant: {tenant_key}" \
  -H "X-Bq-SecureToken: {secure_token}"
```

### Resposta

```json theme={null}
{
  "HasError": false,
  "Message": null,
  "Item": {
    "IsAffiliate": true,
    "AffiliateCode": "AFF123",
    "TotalEarnings": 1500.00,
    "PendingEarnings": 250.00,
    "TotalOrders": 45,
    "ConversionRate": 12.5,
    "History": [
      {
        "Date": "2025-02-01",
        "OrderId": "ORD-001",
        "Value": 150.00,
        "Commission": 15.00,
        "Status": "Paid"
      },
      {
        "Date": "2025-01-28",
        "OrderId": "ORD-002",
        "Value": 200.00,
        "Commission": 20.00,
        "Status": "Pending"
      }
    ]
  }
}
```

<Note>
  O programa de afiliados permite que clientes ganhem comissões por indicar novos compradores. Para verificar se um cliente é afiliado, você também pode usar o campo `IsAffiliate` no endpoint `/pub/widget/customer/info`.
</Note>