Setup iFrame

relevant webhooks be sure you card payments webhooks for webhooks api reference important this function will be deprecated see the iframes of generating iframe code makes an iframe display on your merchant website once the iframe is added, you can enter payee card information directly into the iframe { "name" "endpoint /api/iframeconfiguration/buildsignupcardurl", "method" "post", "url" "https //pushtopaystaging crbnj net/api/iframeconfiguration/buildsignupcardurl", "description" "", "tab" "examples", "examples" { "languages" \[ { "id" "ev4oyv43wzv3by3ujmtbx", "language" "curl", "code" "curl location 'https //pushtopaystaging crbnj net/api/iframeconfiguration/buildsignupcardurl' \\\\\n header 'content type application/json' \\\\\n header 'authorization bearer token' \\\\\n data raw '{\n \\"requestid\\" \\"a2996348 159d 4c53 89e2 2ee89ce71e7c\\",\n \\"customerreferencenumber\\" \\"4457\\",\n \\"domain\\" \\"https //myfintech com\\",\n \\"successcontinuenavigationpoint\\" \\"string\\",\n \\"failurecontinuenavigationpoint\\" \\"string\\",\n \\"sourcesenderid\\" \\"37c62197 a158 4110 a013 b305008b2d43\\",\n \\"firstname\\" \\"first\\",\n \\"lastname\\" \\"last\\",\n \\"address1\\" \\"101 main street\\",\n \\"address2\\" \\"apartment 13\\",\n \\"city\\" \\"big town\\",\n \\"state\\" \\"ny\\",\n \\"countrycode\\" \\"usa\\",\n \\"zipcode\\" \\"100001\\",\n \\"email\\" \\"first last\@myemail com\\",\n \\"phonenumber\\" \\"string\\",\n \\"showoptionalfields\\" true\n}'", "customlabel" "" }, { "id" "zbcwadhxx4bkvivsui1kf", "language" "nodejs", "code" "var https = require('follow redirects') https;\nvar fs = require('fs');\n\nvar options = {\n 'method' 'post',\n 'hostname' 'pushtopaystaging crbnj net',\n 'path' '/api/iframeconfiguration/buildsignupcardurl',\n 'headers' {\n 'content type' 'application/json',\n 'authorization' 'bearer eyjhbgcioijsuzi1niisimtpzci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyising1dci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntq5otu4ndisimlhdci6mtc1ndk5ntg0miwizxhwijoxnzu0otk5ndqylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iku3mda2q0i5ruizrtczrjdbmdq0ndaxmzi2mdbbntg5in0 m4zfwraoyegudapirrd6bafcblci8lvkztwtbug8oom nnvw dxxvyyn6npg91vq0vvtqdpd1xxvxxoslg5jihufxrlno2kwwbgrviiuxxb0pmni9ghwuzx6 8fhegwyryukpo2xj1ah7oj9dsqkbjytxll0b5yyin80peezk6 kx0vxp8bwvhnen6c4ddljzbqqz7xwm4hwmf9 k2zblffwmxuxqupqeiotobtdephkf 1jdr9toeq9llvvzlrmfqc295b87djyk1ehdgmhv81esbzezdlcvk8w v03q2defwmxfhlktm64zwq4etlglgmmil6ijydzk2 gknyvw'\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 \\"requestid\\" \\"a2996348 159d 4c53 89e2 2ee89ce71e7c\\",\n \\"customerreferencenumber\\" \\"4457\\",\n \\"domain\\" \\"https //myfintech com\\",\n \\"successcontinuenavigationpoint\\" \\"string\\",\n \\"failurecontinuenavigationpoint\\" \\"string\\",\n \\"sourcesenderid\\" \\"37c62197 a158 4110 a013 b305008b2d43\\",\n \\"firstname\\" \\"first\\",\n \\"lastname\\" \\"last\\",\n \\"address1\\" \\"101 main street\\",\n \\"address2\\" \\"apartment 13\\",\n \\"city\\" \\"big town\\",\n \\"state\\" \\"ny\\",\n \\"countrycode\\" \\"usa\\",\n \\"zipcode\\" \\"100001\\",\n \\"email\\" \\"first last\@myemail com\\",\n \\"phonenumber\\" \\"string\\",\n \\"showoptionalfields\\" true\n});\n\nreq write(postdata);\n\nreq end();", "customlabel" "" }, { "id" "djgf3aaammoceb5nioa8m", "language" "python", "code" "import requests\nimport json\n\nurl = \\"https //pushtopaystaging crbnj net/api/iframeconfiguration/buildsignupcardurl\\"\n\npayload = json dumps({\n \\"requestid\\" \\"a2996348 159d 4c53 89e2 2ee89ce71e7c\\",\n \\"customerreferencenumber\\" \\"4457\\",\n \\"domain\\" \\"https //myfintech com\\",\n \\"successcontinuenavigationpoint\\" \\"string\\",\n \\"failurecontinuenavigationpoint\\" \\"string\\",\n \\"sourcesenderid\\" \\"37c62197 a158 4110 a013 b305008b2d43\\",\n \\"firstname\\" \\"first\\",\n \\"lastname\\" \\"last\\",\n \\"address1\\" \\"101 main street\\",\n \\"address2\\" \\"apartment 13\\",\n \\"city\\" \\"big town\\",\n \\"state\\" \\"ny\\",\n \\"countrycode\\" \\"usa\\",\n \\"zipcode\\" \\"100001\\",\n \\"email\\" \\"first last\@myemail com\\",\n \\"phonenumber\\" \\"string\\",\n \\"showoptionalfields\\" true\n})\nheaders = {\n 'content type' 'application/json',\n 'authorization' 'bearer eyjhbgcioijsuzi1niisimtpzci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyising1dci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntq5otu4ndisimlhdci6mtc1ndk5ntg0miwizxhwijoxnzu0otk5ndqylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iku3mda2q0i5ruizrtczrjdbmdq0ndaxmzi2mdbbntg5in0 m4zfwraoyegudapirrd6bafcblci8lvkztwtbug8oom nnvw dxxvyyn6npg91vq0vvtqdpd1xxvxxoslg5jihufxrlno2kwwbgrviiuxxb0pmni9ghwuzx6 8fhegwyryukpo2xj1ah7oj9dsqkbjytxll0b5yyin80peezk6 kx0vxp8bwvhnen6c4ddljzbqqz7xwm4hwmf9 k2zblffwmxuxqupqeiotobtdephkf 1jdr9toeq9llvvzlrmfqc295b87djyk1ehdgmhv81esbzezdlcvk8w v03q2defwmxfhlktm64zwq4etlglgmmil6ijydzk2 gknyvw'\n}\n\nresponse = requests request(\\"post\\", url, headers=headers, data=payload)\n\nprint(response text)\n", "customlabel" "" }, { "id" " iugg83t2bj4shjpjkqr", "language" "ruby", "code" "require \\"uri\\"\nrequire \\"json\\"\nrequire \\"net/http\"\n\nurl = uri(\\"https //pushtopaystaging crbnj net/api/iframeconfiguration/buildsignupcardurl\\")\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 eyjhbgcioijsuzi1niisimtpzci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyising1dci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntq5otu4ndisimlhdci6mtc1ndk5ntg0miwizxhwijoxnzu0otk5ndqylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iku3mda2q0i5ruizrtczrjdbmdq0ndaxmzi2mdbbntg5in0 m4zfwraoyegudapirrd6bafcblci8lvkztwtbug8oom nnvw dxxvyyn6npg91vq0vvtqdpd1xxvxxoslg5jihufxrlno2kwwbgrviiuxxb0pmni9ghwuzx6 8fhegwyryukpo2xj1ah7oj9dsqkbjytxll0b5yyin80peezk6 kx0vxp8bwvhnen6c4ddljzbqqz7xwm4hwmf9 k2zblffwmxuxqupqeiotobtdephkf 1jdr9toeq9llvvzlrmfqc295b87djyk1ehdgmhv81esbzezdlcvk8w v03q2defwmxfhlktm64zwq4etlglgmmil6ijydzk2 gknyvw\\"\nrequest body = json dump({\n \\"requestid\\" \\"a2996348 159d 4c53 89e2 2ee89ce71e7c\\",\n \\"customerreferencenumber\\" \\"4457\\",\n \\"domain\\" \\"https //myfintech com\\",\n \\"successcontinuenavigationpoint\\" \\"string\\",\n \\"failurecontinuenavigationpoint\\" \\"string\\",\n \\"sourcesenderid\\" \\"37c62197 a158 4110 a013 b305008b2d43\\",\n \\"firstname\\" \\"first\\",\n \\"lastname\\" \\"last\\",\n \\"address1\\" \\"101 main street\\",\n \\"address2\\" \\"apartment 13\\",\n \\"city\\" \\"big town\\",\n \\"state\\" \\"ny\\",\n \\"countrycode\\" \\"usa\\",\n \\"zipcode\\" \\"100001\\",\n \\"email\\" \\"first last\@myemail com\\",\n \\"phonenumber\\" \\"string\\",\n \\"showoptionalfields\\" true\n})\n\nresponse = https request(request)\nputs response read body\n", "customlabel" "" }, { "id" "tiey9uk vjrm0aifynrdt", "language" "go", "code" "package main\n\nimport (\n \\"fmt\\"\n \\"strings\\"\n \\"net/http\"\n \\"io\\"\n)\n\nfunc main() {\n\n url = \\"https //pushtopaystaging crbnj net/api/iframeconfiguration/buildsignupcardurl\\"\n method = \\"post\\"\n\n payload = strings newreader(`{`+\\"\n\\"+`\n \\"requestid\\" \\"a2996348 159d 4c53 89e2 2ee89ce71e7c\\",`+\\"\n\\"+`\n \\"customerreferencenumber\\" \\"4457\\",`+\\"\n\\"+`\n \\"domain\\" \\"https //myfintech com\\",`+\\"\n\\"+`\n \\"successcontinuenavigationpoint\\" \\"string\\",`+\\"\n\\"+`\n \\"failurecontinuenavigationpoint\\" \\"string\\",`+\\"\n\\"+`\n \\"sourcesenderid\\" \\"37c62197 a158 4110 a013 b305008b2d43\\",`+\\"\n\\"+`\n \\"firstname\\" \\"first\\",`+\\"\n\\"+`\n \\"lastname\\" \\"last\\",`+\\"\n\\"+`\n \\"address1\\" \\"101 main street\\",`+\\"\n\\"+`\n \\"address2\\" \\"apartment 13\\",`+\\"\n\\"+`\n \\"city\\" \\"big town\\",`+\\"\n\\"+`\n \\"state\\" \\"ny\\",`+\\"\n\\"+`\n \\"countrycode\\" \\"usa\\",`+\\"\n\\"+`\n \\"zipcode\\" \\"100001\\",`+\\"\n\\"+`\n \\"email\\" \\"first last\@myemail com\\",`+\\"\n\\"+`\n \\"phonenumber\\" \\"string\\",`+\\"\n\\"+`\n \\"showoptionalfields\\" true`+\\"\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 eyjhbgcioijsuzi1niisimtpzci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyising1dci6ijdpsgdmzmezcnbpns1grxpsyk0zodzfrlk5cyisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntq5otu4ndisimlhdci6mtc1ndk5ntg0miwizxhwijoxnzu0otk5ndqylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iku3mda2q0i5ruizrtczrjdbmdq0ndaxmzi2mdbbntg5in0 m4zfwraoyegudapirrd6bafcblci8lvkztwtbug8oom nnvw dxxvyyn6npg91vq0vvtqdpd1xxvxxoslg5jihufxrlno2kwwbgrviiuxxb0pmni9ghwuzx6 8fhegwyryukpo2xj1ah7oj9dsqkbjytxll0b5yyin80peezk6 kx0vxp8bwvhnen6c4ddljzbqqz7xwm4hwmf9 k2zblffwmxuxqupqeiotobtdephkf 1jdr9toeq9llvvzlrmfqc295b87djyk1ehdgmhv81esbzezdlcvk8w v03q2defwmxfhlktm64zwq4etlglgmmil6ijydzk2 gknyvw\\")\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" "ev4oyv43wzv3by3ujmtbx" }, "results" { "languages" \[ { "id" "ucgo5sev adzgt54dsgv0", "language" "200", "customlabel" "", "code" "{\n \\"version\\" \\"1 0 0 0\\",\n \\"result\\" \\"https //pushtopayiframestg crbcos com/post cards/?t=96e9f2d0 b5e6 4d69 81a3 925f09e6341f\&e=300\&d=https%3a%2f%2fmyfintech com\&a=iframe%2fsignupcard\&r=a2996348 159d 4c53 89e2 2ee89ce71e7c\&o=1\&c=4457\&s=string\&f=string\&sm=37c62197 a158 4110 a013 b305008b2d43\&fn=first\&ln=last\&a1=101+main+street\&a2=apartment+13\&cy=big+town\&st=ny\&cc=usa\&zp=100001\&em=first last%40myemail com\&ph=string\\",\n \\"issuccessfull\\" true,\n \\"issuccessful\\" true\n}" }, { "id" "duybbgsyrxkilwv02ytih", "language" "400", "code" "{\n \\"version\\" \\"1 0 0 0\\",\n \\"result\\" {\n \\"errors\\" \[\n {\n \\"code\\" 2000,\n \\"message\\" \\"domain https //myfintech com did not match submerchantdomains for submerchant 37c62197 a158 4110 a013 b305008b2d43 \\"\n }\n ]\n },\n \\"issuccessfull\\" false,\n \\"issuccessful\\" false\n}", "customlabel" "" } ], "selectedlanguageid" "duybbgsyrxkilwv02ytih" }, "request" { "pathparameters" \[], "queryparameters" \[], "headerparameters" \[], "bodydataparameters" \[ { "name" "requestid", "kind" "required", "type" "string", "description" "the guid is a unique identifier that enables the application to link request with response", "" "the guid is a unique identifier that enables the application to link request with response" }, { "name" "customerreferencenumber", "kind" "required", "type" "string", "description" "4 digit code the merchant assigns", "children" \[] }, { "name" "domain", "kind" "required", "type" "string", "description" "the name of a valid top level internet domain where consumers will use the iframe for example, myfintech com this domain must appear in the cross river allowlist ", "children" \[] }, { "name" "successcontinuenavigationpoint", "kind" "optional", "type" "string", "description" "the landing page you are directed to if the sign up was successful", "children" \[] }, { "name" "failurecontinuenavigationpoint", "kind" "optional", "type" "string", "description" "the landing page you are directed if the sign up wasn't succeessful", "children" \[] }, { "name" "sourcesenderid", "kind" "optional", "type" "string", "description" "the guid that identifies the merchant partner", "children" \[] }, { "name" "firstname", "kind" "optional", "type" "string", "description" "cardholder first name", "children" \[] }, { "name" "lastname", "kind" "optional", "type" "string", "description" "cardholder last name", "children" \[] }, { "name" "address1", "kind" "optional", "type" "string", "description" "primary location details of cardholder for instance, street name, house or building number, and po box maximum 100 characters ", "" "primary location details of cardholder for instance, street name, house or building number, and po box maximum 100 characters " }, { "name" "address2", "kind" "optional", "type" "string", "description" "secondary location details of cardholder for instance, number of apartment or floor maximum 100 characters ", "" "secondary location details of cardholder for instance, number of apartment or floor maximum 100 characters " }, { "name" "city", "kind" "optional", "type" "string", "description" "name of the cardholder's city", "children" \[] }, { "name" "state", "kind" "optional", "type" "string", "description" "2 letter code of the cardholder's state", "children" \[] }, { "name" "countrycode", "kind" "optional", "type" "string", "description" "2 letter country code", "children" \[] }, { "name" "zipcode", "kind" "optional", "type" "string", "description" " us 5 digits, a zip+4 code with optional space or dash separator (12345, 12345 6789, 12345 6789, 123456789) \n canada a valid canadian zip code\n other up to 9 chars , letters, numbers, spaces, dashes do not contain double spaces or dashes", "" " us 5 digits, a zip+4 code with optional space or dash separator (12345, 12345 6789, 12345 6789, 123456789) \n canada a valid canadian zip code\n other up to 9 chars , letters, numbers, spaces, dashes do not contain double spaces or dashes" }, { "name" "email", "kind" "optional", "type" "string", "description" "a valid cardholder email address, for example, me\@mailprovider com", "children" \[] }, { "name" "phonenumber", "kind" "optional", "type" "string", "description" "optional + at the start, 7 15 characters made of digits, spaces, dashes, brackets", "" "optional + at the start, 7 15 characters made of digits, spaces, dashes, brackets" }, { "name" "showoptionalfields", "kind" "optional", "type" "boolean", "description" "true if optional fields will appear in the iframe, otherwise false", "children" \[] } ], "formdataparameters" \[] }, "currentnewparameter" { "label" "body parameter", "value" "bodydataparameters" }, "response" \[ { "name" "result", "kind" "optional", "type" "string", "description" "result of attempt to add an iframe \n\n success\n authorization failed" }, { "name" "message", "kind" "optional", "type" "string", "description" "the message returned by the api call ", "children" \[] }, { "name" "issuccessful", "kind" "optional", "type" "string", "description" "true if a unique url was built successfully, otherwise false", "children" \[] } ] }