Update Institution

Overview

You can update an Institution by modifying its existing information or adding information for an optional field by using the POST method, as described below.

Resource Access

POST https://<hostname>/buyer/v1/institution/<institutionId>

Arguments

Field	Sub-field	Additional Information
name		Optional
address		Optional
	street1	Optional
	city	Optional
	state	Optional
	country	Optional
	postalCode	Optional
status		Mandatory
externalStatus		Mandatory
Contacts		Optional
	name	Optional
	title	Optional
	email	Optional
	phone	Optional
	primary	Optional
associatedNetworkName		Optional
associatedNetworkId		Mandatory
fid		Mandatory
associatedBrandName		Optional
associatedBrandId		Optional
externalUnderwriting		Optional
schedulePaymentsForFuture		Optional
invoiceUploadEnabled		Optional
AlertApi	card/ach/check/suppllier	Optional, cannot be enabled while creating
	enabled	Optional, False by default
	username	Mandatory if enabled node is true
	password	Mandatory if enabled node is true
	endpoint	Mandatory if enabled node is true
generateScheduledUserReportActive		Optional
StaticReport		Optional
	enabled	Optional - False by default
	externalLinks label Value	Label - value combination must be passed together
paymentFileTypes		Custom Flat parser
	id	Optional
	name	Mandatory if ID is passed
bankAccounts		Optional
	accountNumber	Mandatory to be passed if bank account node is being passed
	routingNumber	Mandatory to be passed if bank account node is being passed
	accountType	Mandatory to be passed if bank account node is being passed
	defaults	items: type: string enum: Revenue Fees Goodfunds
debitMethod		Optional
achDelayDays		Mandatory
vcnHost		Optional
vcnHostConfig		Optional
	falcons A. products Type value default B. location	One Product is mandatory if vcnhost config is being passed
	braves companyNumber billLevel corpId clientUserId clientOrg	All subnodes are mandatory if braves node is being passed. Only a valid combination for corpID, clientUserID and client Org will be applicable
	vpa clientId implementationType pp rva	clientId is mandatory for VPA. implementationType is mandatory. Either pp or rva to be passed with default as true
automaticIdentityVerification		Optional, true by default
includeVcnInDisposition		Optional, false by default
automaticVcnCardCreation		Optional, false by default
suppressSIPEmail		Optional, false by default
suppressStatement		Optional, false by default
checkSettings		Optional
	checkProcessorEnabled	Optional
	clientId	Optional , Mandatory Only used if checkProcessorEnabled is true
	apiKey	Optional , Mandatory Only used if checkProcessorEnabled is true
	memoMappingEnabled	Optional
	memoMapping	Optional, Reference 1 by default
	isManagedCheck	Optional, false by default
	checkInsertEnabled	optional, False by default
updateAllBuyers		Optional, False by default
mri	clientID	Optional, mandatory if MRI nodes is being passed
	database	Optional, mandatory if MRI nodes is being passed
	username	Optional, mandatory if MRI nodes is being passed
	password	Optional, mandatory if MRI nodes is being passed
pifConfirmationEmail		Optional, Email for disposition notification
pifApproval		Optional
pifApprovalConfig		Optional
	level	Mandatory of pifApproval node is true
	DEFAULT threshold firstLevel secondLevel requireAllLevelApproval Approvers firstLevel secondLevel	Threshold- Mandatory firstLevel - Mandatory secondLevel- Optional requireAllLevelApproval- Optional Approvers firstLevel- Mandatory secondLevel- Optional, mandatory if second level threshold is added
plastiqPayEnabled		Optional
buyerWalletEnabled		Optional

Example Request

