Update Legal Representative

'UpdateLegalRep' API enables to update legal representative of the business customer account

Bank or financial institution can update the existing legal representative details and can enable or disable account authorization settings. On providing the required details as request, the legalrep information is updated with confirmation message.

Method: POST

{{URL}}/jsonrpc

Headers

Name	Value
Content-Type	application/json

Example

Payload Parameters

Parameter	Description
method Mandatory	String API method that is being called to update Legal Representative through customer service Constant value: "CustomerService.UpdateLegalRep"
id Mandatory	String Unique ID of API request Sample value: "1"
params Mandatory	Object
api Mandatory	Object
signature Mandatory	String Signature for request validation Sample value: "signature"
keyId Mandatory	String API key used for request authentication Sample value: "ApplicationKeyId"
credential Mandatory	String API credential provided by NetXD Sample value: "credential"
payload Mandatory	Object
ID Mandatory	String Unique ID assigned to the Legal Rep Sample value – "1341008"
Name Mandatory	String Name of the Legal Representative Sample value – "Ach test"
DOB Mandatory	String Date of birth of the Legal Representative Sample value – "20000705"
Address Mandatory	Object
country Mandatory	String Country code of the Legal Representative address Sample value – "US"
Contact Mandatory	Object
email Mandatory	String Contact email address of the legal representative Sample value – "achtest@gmail.com"
phoneNumber Mandatory	String Contact phone number of the legal representative Sample value – "9856321470"
InstitutionID Mandatory	String Routing number of the bank or financial institution of the legal representative Sample value – "101115399"
InstitutionName Mandatory	String Name of the bank or financial institution of the legal representative Sample value – "Ach"
identification Mandatory	Object
type Mandatory	String Type of the identification of Legal Representative Constant value – "SSN"
value Mandatory	String Value of the respective identification type Sample value – "878992904"
Notes Optional	String Notes or Description given for the legal representative account Sample value – "dev test"
UserFlags Optional	Object
authorizeTransaction Optional	Boolean Whether the legal representative user account can process the transaction initiated by another legal representative Sample value – true
selfAuthorizeTransaction Optional	Boolean Whether the legal representative user account can authorize the self-initiated transaction Sample value – true
canInitiateTransfer Optional	Boolean Whether the legal representative user account can initiate transaction Sample value – true
canApproveNewRoute Optional	Boolean Whether the legal representative user account can allow approval option for added beneficiary Sample value – false
internalTransfer Optional	Boolean Whether the legal representative user account can enable internal transfer Sample value – false

cURL

curl --location --globoff '{{URL}}/jsonrpc' \
--header 'Content-Type: application/json' \
--data-raw '{"method":"CustomerService.UpdateLegalRep","id":"1","params":{"api":{"signature":"{{signature}}","keyId":"{{ApplicationKeyId}}","credential":"{{credential}}"},"payload":{"ID":"1341008","Name":"Ach test","DOB":"20000705","Address":{"country":"US"},"Contact":{"email":"achtest@gmail.com","phoneNumber":"9856321470"},"InstitutionID":"101115399","InstitutionName":"Ach","identification":{"type":"SSN","value":"878992904"},"Notes":"dev test","UserFlags":{"authorizeTransaction":true,"selfAuthorizeTransaction":true,"canInitiateTransfer":true,"canApproveNewRoute":false,"internalTransfer":false}}}}'

C#

