{"_id":"5ba178b00a916500030c69f7","project":"59f79e3c584eb200345ceafc","parentDoc":null,"category":{"_id":"5ba178b00a916500030c69a8","project":"59f79e3c584eb200345ceafc","version":"5ba178b00a916500030c6a21","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-05-12T16:39:43.277Z","from_sync":false,"order":1,"slug":"guides","title":"Resources"},"user":"54e4044e8ef7552300409dcb","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":true,"is_stable":false,"codename":"","version_clean":"3.2.0","version":"3.2"},"__v":0,"githubsync":"","updates":["56071c89a4574a0d0081142c"],"next":{"pages":[],"description":""},"createdAt":"2015-08-13T01:23:03.288Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Transactions can be queued, canceled or returned. Below is a comprehensive list of all possible reasons why that might happen.  \n\n## Queue Codes\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"Q01\",\n    \"0-1\": \"Test transactions not allowed on production\",\n    \"1-0\": \"Q02\",\n    \"5-0\": \"Q03\",\n    \"9-0\": \"Q04\",\n    \"9-1\": \"More information needed on sender: supply utility bill\",\n    \"5-1\": \"More information needed on receiver: supply any Government-Issued Photo ID\",\n    \"1-1\": \"More information needed on sender: supply any Government-Issued Photo ID\",\n    \"10-0\": \"Q05\",\n    \"11-0\": \"Q06\",\n    \"12-0\": \"Q07\",\n    \"13-0\": \"Q08\",\n    \"14-0\": \"Q09\",\n    \"15-0\": \"Q10\",\n    \"27-0\": \"Q46\",\n    \"28-0\": \"Q47\",\n    \"29-0\": \"Q48\",\n    \"30-0\": \"Q49\",\n    \"31-0\": \"Q50\",\n    \"10-1\": \"More information needed on receiver: supply utility bill\",\n    \"11-1\": \"KYC (i.e. Know Your Customer) steps unfinished on sender\",\n    \"12-1\": \"KYC unfinished on receiver\",\n    \"13-1\": \"Sending node locked\",\n    \"14-1\": \"Receiving node locked\",\n    \"15-1\": \"High risk transaction (e.g. the account does not contain enough funds to process the full transaction amount)\",\n    \"27-1\": \"Sender not authorized to make transactions\",\n    \"28-1\": \"Receiver not authorized to make transactions\",\n    \"29-1\": \"Sender on screenings list\",\n    \"30-1\": \"Receiver on screenings list\",\n    \"31-1\": \"Unable to process the transaction (reason undisclosed)\",\n    \"2-0\": \"Q02-A\",\n    \"2-1\": \"More information needed on sender: supply Passport\",\n    \"3-0\": \"Q02-B\",\n    \"3-1\": \"More information needed on sender: supply Drivers License\",\n    \"6-0\": \"Q03-A\",\n    \"6-1\": \"More information needed on receiver: supply Passport\",\n    \"7-0\": \"Q03-B\",\n    \"7-1\": \"More information needed on receiver: supply Drivers License\",\n    \"4-0\": \"Q02-C\",\n    \"4-1\": \"More information needed on sender: Finish KBA (Knowledge Based Authentication)\",\n    \"8-0\": \"Q03-C\",\n    \"8-1\": \"More information needed on receiver: Finish KBA\",\n    \"16-0\": \"Q10-A\",\n    \"17-0\": \"Q10-B\",\n    \"18-0\": \"Q10-C\",\n    \"19-0\": \"Q10-D\",\n    \"20-0\": \"Q10-E\",\n    \"21-0\": \"Q10-F\",\n    \"22-0\": \"Q10-G\",\n    \"23-0\": \"Q10-H\",\n    \"24-0\": \"Q10-I\",\n    \"25-0\": \"Q10-J\",\n    \"24-1\": \"Possible duplicate transaction. If we are mistaken, please let us know.\",\n    \"16-1\": \"Please collect ACH auth on Sender\",\n    \"17-1\": \"Please collect ACH auth on Receiver\",\n    \"18-1\": \"High risk for NSF\",\n    \"19-1\": \"Information mismatch\",\n    \"20-1\": \"Transaction outside the scope of gateway flow of funds\",\n    \"21-1\": \"Gateway not allowed to transact in Sender's state\",\n    \"22-1\": \"Gateway not allowed to transact in Receiver's state\",\n    \"23-1\": \"Transaction queued due to compliance reasons. Please contact us to learn more.\",\n    \"25-1\": \"Transaction queued until other Sender's transactions settle.\",\n    \"26-0\": \"Q10-K\",\n    \"26-1\": \"Further investigation needed from Synapse\"\n  },\n  \"cols\": 2,\n  \"rows\": 32\n}\n[/block]\n## Cancelation Codes\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"C01\",\n    \"1-0\": \"C02\",\n    \"2-0\": \"C03\",\n    \"3-0\": \"C06\",\n    \"4-0\": \"C07\",\n    \"5-0\": \"C08\",\n    \"6-0\": \"C09\",\n    \"7-0\": \"C10\",\n    \"18-0\": \"C46\",\n    \"19-0\": \"C47\",\n    \"20-0\": \"C48\",\n    \"21-0\": \"C49\",\n    \"22-0\": \"C50\",\n    \"0-1\": \"Test transactions not allowed on production\",\n    \"1-1\": \"Unable to verify Sender identity\",\n    \"2-1\": \"Unable to verify Receiver identity\",\n    \"3-1\": \"KYC unfinished on Sender\",\n    \"4-1\": \"KYC unfinished on Receiver\",\n    \"5-1\": \"Sending node locked\",\n    \"6-1\": \"Receiving node locked\",\n    \"7-1\": \"High risk transaction\",\n    \"18-1\": \"Sender not authorized to make transactions\",\n    \"19-1\": \"Receiver not authorized to make transactions\",\n    \"20-1\": \"Sender on screenings list\",\n    \"21-1\": \"Receiver on screenings list\",\n    \"22-1\": \"Unable to process the transaction (reason undisclosed)\",\n    \"8-0\": \"C10-A\",\n    \"9-0\": \"C10-B\",\n    \"10-0\": \"C10-C\",\n    \"11-0\": \"C10-D\",\n    \"12-0\": \"C10-E\",\n    \"13-0\": \"C10-F\",\n    \"14-0\": \"C10-G\",\n    \"15-0\": \"C10-H\",\n    \"16-0\": \"C10-I\",\n    \"8-1\": \"Please collect ACH auth on Sender & then resubmit payment\",\n    \"9-1\": \"Please collect ACH auth on Receiver & then resubmit payment\",\n    \"10-1\": \"High risk for NSF\",\n    \"11-1\": \"Information mismatch\",\n    \"12-1\": \"Transaction outside the scope of gateway flow of funds\",\n    \"13-1\": \"Gateway not allowed to transact in Sender's state\",\n    \"14-1\": \"Gateway not allowed to transact in Receiver's state\",\n    \"15-1\": \"Transaction canceled due to compliance reasons. Please contact us to learn more.\",\n    \"16-1\": \"Possible duplicate transaction. If we are mistaken, please let us know.\",\n    \"17-0\": \"C11\",\n    \"17-1\": \"Unable to settle transaction because from_node has 0 monthly withdrawals remaining. (For Interest Bearing Accounts).\"\n  },\n  \"cols\": 2,\n  \"rows\": 23\n}\n[/block]\n**Sandbox Test Values**\nWhile testing, [RequestBin](http://requestb.in/) is an excellent tool to help you test out web-hooks for these scenarios.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Amount\",\n    \"h-1\": \"Cancelation\",\n    \"0-1\": \"C10-A -- Please collect ACH auth on Sender & then resubmit payment.\",\n    \"0-0\": \"111.11\",\n    \"1-0\": \"111.12\",\n    \"2-0\": \"111.13\",\n    \"3-0\": \"111.14\",\n    \"4-0\": \"111.15\",\n    \"5-0\": \"111.16\",\n    \"1-1\": \"C46 -- Sender not authorized to make transactions.\",\n    \"2-1\": \"C47 -- Receiver not authorized to make transactions.\",\n    \"3-1\": \"C48 -- Sender on screenings list.\",\n    \"4-1\": \"C49 -- Receiver on screenings list.\",\n    \"5-1\": \"C50 -- Unable to process the transaction (reason undisclosed).\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"We recommend setting up [Subscriptions](doc:subscriptions) to receive these updates as they occur. \\nAlternatively, you can also use [GET transaction](doc:transaction) to check status periodically (Not Recommended).\",\n  \"title\": \"Staying Up-To-Date with Transaction Status\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"Please pay attention to `timeline` & `recent_status` keys in the transaction response. The `note` field contains transaction codes.\",\n  \"title\": \"Locating Transaction Codes\"\n}\n[/block]\n## Example Queued Transaction\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"amount\\\": {\\n    \\\"amount\\\": 1000.1,\\n    \\\"currency\\\": \\\"USD\\\"\\n  },\\n  \\\"timeline\\\": [\\n    {\\n      \\\"note\\\": \\\"Transaction Created.\\\",\\n      \\\"date\\\": 1490830657477,\\n      \\\"status_id\\\": \\\"1\\\",\\n      \\\"status\\\": \\\"CREATED\\\"\\n    },\\n    {\\n      \\\"note\\\": \\\"Q10-K Further investigation needed from Synapse.\\\",\\n      \\\"status_id\\\": \\\"-1\\\",\\n      \\\"date\\\": 1490830664676,\\n      \\\"status\\\": \\\"QUEUED-BY-SYNAPSE\\\"\\n    }\\n  ],\\n  \\\"fees\\\": [\\n    {\\n      \\\"note\\\": \\\"Synapse Facilitator Fee\\\",\\n      \\\"to\\\": {\\n        \\\"id\\\": \\\"55b3f8c686c2732b4c4e9df6\\\"\\n      },\\n      \\\"fee\\\": 0.2\\n    }\\n  ],\\n  \\\"client\\\": {\\n    \\\"name\\\": \\\"Test Sandbox KYC 2.0\\\",\\n    \\\"id\\\": \\\"589a9ff886c2736412ce7e9e\\\"\\n  },\\n  \\\"_id\\\": \\\"58dc45412ee69200208275d5\\\",\\n  \\\"extra\\\": {\\n    \\\"note\\\": \\\"Test transaction\\\",\\n    \\\"ip\\\": \\\"192.168.0.1\\\",\\n    \\\"created_on\\\": 1490830657477,\\n    \\\"process_on\\\": 1490830657477,\\n    \\\"supp_id\\\": \\\"1122444\\\",\\n    \\\"latlon\\\": \\\"0,0\\\"\\n  },\\n  \\\"to\\\": {\\n    \\\"user\\\": {\\n      \\\"legal_names\\\": [\\n        \\\"Test User\\\"\\n      ],\\n      \\\"_id\\\": \\\"589d56e17562960020caf936\\\"\\n    },\\n    \\\"nickname\\\": \\\"Fake Account\\\",\\n    \\\"type\\\": \\\"ACH-US\\\",\\n    \\\"id\\\": \\\"589dc0bdab6ce7001f7f89e8\\\"\\n  },\\n  \\\"recent_status\\\": {\\n    \\\"note\\\": \\\"Q10-K Further investigation needed from Synapse.\\\",\\n    \\\"status_id\\\": \\\"-1\\\",\\n    \\\"date\\\": 1490830664676,\\n    \\\"status\\\": \\\"QUEUED-BY-SYNAPSE\\\"\\n  },\\n  \\\"from\\\": {\\n    \\\"user\\\": {\\n      \\\"legal_names\\\": [\\n        \\\"Michael Scott\\\"\\n      ],\\n      \\\"_id\\\": \\\"58dc438499c8e5001fd63895\\\"\\n    },\\n    \\\"nickname\\\": \\\"Synapse Test Savings Account - 8902\\\",\\n    \\\"type\\\": \\\"ACH-US\\\",\\n    \\\"id\\\": \\\"58dc448cc54d7b0020113617\\\"\\n  },\\n  \\\"_v\\\": 2\\n}\",\n      \"language\": \"json\",\n      \"name\": \"Queued Transaction\"\n    }\n  ]\n}\n[/block]","excerpt":"Transaction Codes for queues, cancellations or returns.","slug":"transaction-codes","type":"basic","title":"Transaction Codes"}

