Create funding recipient

1	using Payroc;
2	using System.Threading.Tasks;
3	using Payroc.Funding.FundingRecipients;
4	using System.Collections.Generic;
5	using System;
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.Funding.FundingRecipients.CreateAsync(
19	new CreateFundingRecipient {
20	IdempotencyKey = "8e03978e-40d5-43e8-bc93-6894a57f9324",
21	RecipientType = CreateFundingRecipientRecipientType.PrivateCorporation,
22	TaxId = "12-3456789",
23	DoingBusinessAs = "Pizza Doe",
24	Address = new Address {
25	Address1 = "1 Example Ave.",
26	Address2 = "Example Address Line 2",
27	Address3 = "Example Address Line 3",
28	City = "Chicago",
29	State = "Illinois",
30	Country = "US",
31	PostalCode = "60056"
32	},
33	ContactMethods = new List<ContactMethod>(){
34	new ContactMethod(
35	new ContactMethodEmail {
36	Value = "[email protected]"
37	}
38	),
39	new ContactMethod(
40	new ContactMethodPhone {
41	Value = "2025550164"
42	}
43	),
44	}
45	,
46	Owners = new List<Owner>(){
47	new Owner {
48	FirstName = "Jane",
49	LastName = "Doe",
50	DateOfBirth = DateOnly.Parse("1964-03-22"),
51	Address = new Address {
52	Address1 = "1 Example Ave.",
53	City = "Chicago",
54	State = "Illinois",
55	Country = "US",
56	PostalCode = "60056"
57	},
58	Identifiers = new List<Identifier>(){
59	new Identifier {
60	Type = IdentifierType.NationalId,
61	Value = "000-00-4320"
62	},
63	}
64	,
65	ContactMethods = new List<ContactMethod>(){
66	new ContactMethod(
67	new ContactMethodEmail {
68	Value = "[email protected]"
69	}
70	),
71	new ContactMethod(
72	new ContactMethodPhone {
73	Value = "2025550164"
74	}
75	),
76	}
77	,
78	Relationship = new OwnerRelationship {
79	IsControlProng = true,
80	EquityPercentage = 48.5f,
81	Title = "CFO",
82	IsAuthorizedSignatory = false
83	},
84	MiddleName = "Helen"
85	},
86	}
87	,
88	FundingAccounts = new List<FundingAccount>(){
89	new FundingAccount {
90	Type = FundingAccountType.Checking,
91	Use = FundingAccountUse.Credit,
92	NameOnAccount = "Jane Doe",
93	PaymentMethods = new List<PaymentMethodsItem>(){
94	new PaymentMethodsItem(
95	new PaymentMethodAch {
96	Value = new PaymentMethodAchValue {
97	RoutingNumber = "123456789",
98	AccountNumber = "1234567890"
99	}
100	}
101	),
102	}
103
104	},
105	}
106	,
107	Metadata = new Dictionary<string, string>(){
108	["yourCustomField"] = "abc123",
109	}
110
111	}
112	);
113	}
114
115	}

1	{
2	"recipientType": "privateCorporation",
3	"taxId": "123456789",
4	"doingBusinessAs": "string",
5	"address": {
6	"address1": "1 Example Ave.",
7	"address2": "Example Address Line 2",
8	"address3": "Example Address Line 3",
9	"city": "Chicago",
10	"state": "Illinois",
11	"country": "US",
12	"postalCode": "60056"
13	},
14	"contactMethods": [
15	{
16	"type": "email",
17	"value": "[email protected]"
18	}
19	],
20	"owners": [
21	{
22	"ownerId": 4564,
23	"link": {
24	"rel": "owner",
25	"href": "https://api.payroc.com/v1/owners/4564",
26	"method": "get"
27	}
28	}
29	],
30	"fundingAccounts": [
31	{
32	"fundingAccountId": 123,
33	"status": "approved",
34	"link": {
35	"rel": "fundingAccount",
36	"href": "https://api.payroc.com/v1/funding-accounts/123",
37	"method": "get"
38	}
39	},
40	{
41	"fundingAccountId": 124,
42	"status": "rejected",
43	"link": {
44	"rel": "fundingAccount",
45	"href": "https://api.payroc.com/v1/funding-accounts/124",
46	"method": "get"
47	}
48	}
49	],
50	"recipientId": 234,
51	"status": "approved",
52	"createdDate": "2024-07-02T15:30:00Z",
53	"lastModifiedDate": "2024-07-02T15:30:00Z",
54	"charityId": "string",
55	"metadata": {
56	"yourCustomField": "abc123"
57	}
58	}

Use this method to create a funding recipient.

A funding recipient is a business or organization that can receive funds but can’t run transactions, for example, a charity.

In the request, include the following information:

Legal information, including its tax ID, Doing Business As (DBA) name, and address.
Contact information, including the email address.
Owners’ details, including their contact details.
Funding account details.

Our gateway returns the recipientId of the funding recipient, which you can use to run follow-on actions.

Use this method to create a funding recipient. A funding recipient is a business or organization that can receive funds but can't run transactions, for example, a charity. In the request, include the following information: - Legal information, including its tax ID, Doing Business As (DBA) name, and address. - Contact information, including the email address. - Owners' details, including their contact details. - Funding account details. Our gateway returns the recipientId of the funding recipient, which you can use to run follow-on actions.

Authentication

AuthorizationBearer

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

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

Trading 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.

Note: You must provide an email address.

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

ownerslist of objectsRequired

Array of owner objects. Each object contains information about an individual who owns or manages the funding recipient.

fundingAccountslist of objectsRequired

Array of fundingAccount objects that you can use to add funding accounts to the funding recipient.

charityIdstringOptional

Government identifier of the charity.

metadatamap from strings to stringsOptional

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

Response headers

locationstring or null

URI reference to created resource.

Response

Successful request. We created the funding recipient.

recipientTypeenum

Type or legal structure of the funding recipient.

taxIdstring

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

doingBusinessAsstring

Legal name of the business or organization.

addressobject

Polymorphic object that contains address information for a funding recipient.

contactMethodslist of objects

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

ownerslist of objectsRead-only

Array of owner objects associated with the funding recipient.

fundingAccountslist of objectsRead-only

Array of fundingAccount objects associated with the funding recipient.

recipientIdinteger or nullRead-only

Unique identifier that we assigned to the funding recipient.

statusenum or nullRead-only

Indicates if we have approved the funding recipient.

Allowed values:

createdDatedatetime or nullRead-only

Date the funding recipient was created.

lastModifiedDatedatetime or nullRead-only

Date the funding recipient was last modified.

charityIdstring or null

Government identifier of the charity.

metadatamap from strings to strings or null

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

Authentication

Headers

Request

Response headers

Response

Errors