Renewal Delete Beneficiary

The Renewal Delete Beneficiary API is used to renew a deleted beneficiary. A "RENEWAL_BENEFICIARY" ticket will be created. Once the ticket is approved, the beneficiary's information will be updated, and its status will be set to active. Legal representatives who have the "CanManageBeneficiary " permission can renew a deleted beneficiary.

Method: POST

{{URL}}/jsonrpc

Headers

Name	Value
Content-Type	application/json

Example

Payload Parameters

Parameter	Description
beneficiaryID Mandatory	String The unique identifier of the beneficiary to be renewed Ex:"64e341a0af707b83dcfdaf0b "
operationType Mandatory	String The type of operation Ex:"RENEWAL "
firstName Mandatory	String First name of the beneficiary Ex:"Chenna "
lastName Mandatory	String Last name of the beneficiary Ex:"ChennReddy "
type Mandatory	String Type of beneficiary Ex:"BUSINESS", "INDIVIDUAL "
accountType Mandatory	String Account type Ex:"DIGITAL_ASSET "
customerID Mandatory	String Unique identifier of the customer associated with the beneficiary Ex:"100000000048001 "
network Mandatory	String Network associated with the beneficiary Ex:"STELLER "
publicKey Mandatory	String Unique account identifier of the beneficiary Ex:"GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT "
contact	Object
phoneNumber Mandatory	String Phone number of the beneficiary Ex:"1234567890 "
email Mandatory	String Email address of the beneficiary Ex:"chennareddy.s+099@netxd.com "
address	Object
country Mandatory	String Country of the beneficiary's address Ex:"US "
line1 Mandatory	String Address line 1 Ex:"alaska "
addressLine2 Mandatory	String Address line 2 Ex:"alaska "
city Mandatory	String City of the beneficiary's address Ex:"Seattle "
state Mandatory	String State of the beneficiary's address Ex:"WA "
zipCode Mandatory	String Zip code of the beneficiary's address Ex:"98104 "
isInternal Mandatory	Boolean Indicates whether the beneficiary is internal (true) or external (false) Ex: true

cURL

curl --location 'https://wallet.netxd.com/plwallet/rpc/WalletService/EditBeneficiaryByID' \
--header 'DeviceID: 8020' \
--header 'Signature: keyId=8020,algorithm=ecdsa-sha256,signature=MEUCIQCNi1vjPf/HpI9R2DXnc0Zt1s6YmWyA4H1x813lJ+tuDgIgB+lrc+iCMyTUGiraG9kGKNDXYiz7RfBBtifr5wUQs54=' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ci5hbmJhbGFnYW5AbmV0eGQuY29tOmQ0Mjc2ZmIx' \
--data-raw '{"beneficiaryID":"64e341a0af707b83dcfdaf0b","operationType":"RENEWAL","FirstName":"Chenna","LastName":"hi","Type":"INDIVIDUAL","accountType":"DIGITAL_ASSET","customerID":"100000000048001","network":"STELLER","publicKey":"GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT","contact":{"phoneNumber":"1234567890","email":"chennareddy.s+099@netxd.com"},"address":{"country":"US","line1":"alaska","addressLine2":"alaska","city":"Seattle","state":"WA","zipcode":"98104"},"isInternal":false}'

C#

