CreateManualIncomeOperation

[POST] .../v1/promobonus/createmanualincomeoperation

Immediately credits a customer card with manual bonuses. Immediately add manual bonus income to an enabled retail card linked to the requested promotion. The request requires card_id, promo_id and positive value; description and exp_date can be supplied for the created manual operation. The method requires the manual bonus income permission, locks the card_id, checks that the card is active for the promotion, enforces the manual income limit, creates an already performed income operation, emits a webhook and returns row_affected. Errors such as a missing request body, invalid identifiers or value, denied access, missing or disabled card, exceeded manual income limit, storage errors, missing active row are returned as HTTP 200 ErrorResult.

Request Parameters

Name Type Required Description
card_id Int64 Required Customer card ID.
description String Optional Additional description.
exp_date Int64 Optional Bonus accrual end date as Unix time in seconds.
promo_id Int64 Required Promotion ID.
value Decimal Required Withdrawal amount.

Request Example

{
  "card_id": 1,
  "description": "string",
  "exp_date": 1,
  "promo_id": 1,
  "value": 1.0
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Update Update operation result.

Response Example

{
  "ok": true,
  "result": {
    "ids": [
      null
    ],
    "row_affected": 1
  }
}