Payments
...
Card APIs
Generate iFrame
1 min
for details on how to customize and embed an iframe into your merchant website, see iframes name endpoint api v2 iframeconfiguration generateotcsignupcard method post url https pushtopaystaging crbnj net api v2 iframeconfiguration generateotcsignupcard description returns the parameters you need to build an iframe web address url this endpoint generates the iframe code snippet dynamically it does this based on a merchant s specific template and card payments environment the otc is a one time code tab examples examples languages id xqvevvlutjpib30tfyx8k language curl code curl n x post n header content type application json n header accept application json n header authorization access token n d n domain https p2pcusto com n templateid 1bc3adff 59af 41c6 6218 08dc990404cd n https pushtopay crbcloud com api v2 iframeconfiguration generateotcsignupcard n customlabel id 8 0 ufo5mbo48qwcchral 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 v2 iframeconfiguration generateotcsignupcard 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 domain https myfintech com n templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb n ; n nreq write postdata ; n nreq end ; customlabel id gwj5c9hhu93urw df1sc5 language python code import http client nimport json n nconn http client httpsconnection pushtopaystaging crbnj net npayload json dumps n domain https myfintech com n templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb n nheaders n content type application json n authorization bearer token n nconn request post api v2 iframeconfiguration generateotcsignupcard payload headers nres conn getresponse ndata res read nprint data decode utf 8 customlabel id wrnp4xccop 00bcpksc3t language ruby code require uri nrequire json nrequire net http n nurl uri https pushtopaystaging crbnj net api v2 iframeconfiguration generateotcsignupcard 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 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntuwmdg2mjqsimlhdci6mtc1ntawodyyncwizxhwijoxnzu1mdeymji0lcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iji0rtc5q0ewmtu3mdczrtyyquu5mkyzm0rfodbcmdk5in0 fzdwutywomn9qmeug4h ntwduwpciilbu3vd9ww4bd73pc uigrx 4foehswcou06iq mwj3ybqsn5puerjwf8vbus7 2bsfw71gmftxxbl 9u ivohzchac8qaoygjntotzbe3nm14ih ijyvijrmjvn6q74c sh1ocxkpvpq4hx2bimdnmlvpuefrfmqbkgpg3ok34xa7hfbhb1rb8pbhrhqq9v9wcqdnmkb k3fjltx2r4xknap5aqdyu9ckddcogybakgqw3b9cqgzqkmqtk2hkrsdceqn52pv k cqzfzrcm1naok4tij3any8e6frpxx7mcqgfkjyfxbwaew nrequest body json dump n domain https myfintech com n templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb n n nresponse https request request nputs response read body n customlabel id a6efmdtjoxei5xjcnxczy 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 v2 iframeconfiguration generateotcsignupcard n method post n n payload strings newreader n n domain https myfintech com n n templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb 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 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3ntuwmdg2mjqsimlhdci6mtc1ntawodyyncwizxhwijoxnzu1mdeymji0lcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6iji0rtc5q0ewmtu3mdczrtyyquu5mkyzm0rfodbcmdk5in0 fzdwutywomn9qmeug4h ntwduwpciilbu3vd9ww4bd73pc uigrx 4foehswcou06iq mwj3ybqsn5puerjwf8vbus7 2bsfw71gmftxxbl 9u ivohzchac8qaoygjntotzbe3nm14ih ijyvijrmjvn6q74c sh1ocxkpvpq4hx2bimdnmlvpuefrfmqbkgpg3ok34xa7hfbhb1rb8pbhrhqq9v9wcqdnmkb k3fjltx2r4xknap5aqdyu9ckddcogybakgqw3b9cqgzqkmqtk2hkrsdceqn52pv k cqzfzrcm1naok4tij3any8e6frpxx7mcqgfkjyfxbwaew 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 xqvevvlutjpib30tfyx8k results languages id wekfhbkhwkthue5c1x3hu language 200 customlabel code n version 1 0 0 0 n result n templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb n domain https myfintech com n otcid c5f26745 17a0 4e08 8cf8 3b4c2a41d5b0 n expiresat 2025 08 12t10 39 09 283371 04 00 n createdat 2025 08 12t10 34 09 283371 04 00 n warning null n params createdat 2025 08 12t10 34 09 2833710z domain https myfintech com expiresat 2025 08 12t10 39 09 2833710z otcid c5f26745 17a0 4e08 8cf8 3b4c2a41d5b0 templateid 51d23abb b335 4f6d 46e1 08ddb2db74cb firstandlastnameprovided false n n issuccessfull true n issuccessful true n selectedlanguageid wekfhbkhwkthue5c1x3hu request pathparameters queryparameters headerparameters bodydataparameters name templateid kind required type string description the guid that identifies the template 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 firstname kind optional type string description if provided the firstname will be populated internally and the iframe will not present a firstname field for completion by the user nif you provide a firstname you must provide a lastname nminimum 2 characters maximum 35 characters if provided the firstname will be populated internally and the iframe will not present a firstname field for completion by the user nif you provide a firstname you must provide a lastname nminimum 2 characters maximum 35 characters name lastname kind optional type string description if provided the lastname will be populated internally and the iframe will not present a lastname field for completion by the user nif you provide a lastname you must provide a firstname nminimum 2 characters maximum 35 characters if provided the lastname will be populated internally and the iframe will not present a lastname field for completion by the user nif you provide a lastname you must provide a firstname nminimum 2 characters maximum 35 characters formdataparameters currentnewparameter label body parameter value bodydataparameters response name result kind optional type object description result of attempt to add an iframe children name templateid kind optional type string description the guid that identifies the template name domain kind optional 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 name otcid kind optional type string description single use passcode so you can use our api name expiresat kind optional type string description time the otcid expires name createdat kind optional type string description cardholder phone number must be ten digits with no spaces name warning kind optional type string description this field is null unless there is a potential issue with the signup process name params kind optional type string description the pre built query params you need to build the iframe source name issuccessfull kind optional type string description true if a unique url was built successfully otherwise false children name issuccessful kind optional type string description true if a unique url was built successfully otherwise false children