var options = new RestClientOptions("https://wallet.netxd.com")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("/plwallet/rpc/WalletService/EditBeneficiaryByID", Method.Post);
request.AddHeader("DeviceID", "8020");
request.AddHeader("Signature", "keyId=8020,algorithm=ecdsa-sha256,signature=MEUCIQCNi1vjPf/HpI9R2DXnc0Zt1s6YmWyA4H1x813lJ+tuDgIgB+lrc+iCMyTUGiraG9kGKNDXYiz7RfBBtifr5wUQs54=");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Basic ci5hbmJhbGFnYW5AbmV0eGQuY29tOmQ0Mjc2ZmIx");
var body = @"{" + "\n" +
@"    ""beneficiaryID"": ""64e341a0af707b83dcfdaf0b""," + "\n" +
@"    ""operationType"": ""RENEWAL""," + "\n" +
@"    ""FirstName"": ""Chenna""," + "\n" +
@"    ""LastName"": ""hi""," + "\n" +
@"    ""Type"": ""INDIVIDUAL""," + "\n" +
@"    ""accountType"": ""DIGITAL_ASSET""," + "\n" +
@"    ""customerID"": ""100000000048001""," + "\n" +
@"    ""network"": ""STELLER""," + "\n" +
@"    ""publicKey"": ""GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT""," + "\n" +
@"    ""contact"": {" + "\n" +
@"        ""phoneNumber"": ""1234567890""," + "\n" +
@"        ""email"": ""chennareddy.s+099@netxd.com""" + "\n" +
@"    }," + "\n" +
@"    ""address"": {" + "\n" +
@"        ""country"": ""US""," + "\n" +
@"        ""line1"": ""alaska""," + "\n" +
@"        ""addressLine2"": ""alaska""," + "\n" +
@"        ""city"": ""Seattle""," + "\n" +
@"        ""state"": ""WA""," + "\n" +
@"        ""zipcode"": ""98104""" + "\n" +
@"    }," + "\n" +
@"    ""isInternal"": false" + "\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 := "https://wallet.netxd.com/plwallet/rpc/WalletService/EditBeneficiaryByID"
  method := "POST"

  payload := strings.NewReader(`{
    "beneficiaryID": "64e341a0af707b83dcfdaf0b",
    "operationType": "RENEWAL",
    "FirstName": "Chenna",
    "LastName": "hi",
    "Type": "INDIVIDUAL",
    "accountType": "DIGITAL_ASSET",
    "customerID": "100000000048001",
    "network": "STELLER",
    "publicKey": "GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT",
    "contact": {
        "phoneNumber": "1234567890",
        "email": "chennareddy.s+099@netxd.com"
    },
    "address": {
        "country": "US",
        "line1": "alaska",
        "addressLine2": "alaska",
        "city": "Seattle",
        "state": "WA",
        "zipcode": "98104"
    },
    "isInternal": false
}`)

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

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("DeviceID", "8020")
  req.Header.Add("Signature", "keyId=8020,algorithm=ecdsa-sha256,signature=MEUCIQCNi1vjPf/HpI9R2DXnc0Zt1s6YmWyA4H1x813lJ+tuDgIgB+lrc+iCMyTUGiraG9kGKNDXYiz7RfBBtifr5wUQs54=")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Basic ci5hbmJhbGFnYW5AbmV0eGQuY29tOmQ0Mjc2ZmIx")

  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': 'wallet.netxd.com',
  'path': '/plwallet/rpc/WalletService/EditBeneficiaryByID',
  'headers': {
    'DeviceID': '8020',
    'Signature': 'keyId=8020,algorithm=ecdsa-sha256,signature=MEUCIQCNi1vjPf/HpI9R2DXnc0Zt1s6YmWyA4H1x813lJ+tuDgIgB+lrc+iCMyTUGiraG9kGKNDXYiz7RfBBtifr5wUQs54=',
    'Content-Type': 'application/json',
    'Authorization': 'Basic ci5hbmJhbGFnYW5AbmV0eGQuY29tOmQ0Mjc2ZmIx'
  },
  '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({
  "beneficiaryID": "64e341a0af707b83dcfdaf0b",
  "operationType": "RENEWAL",
  "FirstName": "Chenna",
  "LastName": "hi",
  "Type": "INDIVIDUAL",
  "accountType": "DIGITAL_ASSET",
  "customerID": "100000000048001",
  "network": "STELLER",
  "publicKey": "GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT",
  "contact": {
    "phoneNumber": "1234567890",
    "email": "chennareddy.s+099@netxd.com"
  },
  "address": {
    "country": "US",
    "line1": "alaska",
    "addressLine2": "alaska",
    "city": "Seattle",
    "state": "WA",
    "zipcode": "98104"
  },
  "isInternal": false
});

req.write(postData);

req.end();

Body

{
    "beneficiaryID": "64e341a0af707b83dcfdaf0b",
    "operationType": "RENEWAL",
    "FirstName": "Chenna",
    "LastName": "hi",
    "Type": "INDIVIDUAL",
    "accountType": "DIGITAL_ASSET",
    "customerID": "100000000048001",
    "network": "STELLER",
    "publicKey": "GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT",
    "contact": {
        "phoneNumber": "1234567890",
        "email": "chennareddy.s+099@netxd.com"
    },
    "address": {
        "country": "US",
        "line1": "alaska",
        "addressLine2": "alaska",
        "city": "Seattle",
        "state": "WA",
        "zipcode": "98104"
    },
    "isInternal": false
}

