v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Customers

Update person or company customer

Update the account's person or company customer information.

Fields not passed are not updated.

This endpoint generates an Account entity updated event.

If the customer.is_owner property is set to true:

  • The account owner is changed to this new customer, and all existing customers remain active in the account.
  • This endpoint generates an Account owner changed event.

If customer.is_active = true, and the Maximum number of card holders program parameter is set, this customer is counted in the limit of maximum number of card holders for an account.

patch/accounts/v1/accounts/{accountId}/customers/{customerId}/detail

Path parameters

accountIdinteger required
Example:6912345

Account ID

customerIdinteger required
Example:12345

Customer ID

Headers

x-cidstring
Example:5bb05174-4e80-11ea-b77f-2e728ce88125

The Correlation Identifier field is used to link related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. You can find the x-cid field in the response header of an API endpoint call. If the x-cid value isn't passed, one is automatically generated.

x-tenantstring required
Example:TN-34778262-f4f0-464d-b4c6-a14e2dc6f4be

Organization ID

Request body

OR

Example request

{
  "id": "1",
  "type": "NATURAL_PERSON",
  "created_at": "2025-01-10T10:00:00Z",
  "birth_date": "31/12/1980",
  "document_issued_date": "01/31/1970",
  "is_active": true
}

Response

Customer details were successfully updated

OR

Example response

{
  "id": "1",
  "type": "NATURAL_PERSON",
  "created_at": "2025-01-10T10:00:00Z",
  "document_number": "7777888hh",
  "type_id": 1,
  "entity_type": "Person",
  "birth_date": "1991-11-27",
  "document_issued_date": "01/31/1970"
}