{"_id":"5bd2b9c0065aca003858d2da","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":true,"is_stable":false,"codename":"","version_clean":"3.2.0","version":"3.2"},"category":{"_id":"5bd2a43548bb6f00289c8fad","project":"59f79e3c584eb200345ceafc","version":"5ba178b00a916500030c6a21","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2018-10-26T05:20:53.985Z","from_sync":false,"order":6,"slug":"card-processing","title":"Card Processing"},"user":"5557e76e512c300d007730d1","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-10-26T06:52:48.623Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Before you create a transaction, be sure to [Create a User](https://docs.synapsefi.com/v3.2/docs/create-a-user-1), [OAuth the User](https://docs.synapsefi.com/v3.2/docs/oauth-the-user), and [Link a Card.](https://docs.synapsefi.com/v3.2/docs/link-a-card).\n\n##API ENDPOINT\nhttps://uat-api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/trans\n\n##PATH PARAMETER\n[block:html]\n{\n  \"html\": \"<div class=\\\"api-manager\\\"> <div class=\\\"param-table\\\"> <div class=\\\"table\\\"><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong>user_id <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>ID of sender (user)</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong>node_id <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>ID of sending node</p></div></div></div></div></div></div>\"\n}\n[/block]\n##BODY PARAMETER\n[block:html]\n{\n  \"html\": \"<div class=\\\"api-manager\\\"> <div class=\\\"param-table\\\"> <div class=\\\"table\\\"> <div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">to.</span>type <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Receiving node type</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">to.</span>id <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Receiving node ID</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">amount.</span>amount <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">double</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Amount user wishes to send</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">amount.</span>currency <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Currency of the transaction amount</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.</span>ip <span class=\\\"colon\\\">:</span> </strong> <div class=\\\"required\\\">required</div></div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>IP address of the user device while creating transaction</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.</span>supp_id <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>ID supplied to the transaction</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.</span>group_id <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Group ID supplied to the transaction</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.</span>note <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Memo tagged with the transaction</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.</span>process_on <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">integer</strong> <span class=\\\"param-default text-muted\\\">0</span> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>When the transaction should be processed. The value is the delta value. Which means when 1 is supplied it means that the transaction will be processed tomorrow.</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">extra.other.</span>attachments <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">array of strings</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Array of padded base64 of attachments</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">fees[</span>fee <span class=\\\"text-muted\\\">]</span> <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">double</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Fee associated with the transaction</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">fees[</span>note <span class=\\\"text-muted\\\">]</span> <span class=\\\"colon\\\">:</span> </strong> </div><div class=\\\"td\\\"> <strong class=\\\"param-type\\\">string</strong> <div marked=\\\"\\\" class=\\\"ng-isolate-scope\\\"> <p>Reason for the fee</p></div></div></div><div class=\\\"tr\\\"> <div class=\\\"td param\\\"> <strong> <span class=\\\"text-muted\\\">fees[to].</span>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 where the fee would be credited when the transaction settled. Fee node has to be DEPOSIT-US type always</p></div></div></div></div></div></div>\"\n}\n[/block]\n##EXAMPLE REQUEST\nTo add an addendum to the transaction on the user's bank statement, use the 'note' field. Notes are limited to 80 characters.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /v3.1/users/5bc305abd83c197a45848f88/nodes/5bd2b691dc00d56658258222/trans HTTP/1.1\\nHost: uat-api.synapsefi.com\\nX-SP-USER-IP: 255.127.79.76\\nX-SP-USER: oauth_EOR8dloy035b9ZsDwXfUnCgBTKqmixAtFv2aMYz0|e83cf6ddcf778e37bfe3d48fc78a6502062fc\\nContent-Type: application/json\\n\\n{\\n  \\\"to\\\": {\\n    \\\"type\\\": \\\"DEPOSIT-US\\\",\\n    \\\"id\\\": \\\"5bd2b8cbf9bd8600c2a0ee9a\\\"\\n  },\\n  \\\"amount\\\": {\\n    \\\"amount\\\": 100.1,\\n    \\\"currency\\\": \\\"USD\\\"\\n  },\\n  \\\"extra\\\": {\\n    \\\"ip\\\": \\\"192.168.0.1\\\",\\n    \\\"note\\\": \\\"Test transaction\\\"\\n  }\\n}\",\n      \"language\": \"http\"\n    }\n  ]\n}\n[/block]\n##EXAMPLE RESPONSE\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"_id\\\": \\\"5bd2b986f61d8700e3eafa56\\\",\\n    \\\"_links\\\": {\\n        \\\"self\\\": {\\n            \\\"href\\\": \\\"https://uat-api.synapsefi.com/v3.1/users/5bc305abd83c197a45848f88/nodes/5bd2b691dc00d56658258222/trans/5bd2b986f61d8700e3eafa56\\\"\\n        }\\n    },\\n    \\\"_v\\\": 2,\\n    \\\"amount\\\": {\\n        \\\"amount\\\": 100.1,\\n        \\\"currency\\\": \\\"USD\\\"\\n    },\\n    \\\"client\\\": {\\n        \\\"id\\\": \\\"589acd9ecb3cd400fa75ac06\\\",\\n        \\\"name\\\": \\\"* SynapseFI\\\"\\n    },\\n    \\\"extra\\\": {\\n        \\\"asset\\\": null,\\n        \\\"created_on\\\": 1540536709757,\\n        \\\"encrypted_note\\\": \\\"\\\",\\n        \\\"group_id\\\": null,\\n        \\\"ip\\\": \\\"192.168.0.1\\\",\\n        \\\"latlon\\\": \\\"0,0\\\",\\n        \\\"note\\\": \\\"Test transaction\\\",\\n        \\\"process_on\\\": 1540536709757,\\n        \\\"same_day\\\": false,\\n        \\\"supp_id\\\": \\\"\\\"\\n    },\\n    \\\"fees\\\": [\\n        {\\n            \\\"fee\\\": 0,\\n            \\\"note\\\": \\\"Facilitator Fee\\\",\\n            \\\"to\\\": {\\n                \\\"id\\\": \\\"None\\\"\\n            }\\n        }\\n    ],\\n    \\\"from\\\": {\\n        \\\"id\\\": \\\"5bd2b691dc00d56658258222\\\",\\n        \\\"nickname\\\": \\\"My BofA Card\\\",\\n        \\\"type\\\": \\\"INTERCHANGE-US\\\",\\n        \\\"user\\\": {\\n            \\\"_id\\\": \\\"5bc305abd83c197a45848f88\\\",\\n            \\\"legal_names\\\": [\\n                \\\"Test User\\\"\\n            ]\\n        }\\n    },\\n    \\\"recent_status\\\": {\\n        \\\"date\\\": 1540536709757,\\n        \\\"note\\\": \\\"Transaction Created.\\\",\\n        \\\"status\\\": \\\"CREATED\\\",\\n        \\\"status_id\\\": \\\"1\\\"\\n    },\\n    \\\"timeline\\\": [\\n        {\\n            \\\"date\\\": 1540536709757,\\n            \\\"note\\\": \\\"Transaction Created.\\\",\\n            \\\"status\\\": \\\"CREATED\\\",\\n            \\\"status_id\\\": \\\"1\\\"\\n        }\\n    ],\\n    \\\"to\\\": {\\n        \\\"id\\\": \\\"5bd2b8cbf9bd8600c2a0ee9a\\\",\\n        \\\"nickname\\\": \\\"My Deposit Account\\\",\\n        \\\"type\\\": \\\"DEPOSIT-US\\\",\\n        \\\"user\\\": {\\n            \\\"_id\\\": \\\"5bc305abd83c197a45848f88\\\",\\n            \\\"legal_names\\\": [\\n                \\\"Test User\\\"\\n            ]\\n        }\\n    }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"200 Okay\"\n    }\n  ]\n}\n[/block]\n##Transaction Status\nThe following are different types of transaction statuses for a card processing transaction. \n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"QUEUED-BY-SYNAPSE\",\n    \"1-0\": \"QUEUED-BY-RECEIVER\",\n    \"2-0\": \"CREATED\",\n    \"3-0\": \"PROCESSING-DEBIT\",\n    \"4-0\": \"PROCESSING-CREDIT\",\n    \"5-0\": \"SETTLED\",\n    \"6-0\": \"CANCELED\",\n    \"7-0\": \"RETURNED\",\n    \"0-1\": \"-1\",\n    \"1-1\": \"0\",\n    \"2-1\": \"1\",\n    \"3-1\": \"2\",\n    \"4-1\": \"3\",\n    \"5-1\": \"4\",\n    \"6-1\": \"5\",\n    \"7-1\": \"6\",\n    \"0-2\": \"Transaction queued by Synapse\",\n    \"1-2\": \"Transaction queued by Client\",\n    \"2-2\": \"Transaction Created\",\n    \"3-2\": \"Transaction Processing Debit\",\n    \"4-2\": \"Transaction Processing Credit\",\n    \"5-2\": \"Transaction Settled\",\n    \"6-2\": \"Transaction Canceled\",\n    \"7-2\": \"Transaction Returned\"\n  },\n  \"cols\": 3,\n  \"rows\": 8\n}\n[/block]\n##Example Timeline\nHere is an example timeline for a check. Not all transactions will follow this exact timeline, so please do not build your logic off these times. Instead, monitor transaction status and account balance.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Description\",\n    \"h-1\": \"Time\",\n    \"h-2\": \"Transaction Status\",\n    \"h-3\": \"status_id\",\n    \"0-0\": \"User creates a transaction from their card\",\n    \"1-0\": \"The transaction amount is sent from the user's card\",\n    \"2-0\": \"The transaction amount is processing.\",\n    \"3-0\": \"The transaction settles\",\n    \"4-0\": \"\",\n    \"0-1\": \"12PM PT\",\n    \"1-1\": \"12PM PT\",\n    \"2-1\": \"12PM PT\",\n    \"3-1\": \"12PM PT\",\n    \"4-1\": \"\",\n    \"0-2\": \"CREATED\",\n    \"1-2\": \"PROCESSING-DEBIT\",\n    \"2-2\": \"PROCESSING-CREDIT\",\n    \"3-2\": \"SETTLED\",\n    \"4-2\": \"\",\n    \"0-3\": \"1\",\n    \"1-3\": \"2\",\n    \"2-3\": \"3\",\n    \"3-3\": \"4\",\n    \"4-3\": \"\"\n  },\n  \"cols\": 4,\n  \"rows\": 4\n}\n[/block]\n##Canceled and Queued Transactions\nVisit our [Transaction Codes resource](https://docs.synapsefi.com/v3.2/docs/transaction-codes) for the full list of reasons a transaction can be queued or canceled.\n\nTo cancel a transaction yourself, DELETE transaction. Only transactions with a CREATED or QUEUED status can be canceled. Once a transaction is settled you are unable to cancel it.\n\n##RETURNED TRANSACTIONS\nBelow are the possible return codes you can get upon creating a transaction.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"IR00\",\n    \"1-0\": \"IR01\",\n    \"3-0\": \"IR03\",\n    \"4-0\": \"IR04\",\n    \"5-0\": \"IR05\",\n    \"6-0\": \"IR06\",\n    \"7-0\": \"IR07\",\n    \"8-0\": \"IR08\",\n    \"9-0\": \"IR09\",\n    \"10-0\": \"IR10\",\n    \"11-0\": \"IR11\",\n    \"12-0\": \"IR12\",\n    \"13-0\": \"IR13\",\n    \"14-0\": \"IR14\",\n    \"15-0\": \"IR15\",\n    \"16-0\": \"IR16\",\n    \"17-0\": \"IR17\",\n    \"18-0\": \"IR18\",\n    \"19-0\": \"IR19\",\n    \"20-0\": \"IR20\",\n    \"21-0\": \"IR21\",\n    \"22-0\": \"IR22\",\n    \"23-0\": \"IR23\",\n    \"24-0\": \"IR24\",\n    \"25-0\": \"IR25\",\n    \"26-0\": \"IR26\",\n    \"27-0\": \"IR27\",\n    \"28-0\": \"IR28\",\n    \"29-0\": \"IR29\",\n    \"30-0\": \"IR30\",\n    \"31-0\": \"IR31\",\n    \"32-0\": \"IR32\",\n    \"33-0\": \"IR33\",\n    \"34-0\": \"IR34\",\n    \"35-0\": \"IR35\",\n    \"36-0\": \"IR36\",\n    \"37-0\": \"IR37\",\n    \"38-0\": \"IR38\",\n    \"39-0\": \"IR39\",\n    \"40-0\": \"IR40\",\n    \"41-0\": \"IR41\",\n    \"42-0\": \"IR42\",\n    \"43-0\": \"IR43\",\n    \"44-0\": \"IR44\",\n    \"45-0\": \"IR45 - IR50\",\n    \"46-0\": \"IR51\",\n    \"47-0\": \"IR52\",\n    \"48-0\": \"IR53\",\n    \"49-0\": \"IR54\",\n    \"50-0\": \"IR55\",\n    \"51-0\": \"IR56\",\n    \"52-0\": \"IR57\",\n    \"53-0\": \"IR58\",\n    \"54-0\": \"IR59\",\n    \"55-0\": \"IR60\",\n    \"56-0\": \"IR61\",\n    \"57-0\": \"IR62\",\n    \"58-0\": \"IR63\",\n    \"59-0\": \"IR64\",\n    \"60-0\": \"IR65\",\n    \"61-0\": \"IR66\",\n    \"62-0\": \"IR67\",\n    \"63-0\": \"IR68\",\n    \"64-0\": \"IR69 - IR74\",\n    \"65-0\": \"IR75\",\n    \"66-0\": \"IR76\",\n    \"67-0\": \"IR77\",\n    \"68-0\": \"IR78\",\n    \"69-0\": \"IR79\",\n    \"70-0\": \"IR80\",\n    \"71-0\": \"IR81\",\n    \"72-0\": \"IR82\",\n    \"73-0\": \"IR83\",\n    \"74-0\": \"IR84\",\n    \"75-0\": \"IR85\",\n    \"76-0\": \"IR86\",\n    \"77-0\": \"IR87\",\n    \"78-0\": \"IR88\",\n    \"79-0\": \"IR89\",\n    \"80-0\": \"IR90\",\n    \"81-0\": \"IR91\",\n    \"82-0\": \"IR92\",\n    \"83-0\": \"IR93\",\n    \"84-0\": \"IR94\",\n    \"85-0\": \"IR95\",\n    \"86-0\": \"IR96\",\n    \"87-0\": \"IR97\",\n    \"88-0\": \"IR98\",\n    \"89-0\": \"IR99\",\n    \"90-0\": \"IR100 - IR126\",\n    \"91-0\": \"IR127\",\n    \"92-0\": \"IR128\",\n    \"93-0\": \"IR129\",\n    \"94-0\": \"IR130\",\n    \"95-0\": \"IR131\",\n    \"96-0\": \"IR132\",\n    \"97-0\": \"IR133\",\n    \"98-0\": \"IR134\",\n    \"99-0\": \"IR135\",\n    \"100-0\": \"IR136\",\n    \"101-0\": \"IR137\",\n    \"102-0\": \"IR138\",\n    \"103-0\": \"IR139\",\n    \"104-0\": \"IR140\",\n    \"105-0\": \"IR141\",\n    \"106-0\": \"IR142\",\n    \"107-0\": \"IR143\",\n    \"108-0\": \"IR144\",\n    \"109-0\": \"IR145\",\n    \"110-0\": \"IR146\",\n    \"111-0\": \"IR147\",\n    \"112-0\": \"IR148\",\n    \"113-0\": \"IR149\",\n    \"114-0\": \"IR150\",\n    \"115-0\": \"IR151\",\n    \"116-0\": \"IR152\",\n    \"117-0\": \"IR153\",\n    \"118-0\": \"IR154\",\n    \"119-0\": \"IR155\",\n    \"120-0\": \"IR156\",\n    \"121-0\": \"IR157\",\n    \"122-0\": \"IR158\",\n    \"123-0\": \"IR159\",\n    \"124-0\": \"IR160\",\n    \"125-0\": \"IR161\",\n    \"126-0\": \"IR162\",\n    \"127-0\": \"IR163\",\n    \"128-0\": \"IR164\",\n    \"129-0\": \"IR165\",\n    \"130-0\": \"IR166\",\n    \"131-0\": \"IR167\",\n    \"132-0\": \"IR168\",\n    \"133-0\": \"IR169\",\n    \"134-0\": \"IR170\",\n    \"135-0\": \"IR171\",\n    \"136-0\": \"IR172\",\n    \"137-0\": \"IR173\",\n    \"138-0\": \"IR174\",\n    \"139-0\": \"IR175\",\n    \"140-0\": \"IR176\",\n    \"141-0\": \"IR177\",\n    \"142-0\": \"IR178\",\n    \"143-0\": \"IR179\",\n    \"144-0\": \"IR180\",\n    \"145-0\": \"IR181\",\n    \"146-0\": \"IR182\",\n    \"147-0\": \"IR183\",\n    \"148-0\": \"IR184\",\n    \"149-0\": \"IR185\",\n    \"150-0\": \"IR186\",\n    \"151-0\": \"IR187\",\n    \"152-0\": \"IR188\",\n    \"153-0\": \"IR189\",\n    \"154-0\": \"IR190\",\n    \"155-0\": \"IR191\",\n    \"156-0\": \"IR192\",\n    \"157-0\": \"IR193\",\n    \"158-0\": \"IR194\",\n    \"159-0\": \"IR195\",\n    \"160-0\": \"IR196\",\n    \"161-0\": \"IR197\",\n    \"162-0\": \"IR198\",\n    \"163-0\": \"IR199\",\n    \"164-0\": \"IR200\",\n    \"2-0\": \"IR02\",\n    \"0-1\": \"Success\",\n    \"1-1\": \"More information is needed from the card issuer\",\n    \"2-1\": \"Refer to card issuer's unique transaction rules\",\n    \"3-1\": \"Not recognized as a valid merchant\",\n    \"4-1\": \"Card not activated for transaction use\",\n    \"5-1\": \"Suspicious activity; do not honor this card's transactions\",\n    \"6-1\": \"Error during transaction process\",\n    \"7-1\": \"Card has unique conditions; currently not activated for transaction use\",\n    \"8-1\": \"Needs more identification to process the transaction\",\n    \"9-1\": \"Transaction requested; currently in progress\",\n    \"10-1\": \"Transaction amount partially approved\",\n    \"11-1\": \"Approved but not processed\",\n    \"12-1\": \"Transaction invalid\",\n    \"13-1\": \"Transaction amount invalid\",\n    \"14-1\": \"Card number does not exist\",\n    \"15-1\": \"Card issuer does not exist\",\n    \"16-1\": \"Approved\",\n    \"17-1\": \"Customer cancelled/reversed payment\",\n    \"18-1\": \"The customer reversed the transaction: chargeback\",\n    \"19-1\": \"Please retry the transaction\",\n    \"20-1\": \"Response from the card processor was invalid\",\n    \"21-1\": \"Transaction formatted incorrectly (Potential reversal detected)\",\n    \"22-1\": \"Suspected malfunction, reversal\",\n    \"23-1\": \"Transaction fee was unacceptable\",\n    \"24-1\": \"File update not supported by receiver\",\n    \"25-1\": \"Unable to locate record on file\",\n    \"26-1\": \"Duplicate file update record, no action taken\",\n    \"27-1\": \"File update field edit error\",\n    \"28-1\": \"Field update record locked out\",\n    \"29-1\": \"File update not successful, contact the acquirer\",\n    \"30-1\": \"Transaction formatted incorrectly(Potential reversal detected)\",\n    \"31-1\": \"Transaction must be initiated in person, bank not sup[ported by switch\\\"\",\n    \"32-1\": \"Completed partially, reversal\",\n    \"33-1\": \"Expired card, pick-up\",\n    \"34-1\": \"Suspected fraud, pick-up\",\n    \"35-1\": \"Card acceptor must contact acquirer, pick-up\",\n    \"36-1\": \"Restricted card, pick-up\",\n    \"37-1\": \"Merchant must contact the card security\",\n    \"38-1\": \"PIN tried too many times; request a new card or try again later\",\n    \"39-1\": \"No credit account tied to credit card\",\n    \"40-1\": \"Function requested can not be carried out\",\n    \"41-1\": \"Lost card: request a new card\",\n    \"42-1\": \"Account tied to card is not universal\",\n    \"43-1\": \"Stolen card: request a new card\",\n    \"44-1\": \"Investment account not on required\",\n    \"45-1\": \"Reserved for ISO use\",\n    \"46-1\": \"Card does not have sufficient funds for the transaction(NSF Card)\",\n    \"47-1\": \"Checking account not associated with the card\",\n    \"48-1\": \"Savings account not associated with the card\",\n    \"49-1\": \"Card Expired: request a new card\",\n    \"50-1\": \"Pin tried is incorrect\",\n    \"51-1\": \"No record of the validity of the card\",\n    \"52-1\": \"Transaction not permitted to cardholder\",\n    \"53-1\": \"Transaction denied by acceptor(Potential chargeback detected)\",\n    \"55-1\": \"Merchant must contact the card acquirer\",\n    \"54-1\": \"Fraud suspected\",\n    \"56-1\": \"Transaction exceeds withdrawal limit\",\n    \"57-1\": \"Card restricted\",\n    \"58-1\": \"Card information compromised(Potential chargeback detected)\",\n    \"59-1\": \"Original amount incorrect, reversal\",\n    \"60-1\": \"Current transactions exceeds withdrawal frequency limit\",\n    \"61-1\": \"Merchant must contact the card acquirer\",\n    \"62-1\": \"Hard capture\",\n    \"63-1\": \"Response received too late, reversal\",\n    \"64-1\": \"Reserved for ISO\",\n    \"65-1\": \"Allowable number of PIN tries exceeded\",\n    \"66-1\": \"Key synchronization error\",\n    \"67-1\": \"Reserved for private use\",\n    \"68-1\": \"Customer not eligible for POS\",\n    \"69-1\": \"Invalid digital signature\",\n    \"70-1\": \"Stale date transaction\",\n    \"71-1\": \"Issuer requested standin\",\n    \"72-1\": \"Count exceeds limit\",\n    \"73-1\": \"Reserved for private use\",\n    \"74-1\": \"Time limit for pre-authorization reached\",\n    \"75-1\": \"Issuer has no reason to decline the transaction (Account Verification)\",\n    \"76-1\": \"Cannot verify PIN\",\n    \"77-1\": \"Check already posted\",\n    \"78-1\": \"Card information not on file\",\n    \"79-1\": \"Security code verification failed\",\n    \"80-1\": \"Card cutoff is in progress\",\n    \"81-1\": \"Card change in progress or not taking effect\",\n    \"82-1\": \"Intermediate network/financial institution is unknown\",\n    \"83-1\": \"Transaction is in violation of the law and will not be completed\",\n    \"84-1\": \"Duplicate transaction\",\n    \"85-1\": \"Error with transaction reconciliation\",\n    \"86-1\": \"System error during transaction\",\n    \"87-1\": \"Reserved for national use\",\n    \"88-1\": \"Reserved for national use\",\n    \"89-1\": \"Card network error during transaction\",\n    \"90-1\": \"Reserved for ISO\",\n    \"91-1\": \"SEC is invalid\",\n    \"92-1\": \"Address and verification check data is required for this transaction\",\n    \"93-1\": \"Security code date is required for the transaction\",\n    \"94-1\": \"Transaction not permitted to cardholder\",\n    \"95-1\": \"Transaction not permitted to cardholder\",\n    \"96-1\": \"Country of the card issuer is blocked by this merchant\",\n    \"97-1\": \"Incorrect MAC was sent\",\n    \"98-1\": \"Standard Entry Class requirements were not met\",\n    \"99-1\": \"System error during transaction\",\n    \"100-1\": \"Account length error\",\n    \"101-1\": \"Card information error\",\n    \"102-1\": \"Security code format error\",\n    \"103-1\": \"Internal authorization error\",\n    \"104-1\": \"Card product code is blocked\",\n    \"105-1\": \"Attempt to process a BRIC transaction on a prior PIN based transaction\",\n    \"106-1\": \"CyberSource Time Out Connection to CyberSource timed out\",\n    \"107-1\": \"CARD_ENT_METH supplied is not valid or required additional data not provided as defined\",\n    \"108-1\": \"CARD_ID is not valid\",\n    \"109-1\": \"Required PIN block not present\",\n    \"110-1\": \"Card Bin is not valid for pinless routing\",\n    \"111-1\": \"Signature store did not complete\",\n    \"112-1\": \"Debit PIN transactions must be swiped\",\n    \"113-1\": \"DB proxy response was not processed within the time out period\",\n    \"114-1\": \"Transaction declined by merchant to security code mismatch\",\n    \"115-1\": \"Transaction not allowed as per a validation rule\",\n    \"116-1\": \"Processing gateway full: poll again later\",\n    \"117-1\": \"Authorization life cycle unacceptable\",\n    \"118-1\": \"Authorization life cycled expired\",\n    \"119-1\": \"Card authentication failed\",\n    \"120-1\": \"Fraudulent transaction prior to embossed valid date\",\n    \"121-1\": \"Credit not received\",\n    \"122-1\": \"Allowable PAN entries warning -- approved\",\n    \"123-1\": \"Transaction approved with card overdraft protection\",\n    \"124-1\": \"Security code is invalid\",\n    \"125-1\": \"Internal transaction processing error\",\n    \"126-1\": \"Check not acceptable for cash\",\n    \"127-1\": \"Check not acceptable\",\n    \"128-1\": \"Check deposit limit exceeded\",\n    \"129-1\": \"Cash back limit exceeded\",\n    \"130-1\": \"Check amount does not match courtesy amount\",\n    \"131-1\": \"PIN not selected for card\",\n    \"132-1\": \"PIN already selected for card\",\n    \"133-1\": \"Unmatched voucher information\",\n    \"134-1\": \"Card number entered too many times\",\n    \"135-1\": \"Expiration date not valid for card\",\n    \"136-1\": \"Card status is set to inactive\",\n    \"137-1\": \"Expiration date mismatch: request a new card\",\n    \"138-1\": \"Item suspected for stop pay\",\n    \"139-1\": \"Account associated with card was closed\",\n    \"140-1\": \"Account associated with card is ineligible for the transaction\",\n    \"141-1\": \"Duplicate transaction\",\n    \"142-1\": \"No account associated with card on file\",\n    \"143-1\": \"Unable to locate card\",\n    \"144-1\": \"Transaction denied\",\n    \"145-1\": \"Transaction settled via ACH\",\n    \"146-1\": \"Cross-reference card not found\",\n    \"147-1\": \"Category limit exceeded\",\n    \"148-1\": \"Transaction limit exceeded\",\n    \"149-1\": \"Daily limit exceeded\",\n    \"150-1\": \"Monthly limit exceeded\",\n    \"151-1\": \"Invalid secret code\",\n    \"152-1\": \"Pin key sync error\",\n    \"153-1\": \"Bad security code\",\n    \"154-1\": \"Transaction ordered to be stopped\",\n    \"155-1\": \"Transaction authorization revoked\",\n    \"156-1\": \"Stop reoccurring payments\",\n    \"157-1\": \"Card lost: do not honor\",\n    \"158-1\": \"Account associated with the card is closed\",\n    \"159-1\": \"Account associated with the card is inactive\",\n    \"160-1\": \"Card has unique conditions: do not honor\",\n    \"161-1\": \"Purchase only approval for purchase with cash back transaction\",\n    \"162-1\": \"Card does not have sufficient funds for the transaction fees (NSF Card)\",\n    \"163-1\": \"Card chip failed during transaction\",\n    \"164-1\": \"PIN compromised\"\n  },\n  \"cols\": 2,\n  \"rows\": 165\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Credit Cards vs Debit Cards\",\n  \"body\": \"In some cases, debit card processing may be preferable over credit card processing.\\n\\n**Funding Deposit Accounts** with a credit card may be considered a cash advance by some credit card companies.\\n\\n**Purchasing Crypro** may not be supported by some credit cards.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"We recommend that you [subscribe to webhooks](https://docs.synapsefi.com/v3.2/docs/subscribe-to-webhooks) to stay updated on the status of transactions.\",\n  \"title\": \"Subscribe to Webhooks\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Transaction Fees\",\n  \"body\": \"By default, we deduct transaction fees from the transaction. To send the recipient 100% of the funds, [designate the account you want to debit fees from](https://docs.synapsefi.com/v3.2/docs/facilitator-fees-for-transactions).\\n\\nOr take an additional `fee` for yourself and designate the DEPOSIT-US node you want to send fees to.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"POST calls support idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a transaction fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single charge is created.\\n\\nTo perform an idempotent request, attach a unique key to any POST request made to the API via the X-SP-IDEMPOTENCY-KEY: <key> header.\\n\\nIdempotency keys expire after 24 hours.\",\n  \"title\": \"Idempotent Requests\"\n}\n[/block]","excerpt":"Debiting funds from the card","slug":"pull-funds-from-card","type":"basic","title":"Pull Funds from Card"}

Pull Funds from Card

Debiting funds from the card

Before you create a transaction, be sure to [Create a User](https://docs.synapsefi.com/v3.2/docs/create-a-user-1), [OAuth the User](https://docs.synapsefi.com/v3.2/docs/oauth-the-user), and [Link a Card.](https://docs.synapsefi.com/v3.2/docs/link-a-card). ##API ENDPOINT https://uat-api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/trans ##PATH PARAMETER [block:html] { "html": "<div class=\"api-manager\"> <div class=\"param-table\"> <div class=\"table\"><div class=\"tr\"> <div class=\"td param\"> <strong>user_id <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>ID of sender (user)</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong>node_id <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>ID of sending node</p></div></div></div></div></div></div>" } [/block] ##BODY PARAMETER [block:html] { "html": "<div class=\"api-manager\"> <div class=\"param-table\"> <div class=\"table\"> <div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">to.</span>type <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Receiving node type</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">to.</span>id <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Receiving node ID</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">amount.</span>amount <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">double</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Amount user wishes to send</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">amount.</span>currency <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Currency of the transaction amount</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.</span>ip <span class=\"colon\">:</span> </strong> <div class=\"required\">required</div></div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>IP address of the user device while creating transaction</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.</span>supp_id <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>ID supplied to the transaction</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.</span>group_id <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Group ID supplied to the transaction</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.</span>note <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Memo tagged with the transaction</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.</span>process_on <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">integer</strong> <span class=\"param-default text-muted\">0</span> <div marked=\"\" class=\"ng-isolate-scope\"> <p>When the transaction should be processed. The value is the delta value. Which means when 1 is supplied it means that the transaction will be processed tomorrow.</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">extra.other.</span>attachments <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">array of strings</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Array of padded base64 of attachments</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">fees[</span>fee <span class=\"text-muted\">]</span> <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">double</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Fee associated with the transaction</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">fees[</span>note <span class=\"text-muted\">]</span> <span class=\"colon\">:</span> </strong> </div><div class=\"td\"> <strong class=\"param-type\">string</strong> <div marked=\"\" class=\"ng-isolate-scope\"> <p>Reason for the fee</p></div></div></div><div class=\"tr\"> <div class=\"td param\"> <strong> <span class=\"text-muted\">fees[to].</span>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 where the fee would be credited when the transaction settled. Fee node has to be DEPOSIT-US type always</p></div></div></div></div></div></div>" } [/block] ##EXAMPLE REQUEST To add an addendum to the transaction on the user's bank statement, use the 'note' field. Notes are limited to 80 characters. [block:code] { "codes": [ { "code": "POST /v3.1/users/5bc305abd83c197a45848f88/nodes/5bd2b691dc00d56658258222/trans HTTP/1.1\nHost: uat-api.synapsefi.com\nX-SP-USER-IP: 255.127.79.76\nX-SP-USER: oauth_EOR8dloy035b9ZsDwXfUnCgBTKqmixAtFv2aMYz0|e83cf6ddcf778e37bfe3d48fc78a6502062fc\nContent-Type: application/json\n\n{\n \"to\": {\n \"type\": \"DEPOSIT-US\",\n \"id\": \"5bd2b8cbf9bd8600c2a0ee9a\"\n },\n \"amount\": {\n \"amount\": 100.1,\n \"currency\": \"USD\"\n },\n \"extra\": {\n \"ip\": \"192.168.0.1\",\n \"note\": \"Test transaction\"\n }\n}", "language": "http" } ] } [/block] ##EXAMPLE RESPONSE [block:code] { "codes": [ { "code": "{\n \"_id\": \"5bd2b986f61d8700e3eafa56\",\n \"_links\": {\n \"self\": {\n \"href\": \"https://uat-api.synapsefi.com/v3.1/users/5bc305abd83c197a45848f88/nodes/5bd2b691dc00d56658258222/trans/5bd2b986f61d8700e3eafa56\"\n }\n },\n \"_v\": 2,\n \"amount\": {\n \"amount\": 100.1,\n \"currency\": \"USD\"\n },\n \"client\": {\n \"id\": \"589acd9ecb3cd400fa75ac06\",\n \"name\": \"* SynapseFI\"\n },\n \"extra\": {\n \"asset\": null,\n \"created_on\": 1540536709757,\n \"encrypted_note\": \"\",\n \"group_id\": null,\n \"ip\": \"192.168.0.1\",\n \"latlon\": \"0,0\",\n \"note\": \"Test transaction\",\n \"process_on\": 1540536709757,\n \"same_day\": false,\n \"supp_id\": \"\"\n },\n \"fees\": [\n {\n \"fee\": 0,\n \"note\": \"Facilitator Fee\",\n \"to\": {\n \"id\": \"None\"\n }\n }\n ],\n \"from\": {\n \"id\": \"5bd2b691dc00d56658258222\",\n \"nickname\": \"My BofA Card\",\n \"type\": \"INTERCHANGE-US\",\n \"user\": {\n \"_id\": \"5bc305abd83c197a45848f88\",\n \"legal_names\": [\n \"Test User\"\n ]\n }\n },\n \"recent_status\": {\n \"date\": 1540536709757,\n \"note\": \"Transaction Created.\",\n \"status\": \"CREATED\",\n \"status_id\": \"1\"\n },\n \"timeline\": [\n {\n \"date\": 1540536709757,\n \"note\": \"Transaction Created.\",\n \"status\": \"CREATED\",\n \"status_id\": \"1\"\n }\n ],\n \"to\": {\n \"id\": \"5bd2b8cbf9bd8600c2a0ee9a\",\n \"nickname\": \"My Deposit Account\",\n \"type\": \"DEPOSIT-US\",\n \"user\": {\n \"_id\": \"5bc305abd83c197a45848f88\",\n \"legal_names\": [\n \"Test User\"\n ]\n }\n }\n}", "language": "json", "name": "200 Okay" } ] } [/block] ##Transaction Status The following are different types of transaction statuses for a card processing transaction. [block:parameters] { "data": { "0-0": "QUEUED-BY-SYNAPSE", "1-0": "QUEUED-BY-RECEIVER", "2-0": "CREATED", "3-0": "PROCESSING-DEBIT", "4-0": "PROCESSING-CREDIT", "5-0": "SETTLED", "6-0": "CANCELED", "7-0": "RETURNED", "0-1": "-1", "1-1": "0", "2-1": "1", "3-1": "2", "4-1": "3", "5-1": "4", "6-1": "5", "7-1": "6", "0-2": "Transaction queued by Synapse", "1-2": "Transaction queued by Client", "2-2": "Transaction Created", "3-2": "Transaction Processing Debit", "4-2": "Transaction Processing Credit", "5-2": "Transaction Settled", "6-2": "Transaction Canceled", "7-2": "Transaction Returned" }, "cols": 3, "rows": 8 } [/block] ##Example Timeline Here is an example timeline for a check. Not all transactions will follow this exact timeline, so please do not build your logic off these times. Instead, monitor transaction status and account balance. [block:parameters] { "data": { "h-0": "Description", "h-1": "Time", "h-2": "Transaction Status", "h-3": "status_id", "0-0": "User creates a transaction from their card", "1-0": "The transaction amount is sent from the user's card", "2-0": "The transaction amount is processing.", "3-0": "The transaction settles", "4-0": "", "0-1": "12PM PT", "1-1": "12PM PT", "2-1": "12PM PT", "3-1": "12PM PT", "4-1": "", "0-2": "CREATED", "1-2": "PROCESSING-DEBIT", "2-2": "PROCESSING-CREDIT", "3-2": "SETTLED", "4-2": "", "0-3": "1", "1-3": "2", "2-3": "3", "3-3": "4", "4-3": "" }, "cols": 4, "rows": 4 } [/block] ##Canceled and Queued Transactions Visit our [Transaction Codes resource](https://docs.synapsefi.com/v3.2/docs/transaction-codes) for the full list of reasons a transaction can be queued or canceled. To cancel a transaction yourself, DELETE transaction. Only transactions with a CREATED or QUEUED status can be canceled. Once a transaction is settled you are unable to cancel it. ##RETURNED TRANSACTIONS Below are the possible return codes you can get upon creating a transaction. [block:parameters] { "data": { "h-0": "Code", "h-1": "Description", "0-0": "IR00", "1-0": "IR01", "3-0": "IR03", "4-0": "IR04", "5-0": "IR05", "6-0": "IR06", "7-0": "IR07", "8-0": "IR08", "9-0": "IR09", "10-0": "IR10", "11-0": "IR11", "12-0": "IR12", "13-0": "IR13", "14-0": "IR14", "15-0": "IR15", "16-0": "IR16", "17-0": "IR17", "18-0": "IR18", "19-0": "IR19", "20-0": "IR20", "21-0": "IR21", "22-0": "IR22", "23-0": "IR23", "24-0": "IR24", "25-0": "IR25", "26-0": "IR26", "27-0": "IR27", "28-0": "IR28", "29-0": "IR29", "30-0": "IR30", "31-0": "IR31", "32-0": "IR32", "33-0": "IR33", "34-0": "IR34", "35-0": "IR35", "36-0": "IR36", "37-0": "IR37", "38-0": "IR38", "39-0": "IR39", "40-0": "IR40", "41-0": "IR41", "42-0": "IR42", "43-0": "IR43", "44-0": "IR44", "45-0": "IR45 - IR50", "46-0": "IR51", "47-0": "IR52", "48-0": "IR53", "49-0": "IR54", "50-0": "IR55", "51-0": "IR56", "52-0": "IR57", "53-0": "IR58", "54-0": "IR59", "55-0": "IR60", "56-0": "IR61", "57-0": "IR62", "58-0": "IR63", "59-0": "IR64", "60-0": "IR65", "61-0": "IR66", "62-0": "IR67", "63-0": "IR68", "64-0": "IR69 - IR74", "65-0": "IR75", "66-0": "IR76", "67-0": "IR77", "68-0": "IR78", "69-0": "IR79", "70-0": "IR80", "71-0": "IR81", "72-0": "IR82", "73-0": "IR83", "74-0": "IR84", "75-0": "IR85", "76-0": "IR86", "77-0": "IR87", "78-0": "IR88", "79-0": "IR89", "80-0": "IR90", "81-0": "IR91", "82-0": "IR92", "83-0": "IR93", "84-0": "IR94", "85-0": "IR95", "86-0": "IR96", "87-0": "IR97", "88-0": "IR98", "89-0": "IR99", "90-0": "IR100 - IR126", "91-0": "IR127", "92-0": "IR128", "93-0": "IR129", "94-0": "IR130", "95-0": "IR131", "96-0": "IR132", "97-0": "IR133", "98-0": "IR134", "99-0": "IR135", "100-0": "IR136", "101-0": "IR137", "102-0": "IR138", "103-0": "IR139", "104-0": "IR140", "105-0": "IR141", "106-0": "IR142", "107-0": "IR143", "108-0": "IR144", "109-0": "IR145", "110-0": "IR146", "111-0": "IR147", "112-0": "IR148", "113-0": "IR149", "114-0": "IR150", "115-0": "IR151", "116-0": "IR152", "117-0": "IR153", "118-0": "IR154", "119-0": "IR155", "120-0": "IR156", "121-0": "IR157", "122-0": "IR158", "123-0": "IR159", "124-0": "IR160", "125-0": "IR161", "126-0": "IR162", "127-0": "IR163", "128-0": "IR164", "129-0": "IR165", "130-0": "IR166", "131-0": "IR167", "132-0": "IR168", "133-0": "IR169", "134-0": "IR170", "135-0": "IR171", "136-0": "IR172", "137-0": "IR173", "138-0": "IR174", "139-0": "IR175", "140-0": "IR176", "141-0": "IR177", "142-0": "IR178", "143-0": "IR179", "144-0": "IR180", "145-0": "IR181", "146-0": "IR182", "147-0": "IR183", "148-0": "IR184", "149-0": "IR185", "150-0": "IR186", "151-0": "IR187", "152-0": "IR188", "153-0": "IR189", "154-0": "IR190", "155-0": "IR191", "156-0": "IR192", "157-0": "IR193", "158-0": "IR194", "159-0": "IR195", "160-0": "IR196", "161-0": "IR197", "162-0": "IR198", "163-0": "IR199", "164-0": "IR200", "2-0": "IR02", "0-1": "Success", "1-1": "More information is needed from the card issuer", "2-1": "Refer to card issuer's unique transaction rules", "3-1": "Not recognized as a valid merchant", "4-1": "Card not activated for transaction use", "5-1": "Suspicious activity; do not honor this card's transactions", "6-1": "Error during transaction process", "7-1": "Card has unique conditions; currently not activated for transaction use", "8-1": "Needs more identification to process the transaction", "9-1": "Transaction requested; currently in progress", "10-1": "Transaction amount partially approved", "11-1": "Approved but not processed", "12-1": "Transaction invalid", "13-1": "Transaction amount invalid", "14-1": "Card number does not exist", "15-1": "Card issuer does not exist", "16-1": "Approved", "17-1": "Customer cancelled/reversed payment", "18-1": "The customer reversed the transaction: chargeback", "19-1": "Please retry the transaction", "20-1": "Response from the card processor was invalid", "21-1": "Transaction formatted incorrectly (Potential reversal detected)", "22-1": "Suspected malfunction, reversal", "23-1": "Transaction fee was unacceptable", "24-1": "File update not supported by receiver", "25-1": "Unable to locate record on file", "26-1": "Duplicate file update record, no action taken", "27-1": "File update field edit error", "28-1": "Field update record locked out", "29-1": "File update not successful, contact the acquirer", "30-1": "Transaction formatted incorrectly(Potential reversal detected)", "31-1": "Transaction must be initiated in person, bank not sup[ported by switch\"", "32-1": "Completed partially, reversal", "33-1": "Expired card, pick-up", "34-1": "Suspected fraud, pick-up", "35-1": "Card acceptor must contact acquirer, pick-up", "36-1": "Restricted card, pick-up", "37-1": "Merchant must contact the card security", "38-1": "PIN tried too many times; request a new card or try again later", "39-1": "No credit account tied to credit card", "40-1": "Function requested can not be carried out", "41-1": "Lost card: request a new card", "42-1": "Account tied to card is not universal", "43-1": "Stolen card: request a new card", "44-1": "Investment account not on required", "45-1": "Reserved for ISO use", "46-1": "Card does not have sufficient funds for the transaction(NSF Card)", "47-1": "Checking account not associated with the card", "48-1": "Savings account not associated with the card", "49-1": "Card Expired: request a new card", "50-1": "Pin tried is incorrect", "51-1": "No record of the validity of the card", "52-1": "Transaction not permitted to cardholder", "53-1": "Transaction denied by acceptor(Potential chargeback detected)", "55-1": "Merchant must contact the card acquirer", "54-1": "Fraud suspected", "56-1": "Transaction exceeds withdrawal limit", "57-1": "Card restricted", "58-1": "Card information compromised(Potential chargeback detected)", "59-1": "Original amount incorrect, reversal", "60-1": "Current transactions exceeds withdrawal frequency limit", "61-1": "Merchant must contact the card acquirer", "62-1": "Hard capture", "63-1": "Response received too late, reversal", "64-1": "Reserved for ISO", "65-1": "Allowable number of PIN tries exceeded", "66-1": "Key synchronization error", "67-1": "Reserved for private use", "68-1": "Customer not eligible for POS", "69-1": "Invalid digital signature", "70-1": "Stale date transaction", "71-1": "Issuer requested standin", "72-1": "Count exceeds limit", "73-1": "Reserved for private use", "74-1": "Time limit for pre-authorization reached", "75-1": "Issuer has no reason to decline the transaction (Account Verification)", "76-1": "Cannot verify PIN", "77-1": "Check already posted", "78-1": "Card information not on file", "79-1": "Security code verification failed", "80-1": "Card cutoff is in progress", "81-1": "Card change in progress or not taking effect", "82-1": "Intermediate network/financial institution is unknown", "83-1": "Transaction is in violation of the law and will not be completed", "84-1": "Duplicate transaction", "85-1": "Error with transaction reconciliation", "86-1": "System error during transaction", "87-1": "Reserved for national use", "88-1": "Reserved for national use", "89-1": "Card network error during transaction", "90-1": "Reserved for ISO", "91-1": "SEC is invalid", "92-1": "Address and verification check data is required for this transaction", "93-1": "Security code date is required for the transaction", "94-1": "Transaction not permitted to cardholder", "95-1": "Transaction not permitted to cardholder", "96-1": "Country of the card issuer is blocked by this merchant", "97-1": "Incorrect MAC was sent", "98-1": "Standard Entry Class requirements were not met", "99-1": "System error during transaction", "100-1": "Account length error", "101-1": "Card information error", "102-1": "Security code format error", "103-1": "Internal authorization error", "104-1": "Card product code is blocked", "105-1": "Attempt to process a BRIC transaction on a prior PIN based transaction", "106-1": "CyberSource Time Out Connection to CyberSource timed out", "107-1": "CARD_ENT_METH supplied is not valid or required additional data not provided as defined", "108-1": "CARD_ID is not valid", "109-1": "Required PIN block not present", "110-1": "Card Bin is not valid for pinless routing", "111-1": "Signature store did not complete", "112-1": "Debit PIN transactions must be swiped", "113-1": "DB proxy response was not processed within the time out period", "114-1": "Transaction declined by merchant to security code mismatch", "115-1": "Transaction not allowed as per a validation rule", "116-1": "Processing gateway full: poll again later", "117-1": "Authorization life cycle unacceptable", "118-1": "Authorization life cycled expired", "119-1": "Card authentication failed", "120-1": "Fraudulent transaction prior to embossed valid date", "121-1": "Credit not received", "122-1": "Allowable PAN entries warning -- approved", "123-1": "Transaction approved with card overdraft protection", "124-1": "Security code is invalid", "125-1": "Internal transaction processing error", "126-1": "Check not acceptable for cash", "127-1": "Check not acceptable", "128-1": "Check deposit limit exceeded", "129-1": "Cash back limit exceeded", "130-1": "Check amount does not match courtesy amount", "131-1": "PIN not selected for card", "132-1": "PIN already selected for card", "133-1": "Unmatched voucher information", "134-1": "Card number entered too many times", "135-1": "Expiration date not valid for card", "136-1": "Card status is set to inactive", "137-1": "Expiration date mismatch: request a new card", "138-1": "Item suspected for stop pay", "139-1": "Account associated with card was closed", "140-1": "Account associated with card is ineligible for the transaction", "141-1": "Duplicate transaction", "142-1": "No account associated with card on file", "143-1": "Unable to locate card", "144-1": "Transaction denied", "145-1": "Transaction settled via ACH", "146-1": "Cross-reference card not found", "147-1": "Category limit exceeded", "148-1": "Transaction limit exceeded", "149-1": "Daily limit exceeded", "150-1": "Monthly limit exceeded", "151-1": "Invalid secret code", "152-1": "Pin key sync error", "153-1": "Bad security code", "154-1": "Transaction ordered to be stopped", "155-1": "Transaction authorization revoked", "156-1": "Stop reoccurring payments", "157-1": "Card lost: do not honor", "158-1": "Account associated with the card is closed", "159-1": "Account associated with the card is inactive", "160-1": "Card has unique conditions: do not honor", "161-1": "Purchase only approval for purchase with cash back transaction", "162-1": "Card does not have sufficient funds for the transaction fees (NSF Card)", "163-1": "Card chip failed during transaction", "164-1": "PIN compromised" }, "cols": 2, "rows": 165 } [/block] [block:callout] { "type": "warning", "title": "Credit Cards vs Debit Cards", "body": "In some cases, debit card processing may be preferable over credit card processing.\n\n**Funding Deposit Accounts** with a credit card may be considered a cash advance by some credit card companies.\n\n**Purchasing Crypro** may not be supported by some credit cards." } [/block] [block:callout] { "type": "info", "body": "We recommend that you [subscribe to webhooks](https://docs.synapsefi.com/v3.2/docs/subscribe-to-webhooks) to stay updated on the status of transactions.", "title": "Subscribe to Webhooks" } [/block] [block:callout] { "type": "info", "title": "Transaction Fees", "body": "By default, we deduct transaction fees from the transaction. To send the recipient 100% of the funds, [designate the account you want to debit fees from](https://docs.synapsefi.com/v3.2/docs/facilitator-fees-for-transactions).\n\nOr take an additional `fee` for yourself and designate the DEPOSIT-US node you want to send fees to." } [/block] [block:callout] { "type": "info", "body": "POST calls support idempotency for safely retrying requests without accidentally performing the same operation twice. For example, if a request to create a transaction fails due to a network connection error, you can retry the request with the same idempotency key to guarantee that only a single charge is created.\n\nTo perform an idempotent request, attach a unique key to any POST request made to the API via the X-SP-IDEMPOTENCY-KEY: <key> header.\n\nIdempotency keys expire after 24 hours.", "title": "Idempotent Requests" } [/block]