Response: 200

Response Parameters

Parameter	Description
id	String Unique identifier of the ticket Ex:"350004 "
requestID	String Identifier for the request Ex:"350003 "
customerID	String Unique identifier of the customer Ex:"100000000048001 "
applicationCode	String Application code associated with the ticket Ex:"PL "
ticketName	String Name of the ticket Ex:"RENEWAL_BENEFICIARY "
createdTS	String Timestamp when the ticket was created Ex:"2023-08-25T18:49:49.14620225+05:30 "
updatedTS	String Timestamp of the last update to the ticket Ex:"2023-08-25T18:49:49.146202319+05:30 "
createdBy	String User who created the ticket Ex:"chennareddy.s+106@netxd.com "
payloadJSON	Object
customerID	String Unique identifier of the customer Ex:"100000000048001 "
currentBeneficiaryData	Object
ID	String Unique identifier of the beneficiary entry Ex:"64e341a0af707b83dcfdaf0b "
createdDate	String Timestamp when the beneficiary entry was created Ex:"2023-08-21T10:51:12.703Z "
updatedDate	String Timestamp of the last update to the beneficiary entry Ex:"0001-01-01T00:00:00Z "
type	String Type of beneficiary Ex:"BUSINESS","INDIVIDUAL "
firstName	String First name of the beneficiary Ex:"Chenna "
lastName	String Last name of the beneficiary Ex:"Reddy "
accountType	String Account type Ex:"DIGITAL_ASSET "
contact	Object
email	String Email address of the beneficiary Ex:"chennareddy.s+099@netxd.com "
phoneNumber	String Phone number of the beneficiary Ex:"1234567890 "
address	Object
line1	String Address line 1 Ex:"alaska "
city	String City of the beneficiary's address Ex:"Seattle "
state	String State of the beneficiary's address Ex:"WA "
country	String Country of the beneficiary's address Ex:"US"
zipCode	String Zip code of the beneficiary's address Ex:"98104 "
createdBy	String Email address of the user who created the beneficiary entry Ex:"chennareddy.s+106@netxd.com "
accountId	String Account ID of the beneficiary Ex:"1614001 "
status	String Status of the beneficiary Ex:"DELETED "
customerID	String Unique identifier of the customer associated with the beneficiary Ex:"2345001 "
publicKey	String Public key associated with the beneficiary Ex:"GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT "
network	String Network associated with the beneficiary Ex:"STELLER "
ceResponse	Object
result	String Context Engine watchlist result Ex:"success "
detail	String Context Engine watchlist details Ex:"success "
risk	Object
riskScore	String Risk score of the beneficiary Ex:"0 "
ofac	Object
watchList	Object
INDIVIDUALTransactionNumber	String Individual Transaction number Ex:"1707 "
updateHistory	Array
userName	String Email address of the user who updated Ex:"chennareddy.s+106@netxd.com "
updatedDate	String Timestamp of the update Ex:"2023-08-21T10:51:35.453Z "
newBeneficiaryData	Object
ID	String Unique identifier of the beneficiary entry Ex:"000000000000000000000000 "
createdDate	String Timestamp when the beneficiary entry was created Ex:"0001-01-01T00:00:00Z "
updatedDate	String Timestamp of the last update to the beneficiary entry Ex:"0001-01-01T00:00:00Z "
type	String Type of beneficiary Ex:"BUSINESS","INDIVIDUAL "
firstName	String First name of the beneficiary Ex:"Chenna "
lastName	String Last name of the beneficiary Ex:"ChennReddy "
accountType	String Account type Ex:"DIGITAL_ASSET "
contact	Object
email	String Email address of the beneficiary Ex:"chennareddy.s+099@netxd.com "
phoneNumber	String Phone number of the beneficiary Ex:"1234567890 "
address	Object
line1	String Address line 1 Ex:"alaska "
city	String City of the beneficiary's address Ex:"Seattle "
state	String State of the beneficiary's address Ex:"WA "
country	String Country of the beneficiary's address Ex:"US"
zipCode	String Zip code of the beneficiary's address Ex:"98104 "
customerID	String Unique identifier of the customer associated with the beneficiary Ex:"100000000048001 "
publicKey	String Unique account identifier of the beneficiary Ex:"GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT "
network	String Network associated with the beneficiary Ex:"STELLER "
beneficiaryID	String Unique identifier of the beneficiary entry Ex:"64e341a0af707b83dcfdaf0b "
isInternal	Boolean Indicates whether the beneficiary is internal (true) or external (false) Ex: false
operationType	String The type of operation Ex:"RENEWAL "
Key	String Additional information key name Ex:""
Value	String Additional information key value Ex:""
state	String The current state of the ticket Ex:"OPEN "
status	String The status of the ticket Ex:"WAITING_FOR_APPROVAL "
noOfApproval	String The number of approvals required for the ticket to be completed Ex:"1 "
ticketHistory	Array
updatedBy	String Email address of the user who updated Ex:"chennareddy.s+106@netxd.com "
updatedDate	String Timestamp of the update Ex:"2023-08-10T21:43:10.700471401+05:30 "
state	String Email address of the user who updated Ex:"OPEN "