var options = new RestClientOptions("{{URL}}/jsonrpc")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"  ""method"": ""CustomerService.UpdateLegalRep"",
" + "\n" +
@"  ""id"": ""1"",
" + "\n" +
@"  ""params"": {
" + "\n" +
@"    ""api"": {
" + "\n" +
@"      ""signature"": ""{{signature}}"",
" + "\n" +
@"      ""keyId"": ""{{ApplicationKeyId}}"",
" + "\n" +
@"      ""credential"": ""{{credential}}""
" + "\n" +
@"    },
" + "\n" +
@"    ""payload"": {
" + "\n" +
@"      ""ID"": ""1341008"",
" + "\n" +
@"      ""Name"": ""Ach test"",
" + "\n" +
@"      ""DOB"": ""20000705"",
" + "\n" +
@"      ""Address"": {
" + "\n" +
@"        ""country"": ""US""
" + "\n" +
@"      },
" + "\n" +
@"      ""Contact"": {
" + "\n" +
@"        ""email"": ""achtest@gmail.com"",
" + "\n" +
@"        ""phoneNumber"": ""9856321470""
" + "\n" +
@"      },
" + "\n" +
@"      ""InstitutionID"": ""101115399"",
" + "\n" +
@"      ""InstitutionName"": ""Ach"",
" + "\n" +
@"      ""identification"": {
" + "\n" +
@"        ""type"": ""SSN"",
" + "\n" +
@"        ""value"": ""878992904""
" + "\n" +
@"      },
" + "\n" +
@"      ""Notes"": ""dev test"",
" + "\n" +
@"      ""UserFlags"": {
" + "\n" +
@"        ""authorizeTransaction"": true,
" + "\n" +
@"        ""selfAuthorizeTransaction"": true,
" + "\n" +
@"        ""canInitiateTransfer"": true,
" + "\n" +
@"        ""canApproveNewRoute"": false,
" + "\n" +
@"        ""internalTransfer"": false
" + "\n" +
@"      }
" + "\n" +
@"    }
" + "\n" +
@"  }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "{{URL}}/jsonrpc"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
  "method": "CustomerService.UpdateLegalRep",`+"
"+`
  "id": "1",`+"
"+`
  "params": {`+"
"+`
    "api": {`+"
"+`
      "signature": "{{signature}}",`+"
"+`
      "keyId": "{{ApplicationKeyId}}",`+"
"+`
      "credential": "{{credential}}"`+"
"+`
    },`+"
"+`
    "payload": {`+"
"+`
      "ID": "1341008",`+"
"+`
      "Name": "Ach test",`+"
"+`
      "DOB": "20000705",`+"
"+`
      "Address": {`+"
"+`
        "country": "US"`+"
"+`
      },`+"
"+`
      "Contact": {`+"
"+`
        "email": "achtest@gmail.com",`+"
"+`
        "phoneNumber": "9856321470"`+"
"+`
      },`+"
"+`
      "InstitutionID": "101115399",`+"
"+`
      "InstitutionName": "Ach",`+"
"+`
      "identification": {`+"
"+`
        "type": "SSN",`+"
"+`
        "value": "878992904"`+"
"+`
      },`+"
"+`
      "Notes": "dev test",`+"
"+`
      "UserFlags": {`+"
"+`
        "authorizeTransaction": true,`+"
"+`
        "selfAuthorizeTransaction": true,`+"
"+`
        "canInitiateTransfer": true,`+"
"+`
        "canApproveNewRoute": false,`+"
"+`
        "internalTransfer": false`+"
"+`
      }`+"
"+`
    }`+"
"+`
  }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

NodeJS

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': '{{URL}}',
  'path': '/jsonrpc',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "CustomerService.UpdateLegalRep",
  "id": "1",
  "params": {
    "api": {
      "signature": "{{signature}}",
      "keyId": "{{ApplicationKeyId}}",
      "credential": "{{credential}}"
    },
    "payload": {
      "ID": "1341008",
      "Name": "Ach test",
      "DOB": "20000705",
      "Address": {
        "country": "US"
      },
      "Contact": {
        "email": "achtest@gmail.com",
        "phoneNumber": "9856321470"
      },
      "InstitutionID": "101115399",
      "InstitutionName": "Ach",
      "identification": {
        "type": "SSN",
        "value": "878992904"
      },
      "Notes": "dev test",
      "UserFlags": {
        "authorizeTransaction": true,
        "selfAuthorizeTransaction": true,
        "canInitiateTransfer": true,
        "canApproveNewRoute": false,
        "internalTransfer": false
      }
    }
  }
});

req.write(postData);

req.end();

Body

{
  "method": "CustomerService.UpdateLegalRep",
  "id": "1",
  "params": {
    "api": {
      "signature": "{{signature}}",
      "keyId": "{{ApplicationKeyId}}",
      "credential": "{{credential}}"
    },
    "payload": {
      "ID": "1341008",
      "Name": "Ach test",
      "DOB": "20000705",
      "Address": {
        "country": "US"
      },
      "Contact": {
        "email": "achtest@gmail.com",
        "phoneNumber": "9856321470"
      },
      "InstitutionID": "101115399",
      "InstitutionName": "Ach",
      "identification": {
        "type": "SSN",
        "value": "878992904"
      },
      "Notes": "dev test",
      "UserFlags": {
        "authorizeTransaction": true,
        "selfAuthorizeTransaction": true,
        "canInitiateTransfer": true,
        "canApproveNewRoute": false,
        "internalTransfer": false
      }
    }
  }
}

Response: 200

Response Parameters

Parameter	Description
id	String Response ID echoed from the request ID Sample value – "1"
result	Object
message	String Message that confirms the changes updated for Legal Representative Sample value – "LegalRep Updated Successfully"

{
  "id": "1",
  "result": {
    "Message": "LegalRep Updated Successfully"
  }
}