Update owner

Browse API reference

PUT/owners/{ownerId}updateOwner

Important: You can't update the details of an owner of a processing account.

Use this method to update the details of an owner associated with a funding recipient.

To update an owner, you need their ownerId. Our gateway returned the ownerId in the response of the Create Funding Recipient method and the Create Funding Recipient Owner method.

Note: If you don't have the ownerId, use the List Funding Recipient Owners method, the Retrieve Funding Recipient method, or the List Funding Recipients method to search for the funding recipient owner.

You can update the following details about an owner:

Personal details, including their name, date of birth, and address.
Identification details, including their identification type and number.
Contact details, including their email address.
Relationship to the business, including whether they are a control prong.

Parameters

Name	In	Type	Description
`ownerId`Required	path	`integer`	Unique identifier that we assigned to the owner.

Request body

application/json

Field Edit request inputs →

addressobjectrequired
Object that contains information about the address.
- address1stringrequired
  Address line 1.≤ 150 chars
- address2string
  Address line 2.≤ 150 chars
- address3string
  Address line 3.≤ 150 chars
- citystringrequired
  City.≤ 50 chars
- countrystringrequired
  Two-digit country code for the country that the business operates in. The format follows the ISO-3166-1 standard.2–2 chars
- postalCodestringrequired
  Zip code or postal code.≤ 10 chars
- statestringrequired
  Name of the state or state abbreviation.≤ 50 chars
contactMethodsobject[]required
Array of polymorphic objects, which contain contact information. Note: If you are adding information about an owner, you must provide at least an email address. If you are adding information about a contact, you must provide at least a contact number. The value of the type parameter determines which variant you should use: email Email address phone Phone number mobile Mobile number fax Fax number1–4 items
- emailobject
  - typestringrequired
    Type of contact method.email
  - valuestringrequired
    Email address.≤ 50 chars
- phoneobject
  - typestringrequired
    Type of contact method.phone
  - valuestringrequired
    Phone number.≤ 15 chars
- mobileobject
  - typestringrequired
    Type of contact method.mobile
  - valuestringrequired
    Mobile number.≤ 15 chars
- faxobject
  - typestringrequired
    Type of contact method.fax
  - valuestringrequired
    Fax number.≤ 15 chars
dateOfBirthstringdaterequired
Owner's date of birth. The format of this value is YYYY-MM-DD.
firstNamestringrequired
Owner's first name.≤ 50 chars
identifiersobject[]required
Array of IDs.≥ 1 items
- typestringrequired
  Type of ID provided to verify identity.nationalId
- valuestringrequired
  Social Security Number (SSN) or Social Insurance Number (SIN).
lastNamestringrequired
Owner's last name.≤ 50 chars
middleNamestring
Owner's middle name.≤ 50 chars
relationshipobjectrequired
Object that contains information about the owner's relationship to the business.
- equityPercentagenumberpercentage
  Percentage equity stake that the owner holds in the business.
- isAuthorizedSignatoryboolean
  Indicates if the owner is an authorized signatory.
- isControlProngbooleanrequired
  Indicates if the owner is a control prong. You can identify only one control prong for a business.
- titlestring
  Owner's job title.

Responses

Successful request. We updated the owner.

No response body — a 204 means the action took effect.

Validation errors.

400 Bad Request · application/problem+json

{
  "detail": "Entity has been rejected due to failing KYC checks",
  "status": 400,
  "title": "Failed KYC Checks",
  "type": "https://docs.payroc.com/api/errors#kyc-check-failed"
}

Response schema · 8 fields

detailstringrequired
Explanation of the problem
errorsobject[]
- detailstring
  Short detail of the validation errors
- messagestring
  Error message
- parameterstring
  The parameter or field causing the issues
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Identity could not be verified

401 Unauthorized · application/problem+json

{
  "detail": "Your identity could not be verified",
  "status": 401,
  "title": "Not Authorized",
  "type": "https://docs.payroc.com/api/errors#not-authorized"
}

Response schema · 4 fields

detailstringrequired
Explanation of the problem
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Do not have permissions to perform this action

403 Forbidden · application/problem+json

{
  "detail": "You do not have the required permissions to perform this action",
  "instance": "https://api.payroc.com/v1/exampleResource/3",
  "resource": "exampleResource",
  "status": 403,
  "title": "Forbidden",
  "type": "https://docs.payroc.com/api/errors#forbidden"
}

Response schema · 6 fields

detailstringrequired
Explanation of the problem
instancestring
Resource path the action was attempted on
resourcestring
Resource the action was attempted on
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Resource not found

404 Not Found · application/problem+json

{
  "detail": "Resource not found",
  "resource": "(The Type of the Resource)",
  "status": 404,
  "title": "Not found",
  "type": "https://docs.payroc.com/api/errors#not-found"
}

Response schema · 5 fields

detailstringrequired
Explanation of the problem
resourcestring
Resource that was not found
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Not acceptable

406 Not Acceptable · application/problem+json

{
  "detail": "Resource does not support the representation requested",
  "status": 406,
  "title": "Not acceptable",
  "type": "https://docs.payroc.com/api/errors#not-acceptable"
}

Response schema · 4 fields

detailstringrequired
Explanation of the problem
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

An error has occured

500 Internal Server Error · application/problem+json

{
  "detail": "We are unable to process your request at this time",
  "errors": [
    {
      "message": "Service offline"
    }
  ],
  "status": 500,
  "title": "Api error",
  "type": "https://docs.payroc.com/api/errors#api-error"
}

Response schema · 6 fields

detailstringrequired
Explanation of the problem
errorsobject[]
- messagestring
  Error message
statusintegerrequired
Http status code
titlestringrequired
Short description of the issue.
typestringrequired
URI reference identifying the problem type

Used in workflows

update-an-owner

curl --request PUT \ --url 'https://api.payroc.com/v1/owners/{ownerId}' \ --header 'Authorization: Bearer <access-token>' \ --header 'Content-Type: application/json' \ --data '{ "address": { "address1": "1 Example Ave.", "address2": "Example Address Line 2", "address3": "Example Address Line 3", "city": "Chicago", "country": "US", "postalCode": "60056", "state": "Illinois" }, "contactMethods": [ { "type": "email", "value": "jane.doe@example.com" } ], "dateOfBirth": "1964-03-22", "firstName": "Jane", "identifiers": [ { "type": "nationalId", "value": "000-00-4320" } ], "lastName": "Doe", "middleName": "Helen", "relationship": { "equityPercentage": 48.5, "isAuthorizedSignatory": false, "isControlProng": true, "title": "CFO" } }'