[POST] .../v1/promobonus/createmanualincomeoperation
Creates a manual deposit operation for a customer card Use this method to 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. Business errors such as a missing request body, invalid identifiers or value, denied access, missing or disabled card, exceeded manual income limit, database errors, missing active row or persistence failures 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
}
}