{"_id":"59f79e3c584eb200345cec67","project":"59f79e3c584eb200345ceafc","version":{"_id":"59f79e3c584eb200345ceaff","project":"59f79e3c584eb200345ceafc","__v":6,"createdAt":"2015-09-17T03:47:20.956Z","releaseDate":"2015-09-17T03:47:20.956Z","categories":["59f79e3c584eb200345ceb3a","59f79e3c584eb200345ceb3b","59f79e3c584eb200345ceb3c","59f79e3c584eb200345ceb3d","59f79e3c584eb200345ceb3e","59f79e3c584eb200345ceb3f","59f79e3c584eb200345ceb45","59f79e3c584eb200345ceb46","59f79e3c584eb200345ceb48","59f79e3c584eb200345ceb49","5aa21b60c0bda0002d1568b6","5afb6888212c690003ae3d3b","5b4bdcd3737d1800031d2293","5b9ed89212362100036b5a1c","5bb29bec77c22500034757ea","5bb29bfe77c22500034757ec"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.1.0","version":"3.1"},"category":{"_id":"59f79e3c584eb200345ceb49","project":"59f79e3c584eb200345ceafc","version":"59f79e3c584eb200345ceaff","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-09-26T01:58:05.060Z","from_sync":false,"order":7,"slug":"subnets","title":"Subnets"},"user":"54e4044e8ef7552300409dcb","__v":0,"parentDoc":null,"githubsync":"","updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-09-26T06:20:12.582Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Subnets resources are generic subnet classes that store basic information regarding a node's subnet.\n\nSubnets are virtual account and routing numbers issued on top of Synapse managed [Deposit Accounts](doc:deposit-accounts). Developers can use subnets to allow users to be able to fund or debit their deposit account via external ACH or Wire transfers.\n\nThese account and routing numbers can be plugged into any third party software that is capable of sending ACHs or Wires and when the transfers arrive, a [transaction](doc:trans-resources) will be created automatically and funds will be added to or taken from the associated deposit account.\n\n## Subnet Permissions\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Permission\",\n    \"h-1\": \"Comment\",\n    \"0-0\": \"CREDIT\",\n    \"0-1\": \"Subnet can receive funds via ACH or Wire transfers\",\n    \"1-0\": \"DEBIT\",\n    \"1-1\": \"Subnet can be debited funds via ACH or Wire transfers\",\n    \"2-0\": \"CREDIT-AND-DEBIT\",\n    \"2-1\": \"Subnet can be debited or credited funds via ACH or Wire transfers\",\n    \"3-0\": \"LOCKED\",\n    \"3-1\": \"Subnet has been locked and any new credits will be returned\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\nEvery subnet object has a set of permissions associated with them as follows.\n\n## Subnet Object\n[block:html]\n{\n  \"html\": \"<div class=\\\"api-manager\\\"><hr class=\\\"bottom\\\"><div class=\\\"param-table\\\"><div class=\\\"table\\\"><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>_id<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Object ID of a transaction</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong><span class=\\\"text-muted\\\">_links.self.</span>href<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>HAL style link for the node</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>account_num<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Account number associated with the subnet</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong><span class=\\\"text-muted\\\">client.</span>id<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>ID of the client where the transaction initiated</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong><span class=\\\"text-muted\\\">client.</span>name<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Name of the client where the transaction initiated</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>allowed<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Denotes the subnet standing. Look at <a href=\\\"#section-subnet-permissions\\\">subnet permissions</a> section above to learn more</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>nickname<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Any nickname/common name given to the node. Eg. Payroll AC/RT</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>node_id<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Node ID associated with the subnet. Funds will be credited to this node when credits arrive</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong><span class=\\\"text-muted\\\">routing_num.</span>ach<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Routing number for ACH transfers</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong><span class=\\\"text-muted\\\">routing_num.</span>wire<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>Routing number for wire transfers</p>\\n</div></div></div><div class=\\\"tr\\\"><div class=\\\"td param\\\"><strong>user_id<span class=\\\"colon\\\">:</span></strong></div><div class=\\\"td\\\"><strong class=\\\"param-type\\\">string</strong><div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"><p>User ID of the user who owns the subnet</p>\\n</div></div></div></div></div></div>\"\n}\n[/block]","excerpt":"","slug":"subnets","type":"basic","title":"Subnet Resources"}
Subnets resources are generic subnet classes that store basic information regarding a node's subnet. Subnets are virtual account and routing numbers issued on top of Synapse managed [Deposit Accounts](doc:deposit-accounts). Developers can use subnets to allow users to be able to fund or debit their deposit account via external ACH or Wire transfers. These account and routing numbers can be plugged into any third party software that is capable of sending ACHs or Wires and when the transfers arrive, a [transaction](doc:trans-resources) will be created automatically and funds will be added to or taken from the associated deposit account. ## Subnet Permissions [block:parameters] { "data": { "h-0": "Permission", "h-1": "Comment", "0-0": "CREDIT", "0-1": "Subnet can receive funds via ACH or Wire transfers", "1-0": "DEBIT", "1-1": "Subnet can be debited funds via ACH or Wire transfers", "2-0": "CREDIT-AND-DEBIT", "2-1": "Subnet can be debited or credited funds via ACH or Wire transfers", "3-0": "LOCKED", "3-1": "Subnet has been locked and any new credits will be returned" }, "cols": 2, "rows": 4 } [/block] Every subnet object has a set of permissions associated with them as follows. ## Subnet Object [block:html] { "html": "<div class=\"api-manager\"><hr class=\"bottom\"><div class=\"param-table\"><div class=\"table\"><div class=\"tr\"><div class=\"td param\"><strong>_id<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Object ID of a transaction</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong><span class=\"text-muted\">_links.self.</span>href<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>HAL style link for the node</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong>account_num<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Account number associated with the subnet</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong><span class=\"text-muted\">client.</span>id<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>ID of the client where the transaction initiated</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong><span class=\"text-muted\">client.</span>name<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Name of the client where the transaction initiated</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong>allowed<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Denotes the subnet standing. Look at <a href=\"#section-subnet-permissions\">subnet permissions</a> section above to learn more</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong>nickname<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Any nickname/common name given to the node. Eg. Payroll AC/RT</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong>node_id<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Node ID associated with the subnet. Funds will be credited to this node when credits arrive</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong><span class=\"text-muted\">routing_num.</span>ach<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Routing number for ACH transfers</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong><span class=\"text-muted\">routing_num.</span>wire<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>Routing number for wire transfers</p>\n</div></div></div><div class=\"tr\"><div class=\"td param\"><strong>user_id<span class=\"colon\">:</span></strong></div><div class=\"td\"><strong class=\"param-type\">string</strong><div marked=\"\" class=\"ng-isolate-scope\"><p>User ID of the user who owns the subnet</p>\n</div></div></div></div></div></div>" } [/block]