Guides

Update customer [Private]

This endpoint allows you to change or add customer information.

Suggest Edits
Method name:/v2/customer/update
Request type:POST

📘

To call private endpoints, you need to get a JWT token or an API key for authentication.

Here you can learn in detail how to successfully authenticate.

Data dictionary

NameTypeParameter typeRequiredRangeDescription
idstringBODYYES-Unique customer identifier in KunaCore system.
emailstringBODYNO-Customer email. It must be unique for each customer.
phoneNumberstringBODYNO-Customer's phone number.
firstNamestringBODYNO-Customer's name.
lastNamestringBODYNO-Customer's surname.
commentstringBODYNO-Additional comment about the customer.
externalIdstringBODYNO-Any string that identify the customer in your system.
countrystringBODYNOUA, IT, ES, FR, etc.Customer's country.
(Country code in ISO 3166-1 Alfa2, e.g. UA - Ukraine, IT - Italy).
verificationDocumentIdstringBODYNO-ID of the document that was used by the client for the verification process (passport, driver's license, etc.)
residenceAddressstringBODYNO-Customer's residential address.
itnstringBODYNO-Individual taxpayer number of the customer.

Exemplary request

const url = BASE_URL;
const path = "/v2/customer/update";

const body = {
    id: "d0eab186-19f1-446f-8b9e-739945941b89",
    email: "[email protected]",
    firstName: "Alexander"
  };

const options = {
  method: "POST",
  headers: {
    accept: "application/json",
    "Content-Type": "application/json",
    "Authorization": `Bearer ${data.accessToken}` // data.accessToken - generated a JWT token via /v2/auth/login.
  },
  body: JSON.stringify(body),
};

fetch(url + path, options)
  .then((response) => response.json())
  .then((showResponse) => console.log(showResponse.data));

import requests

url = BASE_URL
path = "/v2/customer/update"
headers = {
    "accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": "Bearer " + data.accessToken # data.accessToken - generated a JWT token via /v2/auth/login.
}
body = {
    "id": "d0eab186-19f1-446f-8b9e-739945941b89",
    "email": "[email protected]",
    "firstName": "Alexander"
}

request = requests.post(url + path, headers=headers, json=body)
print(request.json())

How to call private endpoints here

Swagger here

Response

{
  "data": {
    "id": "6d962783-f0cf-420d-a511-3a48c71c5595",                      // Customer’s ID
    "comment": null,                                                   // Note for the customer  account
    "createdAt": "2024-02-26T16:36:14.499Z",                           // Account creation date
    "email": "[email protected]",                                     // Customer’s email
    "firstName": "Alex",                                               // Customer’s name
    "lastName": "Smith",                                               // Customer’s surname
    "phoneNumber": "+380991234567",                                    // Customer’s phone number
    "externalId": null,                                                // Customer’s external ID
    "walletId": "6d962783-f0cf-420d-a511-3a48c71c5595",                // Customer’s wallet ID
    "referralId": "1f44b1c7-9fd4-4d20-b9a4-7aca3646d0d5"               // External ID of the referral account
  }
}

Updated 6 months ago