Add

[POST] .../v1/retailcard/add

Creates a new customer card. Use this method to create a retail customer card linked to an existing customer, card group, barcode type and loyalty program. The request requires customer_id, barcode_value and barcode_type_id; group_id and promo_id may be supplied explicitly, otherwise server default settings are used and the method returns new_id for the created card. The method checks the current request user and requires customer card add permission; it validates group, customer, promo program, barcode length up to 128 characters, uniqueness of the customer plus promo pair, uniqueness of barcode and whether the promo type allows retail cards and returns validation, permission, duplicate and storage failures as HTTP 200 ErrorResult business errors.

Request Parameters

Request Example

{
  "barcode_type_id": 1,
  "barcode_value": "string",
  "customer_id": 1,
  "enabled": true,
  "expiry_date": "string",
  "group_id": 1,
  "promo_id": 1,
  "unlimited": true
}

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "new_id": 1
  }
}