Update owner | Payroc | Documentation

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.

> **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](https://docs.payroc.com/api/schema/funding/funding-recipients/create) method and the [Create Funding Recipient Owner](https://docs.payroc.com/api/schema/funding/funding-recipients/create-owner) method. **Note:** If you don't have the ownerId, use the [List Funding Recipient Owners](https://docs.payroc.com/api/schema/funding/funding-recipients/list-owners) method, the [Retrieve Funding Recipient](https://docs.payroc.com/api/schema/funding/funding-recipients/retrieve) method, or the [List Funding Recipients](https://docs.payroc.com/api/schema/funding/funding-recipients/list) 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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

ownerIdintegerRequired

Unique identifier that we assigned to the owner.

Request

This endpoint expects an object.

firstNamestringRequired<=50 characters

Owner's first name.

lastNamestringRequired<=50 characters

Owner's last name.

dateOfBirthdateRequired

Owner’s date of birth. The format of this value is YYYY-MM-DD.

addressobjectRequired

Object that contains information about the address.

identifierslist of objectsRequired

Array of IDs.

contactMethodslist of objectsRequired

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 number

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 number

relationshipobjectRequired

Object that contains information about the owner's relationship to the business.

middleNamestringOptional<=50 characters

Owner's middle name.

Response

Successful request. We updated the owner.

Errors

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.

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.

1	using Payroc;
2	using System.Threading.Tasks;
3	using Payroc.Boarding.Owners;
4	using System;
5	using System.Collections.Generic;
6
7	namespace Usage;
8
9	public class Example
10	{
11	public async Task Do() {
12	var client = new BasePayrocClient(
13	clientOptions: new ClientOptions {
14	Environment = PayrocEnvironment.Production
15	}
16	);
17
18	await client.Boarding.Owners.UpdateAsync(
19	new UpdateOwnersRequest {
20	OwnerId = 4564,
21	Body = new Owner {
22	FirstName = "Jane",
23	LastName = "Doe",
24	DateOfBirth = DateOnly.Parse("1964-03-22"),
25	Address = new Address {
26	Address1 = "1 Example Ave.",
27	City = "Chicago",
28	State = "Illinois",
29	Country = "US",
30	PostalCode = "60056",
31	Address2 = "Example Address Line 2",
32	Address3 = "Example Address Line 3"
33	},
34	Identifiers = new List<Identifier>(){
35	new Identifier {
36	Type = IdentifierType.NationalId,
37	Value = "000-00-4320"
38	},
39	}
40	,
41	ContactMethods = new List<ContactMethod>(){
42	new ContactMethod(
43	new ContactMethodEmail {
44	Value = "[email protected]"
45	}
46	),
47	}
48	,
49	Relationship = new OwnerRelationship {
50	IsControlProng = true,
51	EquityPercentage = 48.5f,
52	Title = "CFO",
53	IsAuthorizedSignatory = false
54	},
55	MiddleName = "Helen"
56	}
57	}
58	);
59	}
60
61	}