Update funding recipient | Payroc

Use this method to update the details of a funding recipient. If a request contains significant changes, we might need to re-approve the funding recipient.

To update a funding recipient, you need it’s recipientId. Our gateway returned the recipientId in the response of the Create Funding Recipient method.

Note: If you don’t have the recipientId, use our List Funding Recipients method to search for the funding recipient.

You can update the following details of a funding recipient:

Doing Business As (DBA) name
Tax ID and charity ID
Address and contact methods

Use this method to update the details of a funding recipient. If a request contains significant changes, we might need to re-approve the funding recipient. To update a funding recipient, you need it's recipientId. Our gateway returned the recipientId in the response of the [Create Funding Recipient](https://docs.payroc.com/api/schema/funding/funding-recipients/create) method. **Note**: If you don't have the recipientId, use our [List Funding Recipients](https://docs.payroc.com/api/schema/funding/funding-recipients/list) method to search for the funding recipient. You can update the following details of a funding recipient: - Doing Business As (DBA) name - Tax ID and charity ID - Address and contact methods

Authentication

AuthorizationBearer

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

Path parameters

recipientIdintegerRequired

Unique identifier that we assigned to the funding recipient.

Request

This endpoint expects an object.

recipientTypeenumRequired

Type or legal structure of the funding recipient.

taxIdstringRequired

Employer identification number (EIN) or Social Security number (SSN).

doingBusinessAsstringRequired

Legal name of the business or organization.

addressobjectRequired

Polymorphic object that contains address information for a funding recipient.

contactMethodslist of objectsRequired

Array of polymorphic objects, which contain contact information.

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. The value of the type parameter determines which variant you should use: - `email` - Email address - `phone` - Phone number - `mobile` - Mobile number - `fax` - Fax number

charityIdstringOptional

Government identifier of the charity.

metadatamap from strings to stringsOptional

Metadata object you can use to include custom data with your request.

[Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

406

Not Acceptable Error

500

Internal Server Error

1	using Payroc;
2	using System.Threading.Tasks;
3	using Payroc.Funding.FundingRecipients;
4	using System.Collections.Generic;
5
6	namespace Usage;
7
8	public class Example
9	{
10	public async Task Do() {
11	var client = new PayrocClient();
12
13	await client.Funding.FundingRecipients.UpdateAsync(
14	new UpdateFundingRecipientsRequest {
15	RecipientId = 234,
16	Body = new FundingRecipient {
17	RecipientType = FundingRecipientRecipientType.PrivateCorporation,
18	TaxId = "12-3456789",
19	DoingBusinessAs = "Doe Hot Dogs",
20	Address = new Address {
21	Address1 = "2 Example Ave.",
22	Address2 = "Example Address Line 2",
23	Address3 = "Example Address Line 3",
24	City = "Chicago",
25	State = "Illinois",
26	Country = "US",
27	PostalCode = "60056"
28	},
29	ContactMethods = new List<ContactMethod>(){
30	new ContactMethod(
31	new ContactMethodEmail {
32	Value = "[email protected]"
33	}
34	),
35	new ContactMethod(
36	new ContactMethodPhone {
37	Value = "2025550110"
38	}
39	),
40	}
41	,
42	Metadata = new Dictionary<string, string>(){
43	["responsiblePerson"] = "Jane Doe",
44	}
45
46	}
47	}
48	);
49	}
50
51	}