POST
/
publisher.v1
/
transaction
/
ingest
Ingest
curl --request POST \
  --url http://localhost/publisher.v1/transaction/ingest \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "merchant_id": "<string>",
      "member_id": "<string>",
      "external_id": "<string>",
      "bin": "<string>",
      "auth_code": "<string>",
      "authed_at": "2023-11-07T05:31:56Z",
      "amount": 2,
      "cleared_at": "2023-11-07T05:31:56Z",
      "reverted_at": "2023-11-07T05:31:56Z",
      "statement_descriptor": "<string>"
    }
  ]
}
'
{
  "status": "<string>"
}
Ingest transaction events for members within a memberbase. Transactions represent purchase or activity events and enable spend-based targeting, behavioral analytics, and attribution.

​
Idempotency

Transactions are deduplicated by transaction_id. Sending the same transaction multiple times will not create duplicate records, making it safe to retry failed requests.

​
Use Cases

  • Spend-based targeting: Target members who have spent above a threshold
  • Recency targeting: Target members based on how recently they made a purchase
  • Attribution: Measure which ad impressions led to conversions
  • Loyalty programs: Track qualifying purchases for points or tier progression

Body

application/json
​
events
IngestLogEvent · object[]
required

Response

Successful response

​
status
string
required