Transactions

relevant webhooks for this endpoint be sure you have docid\ bn5xtgkjogbe ctwomcbs for these webhooks core transaction completed core transaction rejected api reference the core transactions api endpoint allows partners to move funds between their accounts this endpoint effects a book transfer it is an extended version of the transfer endpoint it allows you to provide a description and transaction code in the context of advanced authorization, this endpoint is provided for the partner to sync external activity (transactions) into cross river accounts at the end of each day { "name" "endpoint /core/v1/transactions", "method" "post", "url" "https //sandbox crbcos com/core/v1/transactions", "description" "", "tab" "examples", "examples" { "languages" \[ { "id" "hiyb6hxbzbif03ihcjxah", "language" "curl", "code" "curl l 'https //sandbox crbcos com/core/v1/transactions' ^\n h 'content type application/json' ^\n h 'authorization bearer token' ^\n d '{\n \\"debitaccountnumber\\" \\"2955057589\\",\n \\"creditaccountnumber\\" \\"2870342504\\",\n \\"transactioncode\\" \\"account transfer\\",\n \\"description\\" \\"settlement transfer\\",\n \\"amount\\" 13571,\n \\"currency\\" \\"usd\\",\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",\n \\"flags\\" \[]\n}\n\n\n'", "customlabel" "" }, { "id" "f lyjmznt01fnndomwel4", "language" "nodejs", "code" "var https = require('follow redirects') https;\nvar fs = require('fs');\n\nvar options = {\n 'method' 'post',\n 'hostname' 'sandbox crbcos com',\n 'path' '/core/v1/transactions',\n 'headers' {\n 'content type' 'application/json',\n 'authorization' 'bearer token'\n },\n 'maxredirects' 20\n};\n\nvar req = https request(options, function (res) {\n var chunks = \[];\n\n res on(\\"data\\", function (chunk) {\n chunks push(chunk);\n });\n\n res on(\\"end\\", function (chunk) {\n var body = buffer concat(chunks);\n console log(body tostring());\n });\n\n res on(\\"error\\", function (error) {\n console error(error);\n });\n});\n\nvar postdata = json stringify({\n \\"debitaccountnumber\\" \\"2955057589\\",\n \\"creditaccountnumber\\" \\"2870342504\\",\n \\"transactioncode\\" \\"account transfer\\",\n \\"description\\" \\"settlement transfer\\",\n \\"amount\\" 13571,\n \\"currency\\" \\"usd\\",\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",\n \\"flags\\" \[]\n});\n\nreq write(postdata);\n\nreq end", "customlabel" "" }, { "id" "9r0lv8lxczyelxdytg268", "language" "python", "code" "import requests\nimport json\n\nurl = \\"https //sandbox crbcos com/core/v1/transactions\\"\n\npayload = json dumps({\n \\"debitaccountnumber\\" \\"2955057589\\",\n \\"creditaccountnumber\\" \\"2870342504\\",\n \\"transactioncode\\" \\"account transfer\\",\n \\"description\\" \\"settlement transfer\\",\n \\"amount\\" 13571,\n \\"currency\\" \\"usd\\",\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",\n \\"flags\\" \[]\n})\nheaders = {\n 'content type' 'application/json',\n 'authorization' 'bearer token'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" "ormxhrj1gp38q8iicnoua", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //sandbox crbcos com/core/v1/transactions\\")\n\nhttps = net http new(url host, url port)\nhttps use ssl = true\n\nrequest = net http post new(url)\nrequest\[\\"content type\\"] = \\"application/json\\"\nrequest\[\\"authorization\\"] = \\"bearer token\\"\nrequest body = json dump({\n \\"debitaccountnumber\\" \\"2955057589\\",\n \\"creditaccountnumber\\" \\"2870342504\\",\n \\"transactioncode\\" \\"account transfer\\",\n \\"description\\" \\"settlement transfer\\",\n \\"amount\\" 13571,\n \\"currency\\" \\"usd\\",\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",\n \\"flags\\" \[]\n})\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" }, { "id" "nhillip3pdvk4iyteztng", "language" "go", "code" "package main\n\nimport (\n \\"fmt\\"\n \\"strings\\"\n \\"net/http\"\n \\"io\\"\n)\n\nfunc main() {\n\n url = \\"https //sandbox crbcos com/core/v1/transactions\\"\n method = \\"post\\"\n\n payload = strings newreader(`{`+\\"\n\\"+`\n \\"debitaccountnumber\\" \\"2955057589\\",`+\\"\n\\"+`\n \\"creditaccountnumber\\" \\"2870342504\\",`+\\"\n\\"+`\n \\"transactioncode\\" \\"account transfer\\",`+\\"\n\\"+`\n \\"description\\" \\"settlement transfer\\",`+\\"\n\\"+`\n \\"amount\\" 13571,`+\\"\n\\"+`\n \\"currency\\" \\"usd\\",`+\\"\n\\"+`\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",`+\\"\n\\"+`\n \\"flags\\" \[]`+\\"\n\\"+`\n}`+\\"\n\\"+`\n`+\\"\n\\"+`\n\n`)\n\n client = \&http client {\n }\n req, err = http newrequest(method, url, payload)\n\n if err != nil {\n fmt println(err)\n return\n }\n req header add(\\"content type\\", \\"application/json\\")\n req header add(\\"authorization\\", \\"bearer token\\")\n\n res, err = client do(req)\n if err != nil {\n fmt println(err)\n return\n }\n defer res body close()\n\n body, err = io readall(res body)\n if err != nil {\n fmt println(err)\n return\n }\n fmt println(string(body))\n}", "customlabel" "" } ], "selectedlanguageid" "hiyb6hxbzbif03ihcjxah" }, "results" { "languages" \[ { "id" "kcrcuayhepl8dhvegmp34", "language" "200", "code" "{\n \\"id\\" \\"3ef99bff 13b6 45cf b808 b323007e90c2\\",\n \\"tracenumber\\" \\"t25204034048y94rz\\",\n \\"status\\" \\"pending\\",\n \\"debit\\" {\n \\"transactiontype\\" \\"debit\\",\n \\"accounttype\\" \\"deposit\\",\n \\"masteraccountnumber\\" \\"2955057589\\",\n \\"subaccountnumber\\" \\"2955057589\\",\n \\"partnerid\\" \\"1101a33d fbd9 4b9e b169 b29500f12407\\",\n \\"productid\\" \\"29f3022a ccfc 42eb aa8f b29500f13d00\\",\n \\"activityid\\" \\"f8c46dae 5a12 4f57 a1ea b323007e90c2\\"\n },\n \\"credit\\" {\n \\"transactiontype\\" \\"credit\\",\n \\"accounttype\\" \\"deposit\\",\n \\"masteraccountnumber\\" \\"2870342504\\",\n \\"subaccountnumber\\" \\"2870342504\\",\n \\"partnerid\\" \\"1101a33d fbd9 4b9e b169 b29500f12407\\",\n \\"productid\\" \\"29f3022a ccfc 42eb aa8f b29500f13d00\\",\n \\"activityid\\" \\"47a622fc c9ae 4390 b411 b323007e90c2\\"\n },\n \\"transactioncode\\" \\"account transfer\\",\n \\"amount\\" 13571,\n \\"currency\\" \\"usd\\",\n \\"description\\" \\"settlement transfer\\",\n \\"rail\\" \\"internal\\",\n \\"railid\\" \\"0\\",\n \\"clientidentifier\\" \\"1988192d 3967 485e a720 ffef339638ab\\",\n \\"flags\\" \[],\n \\"schedule\\" \[],\n \\"proposedat\\" \\"2025 07 23t03 40 48 6439092 04 00\\",\n ", "customlabel" "" }, { "id" "3xsbc2ijr 92tycnhat1k", "language" "400", "code" "{\n \\"errors\\" \[\n {\n \\"code\\" 2626,\n \\"message\\" \\"debit account not found\\"\n }\n ]\n}", "customlabel" "" } ], "selectedlanguageid" "kcrcuayhepl8dhvegmp34" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "debitaccountnumber", "kind" "required", "type" "string", "description" "one of the two cos account numbers associated to the transaction – it refers to the account that is getting the funds debited to credit another account ", "" "required" }, { "name" "creditaccountnumber", "kind" "required", "type" "string", "description" "one of the two cos account numbers associated to the transaction – it refers to the account that is getting funds credited from another account ", "" "required" }, { "name" "transactioncode", "kind" "required", "type" "string", "description" "an identifier used to describe the type of transaction examples of values (non exhaustive) see complete list of transaction codes in the requests and response codes page \n account transfer\n deposit\n adjustment", "" "an identifier used to describe the type of transaction examples of values (non exhaustive) see complete list of transaction codes in the requests and response codes page \n account transfer\n deposit\n adjustment" }, { "name" "description", "kind" "required", "type" "string", "description" "a description that will identify the transaction as it gets posted ", "" "required" }, { "name" "amount", "kind" "required", "type" "integer", "description" "amount of the transaction in positive integral cents for example, write $1 00 as 100 ", "" "integer" }, { "name" "currency", "kind" "optional", "type" "string", "description" "currency of the transfer amount", "" "currency of the transfer amount" }, { "name" "clientidentifier", "kind" "optional", "type" "string", "description" "use this attribute to add your own unique identifying string to a payment call or cos record this attribute is useful for idempotency purposes ", "" "use this attribute to add your own unique identifying string to a payment call or cos record this attribute is useful for idempotency purposes " }, { "name" "flags", "kind" "optional", "type" "array", "description" "array of flags to indicate special information about this transaction see list of flags and their codes in the requests and response codes page", "" "array" } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "response" \[ { "name" "transactioninfo", "kind" "optional", "type" "object", "description" "", "children" \[ { "name" "id", "kind" "optional", "type" "string", "description" "transaction identifier for the current transaction this id is in guid format sample value “00000000 0000 0000 0000 000000000000” " }, { "name" "tracenumber", "kind" "optional", "type" "string", "description" "a unique alphanumeric identifier assigned to a transaction this has 17 characters and begins with the letter 't' \nnote a core transaction trace number is not the same as an ach payment trace number " }, { "name" "status", "kind" "optional", "type" "string", "description" "status of the transaction values allowed \n pending\n complete\n rejected\n review\n declined\n canceled\n processing\n" }, { "name" "transactionoperationinfo", "kind" "optional", "type" "object", "description" "information about the card used ", "children" \[ { "name" "transactiontype", "kind" "optional", "type" "string", "description" "either \n debit\n credit" }, { "name" "accounttype", "kind" "optional", "type" "string", "description" "options \n generalledger\n deposit\n creditcard\n storedvalue\n wallet\n unknown" }, { "name" "masteraccountnumber", "kind" "optional", "type" "string", "description" "deposit account number associated with the card" }, { "name" "subaccountnumber", "kind" "optional", "type" "string", "description" "" }, { "name" "partnerid", "kind" "optional", "type" "string", "description" "your id in the cross river system this id is in guid format " }, { "name" "productid", "kind" "optional", "type" "string", "description" "product id of the cardholder deposit account this id is in the guid format " }, { "name" "activityid", "kind" "optional", "type" "string", "description" "" }, { "name" "result", "kind" "optional", "type" "object", "description" "", "children" \[ { "name" "success", "kind" "optional", "type" "string", "description" "" }, { "name" "code", "kind" "optional", "type" "string", "description" "" }, { "name" "message", "kind" "optional", "type" "string", "description" "" } ] } ] }, { "name" "transactioncode", "kind" "optional", "type" "string", "description" "an identifier used to describe the type of transaction examples of values (non exhaustive) \n account transfer\n deposit\n adjustment" }, { "name" "amount", "kind" "optional", "type" "string", "description" "amount of the transaction in positive integral cents for example, write $1 00 as 100 " }, { "name" "currency", "kind" "optional", "type" "string", "description" "" }, { "name" "description", "kind" "optional", "type" "string", "description" "a description that will identify the transaction as it gets posted " }, { "name" "rail", "kind" "optional", "type" "string", "description" "one of the following \n ach\n wires\n creditcard\n debitcard\n storedvalue\n checks\n rtp\n cardmanagement\n international\n cardpayments\n teller\n internal" }, { "name" "railid", "kind" "optional", "type" "string", "description" "" }, { "name" "clientidentifier", "kind" "optional", "type" "string", "description" "use this attribute to add your own unique identifying string to a payment call or cos record this attribute is useful for idempotency purposes " }, { "name" "flags", "kind" "optional", "type" "string", "description" "array of flags to indicate special information about this transaction see list of flags and their codes in the requests and response codes page" }, { "name" "schedule", "kind" "optional", "type" "string", "description" "" }, { "name" "proposedat", "kind" "optional", "type" "string", "description" "the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" }, { "name" "executedat", "kind" "optional", "type" "string", "description" "the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" }, { "name" "canceledat", "kind" "optional", "type" "string", "description" "the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" }, { "name" "lastmodifiedat", "kind" "optional", "type" "string", "description" "date and time the card record was last modified examples include change of name on the card and change in card status in this case, the date and time are in this format yyyy mm ddthh\ mm\ ss\[ mmm]" } ] } ] }