{
  "id": "395004",
  "requestID": "395003",
  "customerID": "100000000048001",
  "applicationCode": "PL",
  "ticketName": "RENEWAL_BENEFICIARY",
  "createdTS": "2023-08-25T18:49:49.14620225+05:30",
  "updatedTS": "2023-08-25T18:49:49.146202319+05:30",
  "createdBy": "chennareddy.s+106@netxd.com",
  "payloadJSON": {
    "customerID": "100000000048001",
    "currentBeneficiaryData": {
      "ID": "64e341a0af707b83dcfdaf0b",
      "createdDate": "2023-08-21T10:51:12.703Z",
      "updatedDate": "0001-01-01T00:00:00Z",
      "type": "INDIVIDUAL",
      "firstName": "Chenna",
      "lastName": "hi",
      "accountType": "DIGITAL_ASSET",
      "contact": {
        "email": "chennareddy.s+099@netxd.com",
        "phoneNumber": "1234567890"
      },
      "address": {
        "line1": "alaska",
        "city": "Seattle",
        "state": "WA",
        "country": "US",
        "zipCode": "98104"
      },
      "createdBy": "chennareddy.s+106@netxd.com",
      "status": "DELETED",
      "customerID": "100000000048001",
      "publicKey": "GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT",
      "network": "STELLER",
      "ceResponse": {
        "result": "success",
        "detail": "success",
        "risk": {
          "riskScore": "0"
        },
        "ofac": {},
        "watchList": {},
        "internalTransactionNumber": "1707"
      },
      "updateHistory": [
        {
          "userName": "chennareddy.s+106@netxd.com",
          "updatedDate": "2023-08-21T10:51:35.453Z"
        },
        {
          "userName": "chennareddy.s+106@netxd.com",
          "updatedDate": "2023-08-21T10:55:14.872Z"
        },
        {
          "userName": "chennareddy.s+106@netxd.com",
          "updatedDate": "2023-08-21T10:57:07.761Z"
        },
        {
          "userName": "chennareddy.s+106@netxd.com",
          "updatedDate": "2023-08-21T10:58:07.712Z"
        }
      ],
      "isInternal": false
    },
    "newBeneficiaryData": {
      "ID": "000000000000000000000000",
      "createdDate": "0001-01-01T00:00:00Z",
      "updatedDate": "0001-01-01T00:00:00Z",
      "type": "INDIVIDUAL",
      "firstName": "Chenna",
      "lastName": "hi",
      "accountType": "DIGITAL_ASSET",
      "contact": {
        "email": "chennareddy.s+099@netxd.com",
        "phoneNumber": "1234567890"
      },
      "address": {
        "line1": "alaska",
        "city": "Seattle",
        "state": "WA",
        "country": "US",
        "zipCode": "98104"
      },
      "customerID": "100000000048001",
      "publicKey": "GBWHB6HEPJPT5WV7UJTLAKPAGV336ER55FCEZFT5QGYOEME75HPS3EYT",
      "network": "STELLER",
      "beneficiaryID": "64e341a0af707b83dcfdaf0b",
      "isInternal": false,
      "operationType": "RENEWAL"
    },
    "Key": "",
    "Value": ""
  },
  "state": "OPEN",
  "status": "WAITING_FOR_APPROVAL",
  "noOfApproval": 1,
  "ticketHistory": [
    {
      "updatedBy": "chennareddy.s+106@netxd.com",
      "updatedDate": "2023-08-25T18:49:49.147073378+05:30",
      "state": "OPEN"
    }
  ]
}