{"_id":"5bd69b40e458db001ed129ca","project":"59f79e3c584eb200345ceafc","version":{"_id":"5ba178b00a916500030c6a21","project":"59f79e3c584eb200345ceafc","__v":24,"forked_from":"59f79e3c584eb200345ceaff","createdAt":"2015-09-17T03:47:20.956Z","releaseDate":"2015-09-17T03:47:20.956Z","categories":["5ba178b00a916500030c69a2","5ba178b00a916500030c69a3","5ba178b00a916500030c69a4","5ba178b00a916500030c69a5","5ba178b00a916500030c69a6","5ba178b00a916500030c69a7","5ba178b00a916500030c69a8","5ba178b00a916500030c69a9","5ba178b00a916500030c69aa","5ba178b00a916500030c69ab","5ba178b00a916500030c69ac","5afb6888212c690003ae3d3b","5ba178b00a916500030c69ad","5ba178b00a916500030c69ae","5ba2dcbc99f53f0003b97e2c","5babd73fa0ab3e0003ead030","5bb4038be7222e000334dd97","5bb55954478c1300031a44c2","5bb665a1607307000327c81e","5bb6f90229a7fb0003a0650d","5bb7f9bc29a7fb0003a07ac1","5bba58bd7ba7710003bd901d","5bba6dac7ba7710003bd908d","5bba6e257ba7710003bd9090","5bbac87810189c0003e619ea","5bbb9d02b5862c00036266b2","5bbbadb6219c3e000376c2de","5bc417751d1b0000182bf7f6","5bc59e3b2a5b4f0044db5b97","5bc7bbce2262cc0041f6eff2","5bce6a3580a7250031199f34","5bcfac2c4082510019f2d91b","5bcfac3757bed90030e45d68","5bcfac45d305bc0049941539","5bd2a43548bb6f00289c8fad","5bd3a42a026ebe001f66259e","5bd9d5afffe003005b02f97b","5becb7ee85c6b300557662b6"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.1.0","version":"3.1"},"category":{"_id":"5bcfac3757bed90030e45d68","project":"59f79e3c584eb200345ceafc","version":"5ba178b00a916500030c6a21","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2018-10-23T23:18:15.979Z","from_sync":false,"order":26,"slug":"transaction-resources","title":"Transaction Resources"},"user":"5a68eb6970ea610012bfb924","__v":16,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-10-29T05:31:44.063Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"_id\": \"594e0fa2838454002ea317a0\",\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://uat-api.synapsefi.com/v3.1/users/594e0fa2838454002ea317a0\"\n        }\n    },\n    \"client\": {\n        \"id\": \"589acd9ecb3cd400fa75ac06\",\n        \"name\": \"SynapseFI\"\n    },\n    \"doc_status\": {\n        \"physical_doc\": \"SUBMITTED|VALID\",\n        \"virtual_doc\": \"SUBMITTED|VALID\"\n    },\n    \"documents\": [\n        {\n            \"id\": \"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8\",\n            \"name\": \"Test User\",\n            \"permission_scope\": \"SEND|RECEIVE|1000|DAILY\",\n            \"physical_docs\": [\n                {\n                    \"document_type\": \"GOVT_ID\",\n                    \"id\": \"c486c2cb8c1bce695fcfae3197e14aa5b8ddec184c2779d00d581abee5d9a04c\",\n                    \"last_updated\": 1498288034877,\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ],\n            \"social_docs\": [\n                {\n                    \"document_type\": \"FACEBOOK\",\n                    \"id\": \"8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7\",\n                    \"last_updated\": 1498288034880,\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"PHONE_NUMBER\",\n                    \"id\": \"fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f\",\n                    \"last_updated\": 1498288034880,\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"EMAIL\",\n                    \"id\": \"2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741\",\n                    \"last_updated\": 1498288034880,\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"IP\",\n                    \"id\": \"28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a\",\n                    \"last_updated\": 1498288034880,\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ],\n            \"virtual_docs\": [\n                {\n                    \"document_type\": \"SSN\",\n                    \"id\": \"ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f\",\n                    \"last_updated\": 1498288034875,\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ]\n        }\n    ],\n    \"emails\": [],\n    \"extra\": {\n        \"cip_tag\": 1,\n        \"date_joined\": 1498288029784,\n        \"extra_security\": false,\n        \"is_business\": false,\n        \"last_updated\": 1498288034864,\n        \"public_note\": null,\n        \"supp_id\": \"122eddfgbeafrfvbbb\"\n    },\n    \"is_hidden\": false,\n    \"legal_names\": [\n        \"Test User\"\n    ],\n    \"logins\": [\n        {\n            \"email\": \"test:::at:::synapsefi.com\",\n            \"scope\": \"READ_AND_WRITE\"\n        }\n    ],\n    \"permission\": \"SEND-AND-RECEIVE\",\n    \"phone_numbers\": [\n        \"[email protected]\",\n        \"901.111.1111\"\n    ],\n    \"photos\": [],\n    \"refresh_token\": \"refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq\"\n}","name":"w/o full_dehydrate"},{"code":"{\n    \"_id\": \"594e0fa2838454002ea317a0\",\n    \"_links\": {\n        \"self\": {\n            \"href\": \"https://uat-api.synapsefi.com/v3.1/users/594e0fa2838454002ea317a0\"\n        }\n    },\n    \"_v\": 2,\n    \"client\": {\n        \"id\": \"589acd9ecb3cd400fa75ac06\",\n        \"name\": \"SynapseFI\"\n    },\n    \"doc_status\": {\n        \"physical_doc\": \"SUBMITTED|VALID\",\n        \"virtual_doc\": \"SUBMITTED|VALID\"\n    },\n    \"documents\": [\n        {\n            \"address_city\": \"SF\",\n            \"address_country_code\": \"US\",\n            \"address_postal_code\": \"94114\",\n            \"address_street\": \"1 Market St.\",\n            \"address_subdivision\": \"CA\",\n            \"alias\": \"Test\",\n            \"day\": 2,\n            \"email\": \"[email protected]\",\n            \"entity_scope\": \"Arts & Entertainment\",\n            \"entity_type\": \"M\",\n            \"id\": \"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8\",\n            \"ip\": \"::1\",\n            \"month\": 5,\n            \"name\": \"Test User\",\n            \"permission_scope\": \"SEND|RECEIVE|1000|DAILY\",\n            \"phone_number\": \"901.111.1111\",\n            \"physical_docs\": [\n                {\n                    \"document_type\": \"GOVT_ID\",\n                    \"document_value\": \"https://cdn.synapsepay.com/uploads/2017/06/24/DioeVvEbMOfxzpLGZNCPnJKYuHQ7t89s4FBmTk00rRgyc35WXU.gif\",\n                    \"id\": \"c486c2cb8c1bce695fcfae3197e14aa5b8ddec184c2779d00d581abee5d9a04c\",\n                    \"last_updated\": 1498288034877,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ],\n            \"screening_results\": {\n                \"561\": \"NO_MATCH\",\n                \"aucl\": \"NO_MATCH\",\n                \"concern_location\": \"NO_MATCH\",\n                \"dpl\": \"NO_MATCH\",\n                \"dtc\": \"NO_MATCH\",\n                \"el\": \"NO_MATCH\",\n                \"eucl\": \"NO_MATCH\",\n                \"fatf_non_cooperative_jurisdiction\": \"NO_MATCH\",\n                \"fbi_bank_robbers\": \"NO_MATCH\",\n                \"fbi_counter_intelligence\": \"NO_MATCH\",\n                \"fbi_crimes_against_children\": \"NO_MATCH\",\n                \"fbi_criminal_enterprise_investigations\": \"NO_MATCH\",\n                \"fbi_cyber\": \"NO_MATCH\",\n                \"fbi_domestic_terrorism\": \"NO_MATCH\",\n                \"fbi_human_trafficking\": \"NO_MATCH\",\n                \"fbi_murders\": \"NO_MATCH\",\n                \"fbi_violent_crimes\": \"NO_MATCH\",\n                \"fbi_wanted_terrorists\": \"NO_MATCH\",\n                \"fbi_white_collar\": \"NO_MATCH\",\n                \"fincen_red_list\": \"NO_MATCH\",\n                \"fse\": \"NO_MATCH\",\n                \"fto_sanctions\": \"NO_MATCH\",\n                \"futures_sanctions\": \"NO_MATCH\",\n                \"hkma_sanctions\": \"NO_MATCH\",\n                \"hm_treasury_sanctions\": \"NO_MATCH\",\n                \"isn\": \"NO_MATCH\",\n                \"mas_sanctions\": \"NO_MATCH\",\n                \"monitored_location\": \"NO_MATCH\",\n                \"ns-isa\": \"NO_MATCH\",\n                \"ofac_561_list\": \"NO_MATCH\",\n                \"ofac_eo13645\": \"NO_MATCH\",\n                \"ofac_fse\": \"NO_MATCH\",\n                \"ofac_fse_ir\": \"NO_MATCH\",\n                \"ofac_fse_sy\": \"NO_MATCH\",\n                \"ofac_isa\": \"NO_MATCH\",\n                \"ofac_ns_isa\": \"NO_MATCH\",\n                \"ofac_plc\": \"NO_MATCH\",\n                \"ofac_sdn\": \"NO_MATCH\",\n                \"ofac_ssi\": \"NO_MATCH\",\n                \"ofac_syria\": \"NO_MATCH\",\n                \"ofac_ukraine_eo13662\": \"NO_MATCH\",\n                \"osfi\": \"NO_MATCH\",\n                \"pep\": \"NO_MATCH\",\n                \"plc\": \"NO_MATCH\",\n                \"primary_concern\": \"NO_MATCH\",\n                \"sdn\": \"NO_MATCH\",\n                \"ssi\": \"NO_MATCH\",\n                \"tel_sanctions\": \"NO_MATCH\",\n                \"ukcl\": \"NO_MATCH\",\n                \"uvl\": \"NO_MATCH\"\n            },\n            \"social_docs\": [\n                {\n                    \"document_type\": \"FACEBOOK\",\n                    \"document_value\": \"https://www.facebook.com/valid\",\n                    \"id\": \"8f314a6a53f36ee569455761e49a2a7fe790d251c5611c65255befdb303602b7\",\n                    \"last_updated\": 1498288034880,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"PHONE_NUMBER\",\n                    \"document_value\": \"901.111.1111\",\n                    \"id\": \"fda60784d6375bc44edafaaeae149626c4c13dcb92e85a2a7a00eec2cdfd2b6f\",\n                    \"last_updated\": 1498288034880,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"EMAIL\",\n                    \"document_value\": \"[email protected]\",\n                    \"id\": \"2c45158f6431ca874bbe82f63d5905567854dde4d8b81539944e5779e5eee741\",\n                    \"last_updated\": 1498288034880,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                },\n                {\n                    \"document_type\": \"IP\",\n                    \"document_value\": \"::1\",\n                    \"id\": \"28d9177b22c127d9a51d8903893864accf6e553ac326704a4c0d585eaad2516a\",\n                    \"last_updated\": 1498288034880,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ],\n            \"virtual_docs\": [\n                {\n                    \"document_type\": \"SSN\",\n                    \"document_value\": \"2222\",\n                    \"id\": \"ee596c2896dddc19b76c07a184fe7d3cf5a04b8e94b9108190cac7890739017f\",\n                    \"last_updated\": 1498288034875,\n                    \"meta\": {\n                        \"matches\": {\n                            \"address\": \"not_found\",\n                            \"dob\": \"not_found\",\n                            \"identification\": \"not_found\"\n                        }\n                    },\n                    \"status\": \"SUBMITTED|VALID\"\n                }\n            ],\n            \"year\": 1989\n        }\n    ],\n    \"emails\": [],\n    \"extra\": {\n        \"cip_tag\": 1,\n        \"date_joined\": 1498288029784,\n        \"extra_security\": false,\n        \"is_business\": false,\n        \"last_updated\": 1498288034864,\n        \"note\": null,\n        \"public_note\": null,\n        \"supp_id\": \"122eddfgbeafrfvbbb\"\n    },\n    \"flag\": \"NOT-FLAGGED\",\n    \"ips\": [\n        \"127.0.0.1\"\n    ],\n    \"is_hidden\": false,\n    \"legal_names\": [\n        \"Test User\"\n    ],\n    \"logins\": [\n        {\n            \"email\": \"[email protected]\",\n            \"scope\": \"READ_AND_WRITE\"\n        }\n    ],\n    \"permission\": \"SEND-AND-RECEIVE\",\n    \"phone_numbers\": [\n        \"[email protected]\",\n        \"901.111.1111\"\n    ],\n    \"photos\": [],\n    \"refresh_token\": \"refresh_ehG7YBS8ZiD0sLa6PQHMUxryovVkJzElC5gWROXq\"\n}","language":"json","name":"with full_dehydrate","status":200}]},"method":"get","examples":{"codes":[{"language":"http","code":"GET /v3.1/users/594e0fa2838454002ea317a0 HTTP/1.1\nHost: uat-api.synapsefi.com\nX-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267\nX-SP-USER-IP: 127.0.0.1\nX-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json","name":"w/o full_dehydrate"},{"name":"with full_dehydrate","language":"http","code":"GET /v3.1/users/594e0fa2838454002ea317a0?full_dehydrate=yes HTTP/1.1\nHost: uat-api.synapsefi.com\nX-SP-GATEWAY: client_id_2bb1e412edd311e6bd04e285d6015267|client_secret_2bb1e714edd311e6bd04e285d6015267\nX-SP-USER-IP: 127.0.0.1\nX-SP-USER: |e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json"}]},"auth":"required","params":[{"_id":"58acf7f3e570c62500512a63","ref":"","in":"query","required":false,"desc":"[yes/no] Full Dehydrate yes will return back user's KYC info.","default":"no","type":"string","name":"full_dehydrate"},{"_id":"590ca984ae0df70f0044026c","ref":"","in":"path","required":true,"desc":"The user ID of the user you wish to retrieve","default":"","type":"string","name":"user_id"}],"url":"/v3.1/users/:user_id"},"isReference":false,"order":6,"body":"By default, all Synapse fees are deducted from the fund recipient. This means that if you send $1, the fund recipient will get $1 minus the per transaction fee.\n\nHowever, if you want your customer to receive 100% of the funds, you can cover the cost yourself. You can also charge an additional fee to users that will be deducted from the transaction amount.\n\n##1. Pre-Fund a DEPOSIT-US Node\n\nThis is the node where the transaction fees will be deducted from. You will need to keep enough funds in the deposit account to cover all fees. We recommend setting up webhooks to keep track of the balance for this node. More information on setting that up can be found here [Subscription Resources](doc:subscriptions)\n\n##2. Create the transaction\nSet the facilitator fee to -0.2 (or whatever your per transaction fee is). Set your pre-funded DEPOSIT-US node as your fee's \"to\" node. \n\n**Charging an additional fee**: To charge an additional fee you will create a second fee object with the fee you're charging designated as a positive integer value with the \"to\" node set to where those funds would be deposited.\n\n**Example Request**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba018389f2400b9b119fe/trans HTTP/1.1\\nHost: https://uat-api.synapsefi.com\\nX-SP-USER-IP: 255.127.79.76\\nX-SP-USER: oauth_CyQGXNFT8IKWi7na3PZVAEJYv0hdg52M0qrwBLsR|e83cf6ddcf778e37bfe3d48fc78a6502062fc\\nContent-Type: application/json\\ncache-control: no-cache\\nPostman-Token: dac83765-a169-4c53-bdd0-c654ec44eb75\\n{\\n  \\\"to\\\": {\\n    \\\"type\\\": \\\"DEPOSIT-US\\\",\\n    \\\"id\\\": \\\"5bdba176389f2400abb00a63\\\"\\n  },\\n  \\\"amount\\\": {\\n    \\\"amount\\\": 300,\\n    \\\"currency\\\": \\\"USD\\\"\\n  },\\n  \\\"extra\\\": {\\n    \\\"ip\\\": \\\"255.127.79.76\\\",\\n    \\\"note\\\": \\\"Test transaction\\\"\\n  },\\n  \\\"fees\\\":[{\\n  \\t\\\"fee\\\":-0.2,\\n  \\t\\\"note\\\":\\\"Facilitator Fee\\\",\\n  \\t\\\"to\\\":{\\n  \\t\\t\\\"id\\\":\\\"5bdba176389f2400abb00a63\\\"\\n  \\t}\\n  }]\\n}\",\n      \"language\": \"http\",\n      \"name\": \"Covering Fee\"\n    },\n    {\n      \"code\": \"POST /v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba018389f2400b9b119fe/trans HTTP/1.1\\nHost: https://uat-api.synapsefi.com\\nX-SP-USER-IP: 255.127.79.76\\nX-SP-USER: oauth_CyQGXNFT8IKWi7na3PZVAEJYv0hdg52M0qrwBLsR|e83cf6ddcf778e37bfe3d48fc78a6502062fc\\nContent-Type: application/json\\ncache-control: no-cache\\nPostman-Token: dac83765-a169-4c53-bdd0-c654ec44eb75\\n{\\n  \\\"to\\\": {\\n    \\\"type\\\": \\\"DEPOSIT-US\\\",\\n    \\\"id\\\": \\\"5bdba176389f2400abb00a63\\\"\\n  },\\n  \\\"amount\\\": {\\n    \\\"amount\\\": 300,\\n    \\\"currency\\\": \\\"USD\\\"\\n  },\\n  \\\"extra\\\": {\\n    \\\"ip\\\": \\\"255.127.79.76\\\",\\n    \\\"note\\\": \\\"Test transaction\\\"\\n  },\\n  \\\"fees\\\":[\\n  {\\n    \\\"fee\\\":-0.2,\\n    \\\"note\\\":\\\"Facilitator Fee\\\",\\n    \\\"to\\\":{\\n      \\\"id\\\":\\\"5bdba176389f2400abb00a63\\\"\\n      }\\n      },\\n  {\\n  \\\"fee\\\":2.12,\\n  \\\"note\\\":\\\"Additional Platform Fee\\\",\\n  \\\"to\\\":{\\n      \\\"id\\\":\\\"5ddca154189f2400abb83a89\\\"\\n    }\\n  }]\\n}\",\n      \"language\": \"http\",\n      \"name\": \"Additional Fee\"\n    }\n  ]\n}\n[/block]\n**RESPONSE**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"error_code\\\": \\\"0\\\",\\n    \\\"http_code\\\": \\\"200\\\",\\n    \\\"limit\\\": 20,\\n    \\\"node_count\\\": 1,\\n    \\\"nodes\\\": [\\n        {\\n            \\\"_id\\\": \\\"5bdba176389f2400abb00a63\\\",\\n            \\\"_links\\\": {\\n                \\\"self\\\": {\\n                    \\\"href\\\": \\\"https://uat-api.synapsefi.com/v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba176389f2400abb00a63\\\"\\n                }\\n            },\\n            \\\"allowed\\\": \\\"CREDIT-AND-DEBIT\\\",\\n            \\\"client\\\": {\\n                \\\"id\\\": \\\"589acd9ecb3cd400fa75ac06\\\",\\n                \\\"name\\\": \\\"SynapseFI\\\"\\n            },\\n            \\\"extra\\\": {\\n                \\\"note\\\": null,\\n                \\\"other\\\": {},\\n                \\\"supp_id\\\": \\\"\\\"\\n            },\\n            \\\"info\\\": {\\n                \\\"balance\\\": {\\n                    \\\"amount\\\": 0,\\n                    \\\"currency\\\": \\\"USD\\\"\\n                },\\n                \\\"document_id\\\": \\\"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8\\\",\\n                \\\"name_on_account\\\": \\\" \\\",\\n                \\\"nickname\\\": \\\"My Deposit Account\\\"\\n            },\\n            \\\"is_active\\\": true,\\n            \\\"timeline\\\": [\\n                {\\n                    \\\"date\\\": 1541120374412,\\n                    \\\"note\\\": \\\"Node created.\\\"\\n                }\\n            ],\\n            \\\"type\\\": \\\"DEPOSIT-US\\\",\\n            \\\"user_id\\\": \\\"5bd7544f3ee0a932f2caa931\\\"\\n        }\\n    ],\\n    \\\"page_count\\\": 1,\\n    \\\"success\\\": true\\n}\",\n      \"language\": \"json\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\n##3. View all Fees\n\nYou will see two fees when you GET the transaction (after the transaction has settled). One positive & one negative. These correspond with our DEPOSIT-US node & your DEPOSIT-US node respectively. In the case of an additional fee you'll see three different fees.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \" \\\"fees\\\": [\\n        {\\n            \\\"fee\\\": 0.2,\\n            \\\"note\\\": \\\"Synapse Facilitator Fee\\\", #Node that the fee is credited to\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"55b3f8c686c2732b4c4e9df6\\\"\\n            }\\n        },\\n        {\\n            \\\"fee\\\": -0.2,\\n            \\\"note\\\": \\\"Facilitator Fee\\\", #Node that the fee is debited from\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"5bdba176389f2400abb00a63\\\"\\n            }\\n        }\",\n      \"language\": \"json\",\n      \"name\": \"Covering Fee\"\n    },\n    {\n      \"code\": \" \\\"fees\\\": [\\n        {\\n            \\\"fee\\\": 0.2,\\n            \\\"note\\\": \\\"Synapse Facilitator Fee\\\", #Node that the fee is credited to\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"55b3f8c686c2732b4c4e9df6\\\"\\n            }\\n        },\\n        {\\n            \\\"fee\\\": -0.2,\\n            \\\"note\\\": \\\"Facilitator Fee\\\", #Node that the fee is debited from\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"5bdba176389f2400abb00a63\\\"\\n            },\\n           {\\n            \\\"fee\\\": 2.12,\\n            \\\"note\\\": \\\"Additional Platform Fee\\\", #Node that the fee is credited from\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"5ddca154189f2400abb83a89\\\"\\n            }\\n        }\",\n      \"language\": \"json\",\n      \"name\": \"Additional Fee\"\n    }\n  ]\n}\n[/block]\nThat's it! The recipient should get 100% of the funds","excerpt":"Handling facilitator fee's","slug":"facilitator-fees-for-transactions","type":"basic","title":"Facilitator Fee's for Transactions"}

