Update

POST

https://api.mercoa.com/organization

POST

/organization

1 from mercoa import Mercoa
2 from mercoa.organization_types import OrganizationRequest
3 
4 client = Mercoa(
5     token="YOUR_TOKEN",
6 )
7 client.organization.update(
8     request=OrganizationRequest(),
9 )

1 {
2   "id": "id",
3   "sandbox": true,
4   "name": "name",
5   "logoUrl": "logoUrl",
6   "faviconUrl": "faviconUrl",
7   "websiteUrl": "websiteUrl",
8   "supportEmail": "supportEmail",
9   "paymentMethods": {
10     "payerPayments": [
11       {
12         "type": "bankAccount",
13         "active": true,
14         "availableDeliveryMethods": [
15           "ACH_STANDARD",
16           "ACH_STANDARD"
17         ],
18         "defaultDeliveryMethod": "ACH_STANDARD",
19         "name": "name"
20       },
21       {
22         "type": "bankAccount",
23         "active": true,
24         "availableDeliveryMethods": [
25           "ACH_STANDARD",
26           "ACH_STANDARD"
27         ],
28         "defaultDeliveryMethod": "ACH_STANDARD",
29         "name": "name"
30       }
31     ],
32     "backupDisbursements": [
33       {
34         "type": "bankAccount",
35         "active": true,
36         "availableDeliveryMethods": [
37           "ACH_STANDARD",
38           "ACH_STANDARD"
39         ],
40         "defaultDeliveryMethod": "ACH_STANDARD",
41         "name": "name"
42       },
43       {
44         "type": "bankAccount",
45         "active": true,
46         "availableDeliveryMethods": [
47           "ACH_STANDARD",
48           "ACH_STANDARD"
49         ],
50         "defaultDeliveryMethod": "ACH_STANDARD",
51         "name": "name"
52       }
53     ],
54     "vendorDisbursements": [
55       {
56         "type": "bankAccount",
57         "active": true,
58         "availableDeliveryMethods": [
59           "ACH_STANDARD",
60           "ACH_STANDARD"
61         ],
62         "defaultDeliveryMethod": "ACH_STANDARD",
63         "name": "name"
64       },
65       {
66         "type": "bankAccount",
67         "active": true,
68         "availableDeliveryMethods": [
69           "ACH_STANDARD",
70           "ACH_STANDARD"
71         ],
72         "defaultDeliveryMethod": "ACH_STANDARD",
73         "name": "name"
74       }
75     ]
76   },
77   "emailProvider": {
78     "sender": {
79       "provider": "none",
80       "fromEmail": "fromEmail",
81       "fromName": "fromName",
82       "hasApiKey": true,
83       "useSmartReplyTo": true
84     },
85     "inboxDomain": "inboxDomain",
86     "alternativeInboxDomains": [
87       "alternativeInboxDomains",
88       "alternativeInboxDomains"
89     ]
90   },
91   "externalAccountingSystemProvider": {
92     "type": "none",
93     "hasApiKey": true
94   },
95   "colorScheme": {
96     "primaryColor": "primaryColor",
97     "secondaryColor": "secondaryColor",
98     "logoBackgroundColor": "logoBackgroundColor",
99     "roundedCorners": 1,
100     "fontFamily": "fontFamily",
101     "fontSize": "fontSize"
102   },
103   "payeeOnboardingOptions": {
104     "enableBusiness": true,
105     "enableIndividual": true,
106     "paymentMethod": true,
107     "business": {
108       "address": {
109         "show": true,
110         "edit": true,
111         "required": true
112       },
113       "averageMonthlyTransactionVolume": {
114         "show": true,
115         "edit": true,
116         "required": true
117       },
118       "averageTransactionSize": {
119         "show": true,
120         "edit": true,
121         "required": true
122       },
123       "bankStatement": {
124         "show": true,
125         "edit": true,
126         "required": true
127       },
128       "description": {
129         "show": true,
130         "edit": true,
131         "required": true
132       },
133       "doingBusinessAs": {
134         "show": true,
135         "edit": true,
136         "required": true
137       },
138       "ein": {
139         "show": true,
140         "edit": true,
141         "required": true
142       },
143       "email": {
144         "show": true,
145         "edit": true,
146         "required": true
147       },
148       "formationDate": {
149         "show": true,
150         "edit": true,
151         "required": true
152       },
153       "logo": {
154         "show": true,
155         "edit": true,
156         "required": true
157       },
158       "maxTransactionSize": {
159         "show": true,
160         "edit": true,
161         "required": true
162       },
163       "mcc": {
164         "show": true,
165         "edit": true,
166         "required": true
167       },
168       "name": {
169         "show": true,
170         "edit": true,
171         "required": true
172       },
173       "phone": {
174         "show": true,
175         "edit": true,
176         "required": true
177       },
178       "representatives": {
179         "show": true,
180         "edit": true,
181         "required": true
182       },
183       "tenNinetyNine": {
184         "show": true,
185         "edit": true,
186         "required": true
187       },
188       "termsOfService": {
189         "show": true,
190         "edit": true,
191         "required": true
192       },
193       "type": {
194         "show": true,
195         "edit": true,
196         "required": true
197       },
198       "w9": {
199         "show": true,
200         "edit": true,
201         "required": true
202       },
203       "website": {
204         "show": true,
205         "edit": true,
206         "required": true
207       }
208     },
209     "individual": {
210       "address": {
211         "show": true,
212         "edit": true,
213         "required": true
214       },
215       "bankStatement": {
216         "show": true,
217         "edit": true,
218         "required": true
219       },
220       "dateOfBirth": {
221         "show": true,
222         "edit": true,
223         "required": true
224       },
225       "email": {
226         "show": true,
227         "edit": true,
228         "required": true
229       },
230       "name": {
231         "show": true,
232         "edit": true,
233         "required": true
234       },
235       "phone": {
236         "show": true,
237         "edit": true,
238         "required": true
239       },
240       "ssn": {
241         "show": true,
242         "edit": true,
243         "required": true
244       },
245       "tenNinetyNine": {
246         "show": true,
247         "edit": true,
248         "required": true
249       },
250       "termsOfService": {
251         "show": true,
252         "edit": true,
253         "required": true
254       },
255       "w9": {
256         "show": true,
257         "edit": true,
258         "required": true
259       }
260     }
261   },
262   "payorOnboardingOptions": {
263     "enableBusiness": true,
264     "enableIndividual": true,
265     "paymentMethod": true,
266     "business": {
267       "address": {
268         "show": true,
269         "edit": true,
270         "required": true
271       },
272       "averageMonthlyTransactionVolume": {
273         "show": true,
274         "edit": true,
275         "required": true
276       },
277       "averageTransactionSize": {
278         "show": true,
279         "edit": true,
280         "required": true
281       },
282       "bankStatement": {
283         "show": true,
284         "edit": true,
285         "required": true
286       },
287       "description": {
288         "show": true,
289         "edit": true,
290         "required": true
291       },
292       "doingBusinessAs": {
293         "show": true,
294         "edit": true,
295         "required": true
296       },
297       "ein": {
298         "show": true,
299         "edit": true,
300         "required": true
301       },
302       "email": {
303         "show": true,
304         "edit": true,
305         "required": true
306       },
307       "formationDate": {
308         "show": true,
309         "edit": true,
310         "required": true
311       },
312       "logo": {
313         "show": true,
314         "edit": true,
315         "required": true
316       },
317       "maxTransactionSize": {
318         "show": true,
319         "edit": true,
320         "required": true
321       },
322       "mcc": {
323         "show": true,
324         "edit": true,
325         "required": true
326       },
327       "name": {
328         "show": true,
329         "edit": true,
330         "required": true
331       },
332       "phone": {
333         "show": true,
334         "edit": true,
335         "required": true
336       },
337       "representatives": {
338         "show": true,
339         "edit": true,
340         "required": true
341       },
342       "tenNinetyNine": {
343         "show": true,
344         "edit": true,
345         "required": true
346       },
347       "termsOfService": {
348         "show": true,
349         "edit": true,
350         "required": true
351       },
352       "type": {
353         "show": true,
354         "edit": true,
355         "required": true
356       },
357       "w9": {
358         "show": true,
359         "edit": true,
360         "required": true
361       },
362       "website": {
363         "show": true,
364         "edit": true,
365         "required": true
366       }
367     },
368     "individual": {
369       "address": {
370         "show": true,
371         "edit": true,
372         "required": true
373       },
374       "bankStatement": {
375         "show": true,
376         "edit": true,
377         "required": true
378       },
379       "dateOfBirth": {
380         "show": true,
381         "edit": true,
382         "required": true
383       },
384       "email": {
385         "show": true,
386         "edit": true,
387         "required": true
388       },
389       "name": {
390         "show": true,
391         "edit": true,
392         "required": true
393       },
394       "phone": {
395         "show": true,
396         "edit": true,
397         "required": true
398       },
399       "ssn": {
400         "show": true,
401         "edit": true,
402         "required": true
403       },
404       "tenNinetyNine": {
405         "show": true,
406         "edit": true,
407         "required": true
408       },
409       "termsOfService": {
410         "show": true,
411         "edit": true,
412         "required": true
413       },
414       "w9": {
415         "show": true,
416         "edit": true,
417         "required": true
418       }
419     }
420   },
421   "metadataSchema": [
422     {
423       "key": "key",
424       "displayName": "displayName",
425       "type": "STRING",
426       "description": "description",
427       "lineItem": true,
428       "allowMultiple": true,
429       "validationRules": {
430         "type": "regex",
431         "errorMessage": "errorMessage",
432         "regex": "regex"
433       },
434       "showConditions": {
435         "alwaysHide": true,
436         "hasOptions": true,
437         "hasDocument": true,
438         "hasNoLineItems": true,
439         "paymentSourceTypes": [
440           "custom",
441           "custom"
442         ],
443         "paymentSourceCustomSchemaIds": [
444           "paymentSourceCustomSchemaIds",
445           "paymentSourceCustomSchemaIds"
446         ],
447         "paymentDestinationTypes": [
448           "custom",
449           "custom"
450         ],
451         "paymentDestinationCustomSchemaIds": [
452           "paymentDestinationCustomSchemaIds",
453           "paymentDestinationCustomSchemaIds"
454         ]
455       },
456       "ocrRules": {
457         "extractFromDocument": true,
458         "predictFromHistory": true
459       }
460     },
461     {
462       "key": "key",
463       "displayName": "displayName",
464       "type": "STRING",
465       "description": "description",
466       "lineItem": true,
467       "allowMultiple": true,
468       "validationRules": {
469         "type": "regex",
470         "errorMessage": "errorMessage",
471         "regex": "regex"
472       },
473       "showConditions": {
474         "alwaysHide": true,
475         "hasOptions": true,
476         "hasDocument": true,
477         "hasNoLineItems": true,
478         "paymentSourceTypes": [
479           "custom",
480           "custom"
481         ],
482         "paymentSourceCustomSchemaIds": [
483           "paymentSourceCustomSchemaIds",
484           "paymentSourceCustomSchemaIds"
485         ],
486         "paymentDestinationTypes": [
487           "custom",
488           "custom"
489         ],
490         "paymentDestinationCustomSchemaIds": [
491           "paymentDestinationCustomSchemaIds",
492           "paymentDestinationCustomSchemaIds"
493         ]
494       },
495       "ocrRules": {
496         "extractFromDocument": true,
497         "predictFromHistory": true
498       }
499     }
500   ],
501   "notificationEmailTemplate": {
502     "backgroundStyle": "backgroundStyle",
503     "header": "header",
504     "body": "body",
505     "signature": "signature",
506     "footer": "footer",
507     "button": "button"
508   },
509   "customDomains": [
510     "customDomains",
511     "customDomains"
512   ],
513   "organizationEntityId": "organizationEntityId",
514   "rolePermissions": {
515     "rolePermissions": [
516       "invoice.all",
517       "invoice.all"
518     ]
519   },
520   "notificationsDisabled": true
521 }

Update current organization

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringOptional

logostringOptional

Base64 encoded logo image.

faviconstringOptional

Base64 encoded favicon image.

websiteUrlstringOptional

supportEmailstringOptional

paymentMethodsobjectOptional

emailProviderobjectOptional

externalAccountingSystemProviderobjectOptional

colorSchemeobjectOptional

payeeOnboardingOptionsobjectOptional

payorOnboardingOptionsobjectOptional

metadataSchemalist of objectsOptional

notificationEmailTemplateobjectOptional

customDomainslist of stringsOptional

rolePermissionsmap from strings to lists of enumsOptional

notificationsDisabledbooleanOptional

If true, all notifications for this organization will be disabled.

Response

This endpoint returns an object.

idstring

sandboxboolean

namestring

logoUrlstring

faviconUrlstring

websiteUrlstring

supportEmailstring

paymentMethodsobject

emailProviderobject

externalAccountingSystemProviderobject

colorSchemeobject

payeeOnboardingOptionsobject

payorOnboardingOptionsobject

metadataSchemalist of objects

notificationEmailTemplateobject

customDomainslist of strings

organizationEntityIdstring

rolePermissionsmap from strings to lists of enums

notificationsDisabledboolean

Errors

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

501

Unimplemented