Sign in

v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB
Purchases

Assign customer

The method assigns customer to the existing purchase. If customer could collect points, he is going to gain corresponding amount of points. ⚠️ Endpoint is available only in the Enterprise interface.

post/purchases/actions/assign-customer

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

store_idstring required

ID of the store.

external_purchase_idstring required

A unique identifier for an existing purchase in the production system (e.g., E-commerce, POS, ERP). This ID must be unique within the system and reference an actual purchase or order.

If the purchase was created in CareCloud using the CareCloud API, use the same value as the bill_id parameter from the POST /send-purchase endpoint.

card_numberstring

Number of the customer card. Parameter is mandatory only if customer_id is not set.

customer_idstring

The unique ID of the customer. Parameter is mandatory only if card_number is not set.

Example request

{
  "store_id": "81eaeea13b8984a169c490a325",
  "external_purchase_id": "8fbea1c1eaa8edd35e7f288",
  "card_number": "1000000000016",
  "customer_id": "8ea2591121e636086a4a9c0992"
}

Response

No Content