API: PATCH Offer Activation

Overview

Many card_last_four values can be associated with a consumer token or account. This endpoint allows the user to add a card last four value on an existing consumer token.

Developers, please see our API Reference for an interactive example.

URL

api.banyan.com/v1/offer/activation/{id} where {id} is the activation record you wish to update.

Body

Add card_last_four records to an existing consumer token/activation

Name	Description	Type	Required	Notes
card_last_four	What the new budget should be for the offer	array	Yes	If this card already exists, Banyan will ignore it

Example:

{
    "card_last_four":["1234","5678"]
}

Response

The response is the full activation record.

Example:

{
  "data": [
    {
      "byn_offer_activation_id": "f067adab-9d57-5b10-865c-a5afbfc7d231",
      "byn_offer_id": "c5444989-0479-5d73-b417-98963aac743d",
      "byn_publisher_id": 298,
      "publisher_consumer_token": "5555-373288230-shguiw37",
      "cards": [
        "5555",
        "1212"
      ],
      "created_ts": "2024-04-02T17:21:04.951613Z",
      "updated_ts": "2025-01-30T17:04:32.807669Z"
    }
  ],
  "errors": [],
  "request_id": "15001b61b9e972d82589be8a6695ee55/2723125039789614721"
}

Errors

Error Code	Description	Examples
400	Bad Request
403	Forbidden
404	Not Found