{"__v":3,"_id":"55ff5a11948a830d0023a659","category":{"__v":16,"_id":"55fca6bf34ae7c0d00ab8ea0","pages":["55ff4f549f5a880d00a6c32b","55ff52fa9f5a880d00a6c32d","55ff54365c67200d00fa2fb6","55ff57305c67200d00fa2fc0","55ff583f948a830d0023a64a","55ff5a11948a830d0023a659","55ff6162feaf310d007dd66a","55ff62289e7ccf0d000a1d7a","55ff6455feaf310d007dd66b","55ff71436932a00d00ba7a3b","55ff814c8c0c9d0d00dcac33","55ff81ecfeaf310d007dd67f","55ff890a8c0c9d0d00dcac51","55ff89778c0c9d0d00dcac52","55ff8e50feaf310d007dd68d","55ff8edd0e2b090d00863365"],"project":"54e405191e51932d006abc39","version":"55fa37c88065a10d004e5bb6","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-19T00:05:19.904Z","from_sync":false,"order":3,"slug":"nodes","title":"Nodes"},"editedParams":true,"editedParams2":true,"parentDoc":null,"project":"54e405191e51932d006abc39","user":"54e4044e8ef7552300409dcb","version":{"__v":7,"_id":"55fa37c88065a10d004e5bb6","project":"54e405191e51932d006abc39","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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"REST V3","version_clean":"3.1.0","version":"3.1"},"updates":["58d18e348a5a1a1900420f40"],"next":{"pages":[],"description":""},"createdAt":"2015-09-21T01:14:57.537Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"name":"","code":"curl -X POST -H \"X-SP-USER-IP: 127.0.0.1\" -H \"X-SP-USER: oauth_40e63a68ef9a11e6834f0a81c1ab804f|e716990e50b67a1177736960b6357524b22090ccab093d068b3d7a18dbde3f4c\" -H \"Content-Type: application/json\" -d '{\n    \"access_token\":\"793ef2556efe00d5799706cf8801f0a1ecb051e0293f2224b54db06f9c84e3a6\",\n    \"mfa_answer\":\"test_answer\"\n}' \"https://sandbox.synapsepay.com/api/3/users/589dc8817562960020cb00c9/nodes\"","language":"curl"}]},"method":"post","results":{"codes":[{"status":200,"language":"json","code":"{\n    \"error_code\": \"0\",\n    \"http_code\": \"200\",\n    \"limit\": 2,\n    \"node_count\": 2,\n    \"nodes\": [\n        {\n            \"_id\": \"589dcb0e7e0887001e94048d\",\n            \"_links\": {\n                \"self\": {\n                    \"href\": \"https://uat-api.synapsefi.com/v3.1/users/589dc8817562960020cb00c9/nodes/589dcb0e7e0887001e94048d\"\n                }\n            },\n            \"allowed\": \"CREDIT-AND-DEBIT\",\n            \"client\": {\n                \"id\": \"589acd9ecb3cd400fa75ac06\",\n                \"name\": \"SynapseFI\"\n            },\n            \"extra\": {\n                \"supp_id\": \"\"\n            },\n            \"info\": {\n                \"account_num\": \"8902\",\n                \"address\": \"PO BOX 85139, RICHMOND, VA, US\",\n                \"balance\": {\n                    \"amount\": \"0.00\",\n                    \"currency\": \"USD\"\n                },\n                \"bank_long_name\": \"CAPITAL ONE N.A.\",\n                \"bank_name\": \"CAPITAL ONE N.A.\",\n                \"class\": \"SAVINGS\",\n                \"match_info\": {\n                    \"email_match\": \"no_match\",\n                    \"name_match\": \"no_match\",\n                    \"phonenumber_match\": \"no_match\"\n                },\n                \"name_on_account\": \"********\",\n                \"nickname\": \"SynapsePay Test Savings Account - 8902\",\n                \"routing_num\": \"6110\",\n                \"type\": \"PERSONAL\"\n            },\n            \"is_active\": true,\n            \"timeline\": [\n                {\n                    \"date\": 1486736288972,\n                    \"note\": \"Node created.\"\n                }\n            ],\n            \"type\": \"ACH-US\",\n            \"user_id\": \"589dc8817562960020cb00c9\"\n        },\n        {\n            ...\n        }\n    ],\n    \"page_count\": 1,\n    \"success\": true\n}","name":""},{"status":202,"language":"json","code":"{\n    \"error_code\": \"10\",\n    \"http_code\": \"202\",\n    \"mfa\": {\n        \"access_token\": \"6f6bccce5042161830e863f31394c05f9f7e1efb6cffe6b15d2ddf91dda9c727\",\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}"}]},"settings":"","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"}],"url":"/users/:user_id/nodes"},"isReference":true,"order":8,"body":"[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]","excerpt":"","slug":"add-ach-us-node-via-bank-logins-mfa","type":"endpoint","title":"ACH-US MFA"}

Definition

{{ api_url }}{{ page_api_url }}

Parameters

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: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]