{"_id":"55ff5a11948a830d0023a659","parentDoc":null,"version":{"_id":"55fa37c88065a10d004e5bb6","project":"54e405191e51932d006abc39","__v":11,"createdAt":"2015-09-17T03:47:20.956Z","releaseDate":"2015-09-17T03:47:20.956Z","categories":["55fa37ca8065a10d004e5bb7","55fa37ca8065a10d004e5bb8","55fa37ca8065a10d004e5bb9","55fa37ca8065a10d004e5bba","55fca6bf34ae7c0d00ab8ea0","55ff80fd9e7ccf0d000a1d93","560220af7435de0d00fabd0d","56107f21bb9d920d00303e70","563e184077681a0d00d96a02","56fafc6596ec7e0e002ac85f","5915e54f7c2c552d008b8549","59499fcd64b5f5002690bbc1","59c451b7772699001c0f1df1","59c9b42dec84880010c1f348"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"REST V3","version_clean":"3.1.0","version":"3.1"},"editedParams":true,"category":{"_id":"55fca6bf34ae7c0d00ab8ea0","version":"55fa37c88065a10d004e5bb6","pages":["55ff4f549f5a880d00a6c32b","55ff52fa9f5a880d00a6c32d","55ff54365c67200d00fa2fb6","55ff57305c67200d00fa2fc0","55ff583f948a830d0023a64a","55ff5a11948a830d0023a659","55ff6162feaf310d007dd66a","55ff62289e7ccf0d000a1d7a","55ff6455feaf310d007dd66b","55ff71436932a00d00ba7a3b","55ff814c8c0c9d0d00dcac33","55ff81ecfeaf310d007dd67f","55ff890a8c0c9d0d00dcac51","55ff89778c0c9d0d00dcac52","55ff8e50feaf310d007dd68d","55ff8edd0e2b090d00863365"],"project":"54e405191e51932d006abc39","__v":16,"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-19T00:05:19.904Z","from_sync":false,"order":5,"slug":"nodes","title":"Nodes"},"__v":5,"editedParams2":true,"project":"54e405191e51932d006abc39","user":"54e4044e8ef7552300409dcb","updates":["58d18e348a5a1a1900420f40"],"next":{"pages":[],"description":""},"createdAt":"2015-09-21T01:14:57.537Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{\n    \"error_code\": \"0\",\n    \"http_code\": \"200\",\n    \"limit\": 3,\n    \"node_count\": 3,\n    \"nodes\": [\n        {\n            \"_id\": \"594e606112e17a002f2e324e\",\n            \"_links\": {\n                \"self\": {\n                    \"href\": \"https://uat-api.synapsefi.com/v3.1/users/594e0fa2838454002ea317a0/nodes/594e606112e17a002f2e324e\"\n                }\n            },\n            \"allowed\": \"CREDIT-AND-DEBIT\",\n            \"client\": {\n                \"id\": \"589acd9ecb3cd400fa75ac06\",\n                \"name\": \"SynapseFI\"\n            },\n            \"extra\": {\n                \"other\": {},\n                \"supp_id\": \"\"\n            },\n            \"info\": {\n                \"account_num\": \"8901\",\n                \"address\": \"PO BOX 85139, RICHMOND, VA, US\",\n                \"balance\": {\n                    \"amount\": \"800.00\",\n                    \"currency\": \"USD\"\n                },\n                \"bank_long_name\": \"CAPITAL ONE N.A.\",\n                \"bank_name\": \"CAPITAL ONE N.A.\",\n                \"class\": \"CHECKING\",\n                \"match_info\": {\n                    \"email_match\": \"match\",\n                    \"name_match\": \"match\",\n                    \"phonenumber_match\": \"no_match\"\n                },\n                \"name_on_account\": \" \",\n                \"nickname\": \"SynapsePay Test Checking Account - 8901\",\n                \"routing_num\": \"6110\",\n                \"type\": \"BUSINESS\"\n            },\n            \"is_active\": true,\n            \"timeline\": [\n                {\n                    \"date\": 1498308705557,\n                    \"note\": \"Node created.\"\n                }\n            ],\n            \"type\": \"ACH-US\",\n            \"user_id\": \"594e0fa2838454002ea317a0\"\n        },\n        {\n        \t...\n        },\n        ...\n    ],\n    \"page_count\": 1,\n    \"success\": true\n}","language":"json","status":200},{"code":"{\n    \"error_code\": \"10\",\n    \"http_code\": \"202\",\n    \"mfa\": {\n        \"access_token\": \"fake_4d485d122c7b1ac5adcb661773599e\",\n        \"message\": \"I heard you don't like questions so can I ask you a question anyway?\",\n        \"type\": \"question\"\n    },\n    \"success\": true\n}","language":"json","status":202}]},"settings":"","examples":{"codes":[{"name":"","code":"POST /v3.1/users/594e0fa2838454002ea317a0/nodes HTTP/1.1\nHost: uat-api.synapsefi.com\nX-SP-USER-IP: 127.0.0.1\nX-SP-USER: oauth_auVIbQ8WXC0pnLU9ivEs4tcHDejqFJlwoNrZ3fO1|e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json\n\n{\n    \"access_token\":\"fake_cd60680b9addc013ca7fb25b2b70\",\n    \"mfa_answer\":\"test_answer\"\n}","language":"http"}]},"method":"post","auth":"required","params":[{"_id":"5573b11e91ce6e190023b76a","ref":"","in":"body","required":true,"desc":"Access token returned from previous step","default":"","type":"string","name":"access_token"},{"_id":"55fa4d6f764f5021009506c9","ref":"","in":"body","required":true,"desc":"Answer to the MFA question","default":"","type":"string","name":"mfa_answer"},{"_id":"594e617e3b8bb70055538e82","ref":"","in":"path","required":true,"desc":"The user ID of the user you wish to add the ACH-US node under","default":"","type":"string","name":"user_id"}],"url":"/v3.1/users/:user_id/nodes"},"isReference":true,"order":9,"body":"[block:api-header]\n{}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"UIaaS: Bank Logins\",\n  \"body\": \"Instead of integrating with this API, we recommend using our [Bank Logins](doc:bank-logins) instead.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"MFAs\",\n  \"body\": \"MFAs can be triggered once or multiple times. So please handle the logic with the exception of getting multiple MFAs for every bank login attempt. \\n\\nEven when banks send multiple MFA questions, they will do so one at a time. It is recommended that you send an answer back for the first question and then re-check the response for an http code of 202, which means another MFA question was sent. Cycle through the questions in this way until http code is 200.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Timeout Window\",\n  \"body\": \"Bank logins can take awhile sometimes. We recommend keeping your timeout window a little over 300sec.\"\n}\n[/block]","excerpt":"Submit answer to a MFA question from bank login attempt","slug":"add-ach-us-node-via-bank-logins-mfa","type":"endpoint","title":"ACH-US MFA"}

postACH-US MFA

Submit answer to a MFA question from bank login attempt

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

user_id:
required
string
The user ID of the user you wish to add the ACH-US node under

Body Params

access_token:
required
string
Access token returned from previous step
mfa_answer:
required
string
Answer to the MFA question

Examples


Result Format


Documentation

[block:api-header] {} [/block] [block:callout] { "type": "info", "title": "UIaaS: Bank Logins", "body": "Instead of integrating with this API, we recommend using our [Bank Logins](doc:bank-logins) instead." } [/block] [block:callout] { "type": "info", "title": "MFAs", "body": "MFAs can be triggered once or multiple times. So please handle the logic with the exception of getting multiple MFAs for every bank login attempt. \n\nEven when banks send multiple MFA questions, they will do so one at a time. It is recommended that you send an answer back for the first question and then re-check the response for an http code of 202, which means another MFA question was sent. Cycle through the questions in this way until http code is 200." } [/block] [block:callout] { "type": "info", "title": "Timeout Window", "body": "Bank logins can take awhile sometimes. We recommend keeping your timeout window a little over 300sec." } [/block]