🚧
Update an Institution:
POST https://<hostname>/institution/v1/institution/ccd125d1-b23b-5485-9721-d44ae26ddc93
Host: <hostname>
Authorization: Bearer <JWT token>
Content-Type: application/json


    { "name": "Test API Institution",
     "address": {
         "street1": "150 Street",
         "city": "New City",
         "state": "AL",
         "country": "USA",
         "postalCode": "10001"
     },
     "status": "Approved",
     "externalStatus": "Active",
     "contacts": [
         {
             "primary": true,
             "name": "John Smith",
             "title": "contact position",
             "email": "[email protected]",
             "phone": "1231212321"
         }
     ],
     "associatedNetworkName": "APINetworktesting1234567890",
     "associatedNetworkId": "cebc25a1-186d-509f-bcde-63df16250fbc",
     "fid": "APIinstitute",
     "associatedBrandName": "Wisconsin Bank & Trust",
     "associatedBrandId": "b06dff1a-f378-5487-b403-ee5f17898d58",
     "externalUnderwriting": false,
     "schedulePaymentsForFuture": false,
     "invoiceUploadEnabled": true,
     "alertApi": {
          
             "card": {
                 "enabled": true,
                 "username": "cardUsername",
                 "password": "Password",
                 "endpoint": "CardAlertEndpoint"
                  },
              "ach": {
                 "enabled": true,
                 "username": "ACHusername",
                 "password": "Password",
                 "endpoint": "ACHAlertEndpoint"
                 },
             "check": {
                 "enabled": true,
                 "username": "Checkusername",
                 "password": "Password",
                 "endpoint": "CheckAlertEndpoint"
                 },
              "wire": {
                 "enabled": true,
                 "username": "Checkusername",
                 "password": "Password",
                 "endpoint": "CheckAlertEndpoint"
                 },
             "supplier": {
                 "enabled": true,
                 "username": "supplierUsername",
                 "password": "Password",
                 "endpoint": "supplierAlertEndpoint"
                  }
             },
     "generateScheduledUserReportActive": true,
      "staticReport": {
         "enabled": true,
         "externalLinks": [
             {
                 "label": "hello",
                 "value": "https://uat.cpxchange.com/"
             }
         ]
     },
     "paymentFileTypes": [
             "id": "customfileID",
             "name": "nameOfCustomParser"
  
     ],
     "bankAccounts": [
         {
             "accountNumber": "12309747239923802",
             "routingNumber": "121000248",
             "accountType": "savings",
             "defaults": [
                 "GOODFUNDS",
                 "FEES",
                 "REVENUE"
             ]
         }
     ],
     "debitMethod": "Manual",
     "achDelayDays": 0,
     "vcnHost": "falcons",
     "vcnHostConfig": {
         "falcons": {
             "products": [
                 {
                     "type": "VCN",
                     "value": "6034",
                     "default": true
                 },
                 {
                     "type": "LDG",
                     "value": "6047",
                     "default": true
                 }
             ],
             "location": "12337"
         },
         "braves": {
             "companyNumber": "99999",
             "billLevel": "buyer",
             "corpId": "NA"
         }, 
          "vpa": {
              "pp": {
                  "default": true
              },
              "rva": {
                  "default": false
              },
              "clientId": "B2BWS_4_9_4477"
          }
  
     },
  "pifApproval": true,
     "pifApprovalConfig": {
         "level": "pif",
         "DEFAULT": {
             "approvers": {
                 "firstLevel": [
                     { "5d655f8d-1835-5e78-904a-08a29a8c086d"
                
                     }
                 ]
             },
             "threshold": {
                 "firstLevel": 0
             }
         }
     },
  
     "automaticIdentityVerification": true,
     "companyNumber": "99999",
     "includeVcnInDisposition": true,
     "automaticVcnCardCreation": true,
     "suppressSIPEmail": true,
     "suppressStatement": true,
    "updateAllBuyers": false,
     "checkSettings": {
         "checkProcessorEnabled": true,
         "clientId": "234",
         "apiKey": "retyfgaschagcdhakjciuhdsyf236evascshggydhjc",
         "memoMappingEnabled": true,
         "memoMapping": "reference1",
         "isManagedCheck": true,
         "checkInsertEnabled": false 
        
     },
     "mri": {
         "clientId": "",
         "database": "",
         "username": "",
         "password": ""
     },
  "plastiqPayEnabled" : true
  "buyerWalletEnabled" : true
  }

Example Response

👍
HTTP Status: 204