Facilitator Fee's for Transactions

Handling facilitator fee's

By default, all Synapse fees are deducted from the fund recipient. This means that if you send $1, the fund recipient will get $1 minus the per transaction fee. However, if you want your customer to receive 100% of the funds, you can cover the cost yourself. You can also charge an additional fee to users that will be deducted from the transaction amount. ##1. Pre-Fund a DEPOSIT-US Node This is the node where the transaction fees will be deducted from. You will need to keep enough funds in the deposit account to cover all fees. We recommend setting up webhooks to keep track of the balance for this node. More information on setting that up can be found here [Subscription Resources](doc:subscriptions) ##2. Create the transaction Set the facilitator fee to -0.2 (or whatever your per transaction fee is). Set your pre-funded DEPOSIT-US node as your fee's "to" node. **Charging an additional fee**: To charge an additional fee you will create a second fee object with the fee you're charging designated as a positive integer value with the "to" node set to where those funds would be deposited. **Example Request** [block:code] { "codes": [ { "code": "POST /v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba018389f2400b9b119fe/trans HTTP/1.1\nHost: https://uat-api.synapsefi.com\nX-SP-USER-IP: 255.127.79.76\nX-SP-USER: oauth_CyQGXNFT8IKWi7na3PZVAEJYv0hdg52M0qrwBLsR|e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json\ncache-control: no-cache\nPostman-Token: dac83765-a169-4c53-bdd0-c654ec44eb75\n{\n \"to\": {\n \"type\": \"DEPOSIT-US\",\n \"id\": \"5bdba176389f2400abb00a63\"\n },\n \"amount\": {\n \"amount\": 300,\n \"currency\": \"USD\"\n },\n \"extra\": {\n \"ip\": \"255.127.79.76\",\n \"note\": \"Test transaction\"\n },\n \"fees\":[{\n \t\"fee\":-0.2,\n \t\"note\":\"Facilitator Fee\",\n \t\"to\":{\n \t\t\"id\":\"5bdba176389f2400abb00a63\"\n \t}\n }]\n}", "language": "http", "name": "Covering Fee" }, { "code": "POST /v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba018389f2400b9b119fe/trans HTTP/1.1\nHost: https://uat-api.synapsefi.com\nX-SP-USER-IP: 255.127.79.76\nX-SP-USER: oauth_CyQGXNFT8IKWi7na3PZVAEJYv0hdg52M0qrwBLsR|e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json\ncache-control: no-cache\nPostman-Token: dac83765-a169-4c53-bdd0-c654ec44eb75\n{\n \"to\": {\n \"type\": \"DEPOSIT-US\",\n \"id\": \"5bdba176389f2400abb00a63\"\n },\n \"amount\": {\n \"amount\": 300,\n \"currency\": \"USD\"\n },\n \"extra\": {\n \"ip\": \"255.127.79.76\",\n \"note\": \"Test transaction\"\n },\n \"fees\":[\n {\n \"fee\":-0.2,\n \"note\":\"Facilitator Fee\",\n \"to\":{\n \"id\":\"5bdba176389f2400abb00a63\"\n }\n },\n {\n \"fee\":2.12,\n \"note\":\"Additional Platform Fee\",\n \"to\":{\n \"id\":\"5ddca154189f2400abb83a89\"\n }\n }]\n}", "language": "http", "name": "Additional Fee" } ] } [/block] **RESPONSE** [block:code] { "codes": [ { "code": "{\n \"error_code\": \"0\",\n \"http_code\": \"200\",\n \"limit\": 20,\n \"node_count\": 1,\n \"nodes\": [\n {\n \"_id\": \"5bdba176389f2400abb00a63\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://uat-api.synapsefi.com/v3.1/users/5bd7544f3ee0a932f2caa931/nodes/5bdba176389f2400abb00a63\"\n }\n },\n \"allowed\": \"CREDIT-AND-DEBIT\",\n \"client\": {\n \"id\": \"589acd9ecb3cd400fa75ac06\",\n \"name\": \"SynapseFI\"\n },\n \"extra\": {\n \"note\": null,\n \"other\": {},\n \"supp_id\": \"\"\n },\n \"info\": {\n \"balance\": {\n \"amount\": 0,\n \"currency\": \"USD\"\n },\n \"document_id\": \"2a4a5957a3a62aaac1a0dd0edcae96ea2cdee688ec6337b20745eed8869e3ac8\",\n \"name_on_account\": \" \",\n \"nickname\": \"My Deposit Account\"\n },\n \"is_active\": true,\n \"timeline\": [\n {\n \"date\": 1541120374412,\n \"note\": \"Node created.\"\n }\n ],\n \"type\": \"DEPOSIT-US\",\n \"user_id\": \"5bd7544f3ee0a932f2caa931\"\n }\n ],\n \"page_count\": 1,\n \"success\": true\n}", "language": "json", "name": null } ] } [/block] ##3. View all Fees You will see two fees when you GET the transaction (after the transaction has settled). One positive & one negative. These correspond with our DEPOSIT-US node & your DEPOSIT-US node respectively. In the case of an additional fee you'll see three different fees. [block:code] { "codes": [ { "code": " \"fees\": [\n {\n \"fee\": 0.2,\n \"note\": \"Synapse Facilitator Fee\", #Node that the fee is credited to\n \"to\": {\n \"id\": \"55b3f8c686c2732b4c4e9df6\"\n }\n },\n {\n \"fee\": -0.2,\n \"note\": \"Facilitator Fee\", #Node that the fee is debited from\n \"to\": {\n \"id\": \"5bdba176389f2400abb00a63\"\n }\n }", "language": "json", "name": "Covering Fee" }, { "code": " \"fees\": [\n {\n \"fee\": 0.2,\n \"note\": \"Synapse Facilitator Fee\", #Node that the fee is credited to\n \"to\": {\n \"id\": \"55b3f8c686c2732b4c4e9df6\"\n }\n },\n {\n \"fee\": -0.2,\n \"note\": \"Facilitator Fee\", #Node that the fee is debited from\n \"to\": {\n \"id\": \"5bdba176389f2400abb00a63\"\n },\n {\n \"fee\": 2.12,\n \"note\": \"Additional Platform Fee\", #Node that the fee is credited from\n \"to\": {\n \"id\": \"5ddca154189f2400abb83a89\"\n }\n }", "language": "json", "name": "Additional Fee" } ] } [/block] That's it! The recipient should get 100% of the funds