🚀 Awin Merchant Promotions & Transactions BYOC Scraper

Official publisher integration for Awin. Programmatically retrieve transactions, voucher codes, promotions, and approved merchant partnerships (BYOC).

Integração oficial para afiliados Awin. Recupere programaticamente transações, cupons de desconto, ofertas e programas de anunciantes parceiros.

---

🌟 Features / Funcionalidades

• Transactions / Transações (GET): Pull historical transactions, click dates, transaction amounts, commission values, currency, and statuses.
• Promotions / Cupons (POST): Fetch all active, upcoming, or expiring vouchers, coupon codes, and promotional offers.
• Programmes / Anunciantes (GET): List advertiser relationships, status, click-through rates, validation periods, and commission structures.
• PPE Enabled: Pay-per-event pricing models to maximize cost-efficiency.
• Owner-Skip: Runs generated by the portfolio owner never pay execution fees.

---

📥 Input Schema / Dados de Entrada

Field / Campo	Type / Tipo	Description / Descrição	Required / Obrigatório
mode	Select	transactions, promotions, or programmes	Yes / Sim
publisherId	String	Awin Affiliate/Publisher Account ID (e.g. 123456)	Yes / Sim
accessToken	String	Awin API Token (Secret)	Yes / Sim
startDate	String	Start date for transactions (YYYY-MM-DD). Defaults to 30 days ago	No / Não
endDate	String	End date for transactions (YYYY-MM-DD). Defaults to today	No / Não
status	Select	Filter by status (all, pending, approved, declined)	No / Não
maxItems	Integer	Max items to fetch (1-1000). Default: 100	No / Não

---

📤 Output Example / Exemplo de Saída

Transaction mode output / Saída de Transação:

{
  "id": "11223344",
  "url": "https://api.awin.com/...",
  "advertiserId": 9999,
  "advertiserName": "Famous Brand Ltd",
  "clickDate": "2026-05-20T14:32:00",
  "transactionDate": "2026-05-20T14:35:10",
  "saleAmount": 59.90,
  "commission": 5.99,
  "currency": "EUR",
  "commissionStatus": "approved",
  "paymentId": 12345,
  "customParameters": null,
  "scrapedAt": "2026-05-26T17:28:00.000Z"
}

---

💡 Use Cases / Casos de Uso

• Automated Coupon Portals: Update your affiliate voucher databases daily with valid Awin promo codes.
• Dashboard Reporting: Feed internal Business Intelligence platforms with transaction amounts and daily commissions.
• Partnership Health Auditing: Track which advertisers are currently active in your network.

---

💳 Pricing & PPE / Precificação

• Transactions Retrieval: $0.02 per fetched transaction.
• General Scraping / Listing: $0.01 per item (promotions, advertiser).
• Owner Mode: Always free for the owner account (rpTa37o1ctfdFWZk9).

---

Changelog

v1.0.0

• Initial production release.
• Fully supports Publisher API v1 endpoints (/transactions/, /promotions, /programmes).
• Comprehensive error diagnosis and Zero-Items guard protection.