---
title: "Recebe postback assinado de comissão afiliada"
method: POST
path: "/affiliate/postbacks"
tags: ["Partner API"]
---

# Recebe postback assinado de comissão afiliada

`POST /affiliate/postbacks`

## Request

- Base URL: `https://obraaberta.com.br/api/v1`
- URL: `https://obraaberta.com.br/api/v1/affiliate/postbacks`
- Auth: none declared. Required headers: `X-ObraAberta-Timestamp`, `X-ObraAberta-Signature`

Exige X-ObraAberta-Timestamp e X-ObraAberta-Signature HMAC-SHA-256. O ledger inicial é simulado e não executa pagamentos.

## Headers

- `X-ObraAberta-Timestamp` string, required
- `X-ObraAberta-Signature` string, required

## Request body

- object
  - `event_id` string, required
  - `click_id` string
  - `order_id` string, required
  - `status` string
  - `commission_value` number, required
  - `currency` string, required

## Response `200`

Postback aceito no ledger simulado

## Other responses

- `202`: Atribuição ainda pendente
- `401`: HMAC inválido ou replay
- `503`: Segredo HMAC não configurado

---

[API](https://skmtc.dev/obraaberta/apis/obraaberta-api.md) · [All operations](https://skmtc.dev/obraaberta/apis/obraaberta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/obraaberta/apis/obraaberta-api/revisions/cfaed100c33c?raw)