Set Merchant Acquisition Source

​

PATCH /admin/merchants/:id/acquisition-source

​

Authentication

​

Path parameters

​

Request body

​

Example — set

curl -X PATCH "https://apiv3.droplinked.com/admin/merchants/6794172fefa4eb734620b00c/acquisition-source" \
  -H "Authorization: Bearer <SUPER_ADMIN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{"source":"IMPACT"}'

​

Example — clear

curl -X PATCH "https://apiv3.droplinked.com/admin/merchants/6794172fefa4eb734620b00c/acquisition-source" \
  -H "Authorization: Bearer <SUPER_ADMIN_JWT>" \
  -H "Content-Type: application/json" \
  -d '{}'

​

Response — 200 OK

{
  "statusCode": 200,
  "message": null,
  "data": {
    "merchantId": "6794172fefa4eb734620b00c",
    "acquisitionSource": "IMPACT"
  }
}

{
  "statusCode": 200,
  "message": null,
  "data": {
    "merchantId": "6794172fefa4eb734620b00c",
    "acquisitionSource": null
  }
}

​

Fields

​

Errors

​

Notes

• Operator-only. This is an operator-driven attribution backfill — no merchant or partner surface invokes it. The setter is intentionally stateless beyond the field write (no audit log entry surfaced in the response; the underlying admin actor audit captures the call).
• Enum semantics.
  • IMPACT — sourced via the Impact.com partner network (Flatlay account).
  • AWIN — sourced via the Awin partner network.
  • REFERRAL — operator-driven referral, no partner network.
  • AGENTIC_AFFILIATE_INTAKE — sourced via the agentic-affiliate intake flow (chat / MCP).
  • OTHER — sourced through a named channel that doesn’t map to the above.
  • UNKNOWN — sourced through an unknown channel (default for backfilled legacy merchants).
• Clearing. Omitting source (or sending {} / null) clears the field rather than rejecting the request. Use clearing to roll back an incorrect attribution.
• Effect on rollups. The next GET /admin/monetization/platform-fee-summary call recomputes activationMethodMix from the live store, so changes appear immediately on the next read.

​

Related

• Platform Fee Summary — activationMethodMix is keyed off this field.
• x402 Earnings — per-merchant x402 rollup.
• Aggregate Provisioner — bulk merchant onboarding (sets acquisitionSource at create time).