Transaction Codes

Transaction Codes for queues, cancellations or returns.

Transactions can be queued, canceled or returned. Below is a comprehensive list of all possible reasons why that might happen. ## Queue Codes [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "Q01", "0-1": "Test transactions not allowed on production", "1-0": "Q02", "5-0": "Q03", "9-0": "Q04", "9-1": "More information needed on sender: supply utility bill", "5-1": "More information needed on receiver: supply any Government-Issued Photo ID", "1-1": "More information needed on sender: supply any Government-Issued Photo ID", "10-0": "Q05", "11-0": "Q06", "12-0": "Q07", "13-0": "Q08", "14-0": "Q09", "15-0": "Q10", "27-0": "Q46", "28-0": "Q47", "29-0": "Q48", "30-0": "Q49", "31-0": "Q50", "10-1": "More information needed on receiver: supply utility bill", "11-1": "KYC (i.e. Know Your Customer) steps unfinished on sender", "12-1": "KYC unfinished on receiver", "13-1": "Sending node locked", "14-1": "Receiving node locked", "15-1": "High risk transaction (e.g. the account does not contain enough funds to process the full transaction amount)", "27-1": "Sender not authorized to make transactions", "28-1": "Receiver not authorized to make transactions", "29-1": "Sender on screenings list", "30-1": "Receiver on screenings list", "31-1": "Unable to process the transaction (reason undisclosed)", "2-0": "Q02-A", "2-1": "More information needed on sender: supply Passport", "3-0": "Q02-B", "3-1": "More information needed on sender: supply Drivers License", "6-0": "Q03-A", "6-1": "More information needed on receiver: supply Passport", "7-0": "Q03-B", "7-1": "More information needed on receiver: supply Drivers License", "4-0": "Q02-C", "4-1": "More information needed on sender: Finish KBA (Knowledge Based Authentication)", "8-0": "Q03-C", "8-1": "More information needed on receiver: Finish KBA", "16-0": "Q10-A", "17-0": "Q10-B", "18-0": "Q10-C", "19-0": "Q10-D", "20-0": "Q10-E", "21-0": "Q10-F", "22-0": "Q10-G", "23-0": "Q10-H", "24-0": "Q10-I", "25-0": "Q10-J", "24-1": "Possible duplicate transaction. If we are mistaken, please let us know.", "16-1": "Please collect ACH auth on Sender", "17-1": "Please collect ACH auth on Receiver", "18-1": "High risk for NSF", "19-1": "Information mismatch", "20-1": "Transaction outside the scope of gateway flow of funds", "21-1": "Gateway not allowed to transact in Sender's state", "22-1": "Gateway not allowed to transact in Receiver's state", "23-1": "Transaction queued due to compliance reasons. Please contact us to learn more.", "25-1": "Transaction queued until other Sender's transactions settle.", "26-0": "Q10-K", "26-1": "Further investigation needed from Synapse" }, "cols": 2, "rows": 32 } [/block] ## Cancelation Codes [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "C01", "1-0": "C02", "2-0": "C03", "3-0": "C06", "4-0": "C07", "5-0": "C08", "6-0": "C09", "7-0": "C10", "18-0": "C46", "19-0": "C47", "20-0": "C48", "21-0": "C49", "22-0": "C50", "0-1": "Test transactions not allowed on production", "1-1": "Unable to verify Sender identity", "2-1": "Unable to verify Receiver identity", "3-1": "KYC unfinished on Sender", "4-1": "KYC unfinished on Receiver", "5-1": "Sending node locked", "6-1": "Receiving node locked", "7-1": "High risk transaction", "18-1": "Sender not authorized to make transactions", "19-1": "Receiver not authorized to make transactions", "20-1": "Sender on screenings list", "21-1": "Receiver on screenings list", "22-1": "Unable to process the transaction (reason undisclosed)", "8-0": "C10-A", "9-0": "C10-B", "10-0": "C10-C", "11-0": "C10-D", "12-0": "C10-E", "13-0": "C10-F", "14-0": "C10-G", "15-0": "C10-H", "16-0": "C10-I", "8-1": "Please collect ACH auth on Sender & then resubmit payment", "9-1": "Please collect ACH auth on Receiver & then resubmit payment", "10-1": "High risk for NSF", "11-1": "Information mismatch", "12-1": "Transaction outside the scope of gateway flow of funds", "13-1": "Gateway not allowed to transact in Sender's state", "14-1": "Gateway not allowed to transact in Receiver's state", "15-1": "Transaction canceled due to compliance reasons. Please contact us to learn more.", "16-1": "Possible duplicate transaction. If we are mistaken, please let us know.", "17-0": "C11", "17-1": "Unable to settle transaction because from_node has 0 monthly withdrawals remaining. (For Interest Bearing Accounts)." }, "cols": 2, "rows": 23 } [/block] **Sandbox Test Values** While testing, [RequestBin](http://requestb.in/) is an excellent tool to help you test out web-hooks for these scenarios. [block:parameters] { "data": { "h-0": "Amount", "h-1": "Cancelation", "0-1": "C10-A -- Please collect ACH auth on Sender & then resubmit payment.", "0-0": "111.11", "1-0": "111.12", "2-0": "111.13", "3-0": "111.14", "4-0": "111.15", "5-0": "111.16", "1-1": "C46 -- Sender not authorized to make transactions.", "2-1": "C47 -- Receiver not authorized to make transactions.", "3-1": "C48 -- Sender on screenings list.", "4-1": "C49 -- Receiver on screenings list.", "5-1": "C50 -- Unable to process the transaction (reason undisclosed)." }, "cols": 2, "rows": 6 } [/block] [block:callout] { "type": "info", "body": "We recommend setting up [Subscriptions](doc:subscriptions) to receive these updates as they occur. \nAlternatively, you can also use [GET transaction](doc:transaction) to check status periodically (Not Recommended).", "title": "Staying Up-To-Date with Transaction Status" } [/block] [block:callout] { "type": "info", "body": "Please pay attention to `timeline` & `recent_status` keys in the transaction response. The `note` field contains transaction codes.", "title": "Locating Transaction Codes" } [/block] ## Example Queued Transaction [block:code] { "codes": [ { "code": "{\n \"amount\": {\n \"amount\": 1000.1,\n \"currency\": \"USD\"\n },\n \"timeline\": [\n {\n \"note\": \"Transaction Created.\",\n \"date\": 1490830657477,\n \"status_id\": \"1\",\n \"status\": \"CREATED\"\n },\n {\n \"note\": \"Q10-K Further investigation needed from Synapse.\",\n \"status_id\": \"-1\",\n \"date\": 1490830664676,\n \"status\": \"QUEUED-BY-SYNAPSE\"\n }\n ],\n \"fees\": [\n {\n \"note\": \"Synapse Facilitator Fee\",\n \"to\": {\n \"id\": \"55b3f8c686c2732b4c4e9df6\"\n },\n \"fee\": 0.2\n }\n ],\n \"client\": {\n \"name\": \"Test Sandbox KYC 2.0\",\n \"id\": \"589a9ff886c2736412ce7e9e\"\n },\n \"_id\": \"58dc45412ee69200208275d5\",\n \"extra\": {\n \"note\": \"Test transaction\",\n \"ip\": \"192.168.0.1\",\n \"created_on\": 1490830657477,\n \"process_on\": 1490830657477,\n \"supp_id\": \"1122444\",\n \"latlon\": \"0,0\"\n },\n \"to\": {\n \"user\": {\n \"legal_names\": [\n \"Test User\"\n ],\n \"_id\": \"589d56e17562960020caf936\"\n },\n \"nickname\": \"Fake Account\",\n \"type\": \"ACH-US\",\n \"id\": \"589dc0bdab6ce7001f7f89e8\"\n },\n \"recent_status\": {\n \"note\": \"Q10-K Further investigation needed from Synapse.\",\n \"status_id\": \"-1\",\n \"date\": 1490830664676,\n \"status\": \"QUEUED-BY-SYNAPSE\"\n },\n \"from\": {\n \"user\": {\n \"legal_names\": [\n \"Michael Scott\"\n ],\n \"_id\": \"58dc438499c8e5001fd63895\"\n },\n \"nickname\": \"Synapse Test Savings Account - 8902\",\n \"type\": \"ACH-US\",\n \"id\": \"58dc448cc54d7b0020113617\"\n },\n \"_v\": 2\n}", "language": "json", "name": "Queued Transaction" } ] } [/block]