Actions19
- Atualizar Webhook
- Consultar Afiliado
- Consultar Estatísticas De Vendas
- Consultar Produto
- Consultar Saldo Específico
- Consultar Saque
- Consultar Venda
- Consultar Webhook
- Criar Webhook
- Deletar Webhook
- Editar Afiliado
- Listar Afiliados
- Listar Participantes
- Listar Produtos
- Listar Saques
- Listar Vendas
- Listar Webhooks
- Realizar Saque
- Reembolsar Venda
Overview
The "Editar Afiliado" operation in this node allows users to update specific information about an affiliate in the Kiwify platform via its API. This includes modifying the affiliate's commission rate and status. It is useful for managing affiliate programs where commissions or statuses need to be adjusted dynamically, such as activating, blocking, or refusing affiliates, or updating their commission percentages based on performance or policy changes.
Practical examples:
- Increasing the commission percentage of a high-performing affiliate.
- Blocking an affiliate who violates terms.
- Changing the status of an affiliate from active to refused.
Properties
| Name | Meaning |
|---|---|
| ID Do Afiliado | The unique identifier of the affiliate to be edited. |
| Comissão | (Optional) The new commission value (number) to assign to the affiliate. |
| Status | (Optional) The new status of the affiliate. Possible values: Ativo (active), Bloqueado (blocked), Recusado (refused). |
Output
The output is a JSON object representing the updated affiliate data returned by the Kiwify API after the edit operation. It contains the affiliate's details including any updated fields such as commission and status.
No binary data output is involved in this operation.
Dependencies
- Requires an API key credential for authenticating with the Kiwify API.
- The node uses OAuth token retrieval internally by exchanging client credentials.
- Requires configuration of the Kiwify account ID and client credentials in n8n credentials settings.
Troubleshooting
Common issues:
- Invalid or missing affiliate ID will cause the API request to fail.
- Providing a commission value less than or equal to zero may result in no update to commission.
- Incorrect status values outside the allowed options will cause errors.
- Authentication failures if API credentials are incorrect or expired.
Error messages:
- Errors from the Kiwify API will be propagated, typically indicating invalid parameters or authorization issues.
- Network or connectivity errors can occur if the API endpoint is unreachable.
Resolutions:
- Verify that the affiliate ID exists and is correct.
- Ensure commission is a positive number if provided.
- Use only the allowed status options.
- Confirm API credentials and account ID are correctly configured in n8n.
Links and References
- Kiwify API Documentation (general reference for API endpoints and parameters)
- n8n documentation on Creating Custom Nodes