Payments
...
Card APIs
Add card
1 min
this api call triggers fraud and risk detection and fraud and risk detection these are fraud and risk detection supported by cross river name endpoint api card method post url https pushtopaystaging crbnj net api card description signs up a new consumer payment card to the merchant s account when you call this endpoint the card payments api stores the card number and returns a token the api uses the token to identify the card in place of the actual card number tokens provide a security measure to help prevent criminals from accessing card numbers tab examples examples languages id gum54b2sobgw9b7c7jeu3 language curl code curl l https pushtopaystaging crbnj net api card n h content type application json n h authorization bearer eyjhbgcioijsuzi1niisimtpzci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncising1dci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3nteyodewnzisimlhdci6mtc1mti4mta3miwizxhwijoxnzuxmjg0njcylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6ijzgrdfeqtc0qtm3mjrfn0ffn0m4mtvertbfrdreqtvfin0 jjby62elxuapzpau5gzyz2m3mdxdwzdjn iblgkq sensecqydw4skhk3hkmjy dv9w6kpyastze7tchngpqommzsr51umsyeiduw3yzqmqwydn0mm0brtfle2rgaywkftbspyxqeffiiofwubf6ormozhh8utf43twvhpqylfp 3alkuwojurhj8hq 5jdfxif6eysariyqqyf1vgahfhsflti v2eni6hb6r kzvlacw2xhj rrswbfkchfro tl5daanlmifqlmln8w3ghnmmnsbxjf ba2jhzkrgklxuubzwek1jn8gipj1pjm3lvvgcqzo1bqq3elxil8zwpg n data raw n requestid f37a0d5a d62e 46e3 8c20 2842486b55c8 n cardtoken d116e6a82b704cdfa2942f9b16ed3a65000000 n firstname millie68 hotmail com n lastname nitzsche n ownerexternalid 411979997 n address1 1053 milo drives n address2 n city new myrltown n zipcode 08527 n state nj n countrycode us n phonenumber 779 388 5814 n email akeem lesch11 example net n creditcardnumber 5102 5899 9999 9905 n expirationyear 30 n expirationmonth 12 n cvv 909 n cardcompany mastercard n customlabel id q3 wsypdrvpzgma1tleef 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 card n headers n content type application json n authorization bearer eyjhbgcioijsuzi1niisimtpzci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncising1dci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3nteyodewnzisimlhdci6mtc1mti4mta3miwizxhwijoxnzuxmjg0njcylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6ijzgrdfeqtc0qtm3mjrfn0ffn0m4mtvertbfrdreqtvfin0 jjby62elxuapzpau5gzyz2m3mdxdwzdjn iblgkq sensecqydw4skhk3hkmjy dv9w6kpyastze7tchngpqommzsr51umsyeiduw3yzqmqwydn0mm0brtfle2rgaywkftbspyxqeffiiofwubf6ormozhh8utf43twvhpqylfp 3alkuwojurhj8hq 5jdfxif6eysariyqqyf1vgahfhsflti v2eni6hb6r kzvlacw2xhj rrswbfkchfro tl5daanlmifqlmln8w3ghnmmnsbxjf ba2jhzkrgklxuubzwek1jn8gipj1pjm3lvvgcqzo1bqq3elxil8zwpg 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 79a19066 2ff1 49ee ab17 7ece3c925aa1 n cardtoken d116e6a82b704cdfa2942f9b16ed3a65000000 n firstname millie68 hotmail com n lastname stamm n ownerexternalid 411979997 n address1 580 heller stream n address2 n city pierremouth n zipcode 08527 n state nj n countrycode us n phonenumber 733 734 9904 n email salvador romaguera99 example net n creditcardnumber 5102 5899 9999 9905 n expirationyear 30 n expirationmonth 12 n cvv 909 n cardcompany mastercard n ; n nreq write postdata ; n nreq end ; customlabel id psmxc3yqxfr0iewglxicr language python code import requests nimport json n nurl https pushtopaystaging crbnj net api card n npayload json dumps n requestid b8728a99 20b7 4632 ba6a 88b525a46778 n cardtoken d116e6a82b704cdfa2942f9b16ed3a65000000 n firstname millie68 hotmail com n lastname casper n ownerexternalid 411979997 n address1 899 hahn ville n address2 n city rowestad n zipcode 08527 n state nj n countrycode us n phonenumber 281 618 1864 n email lon green76 example com n creditcardnumber 5102 5899 9999 9905 n expirationyear 30 n expirationmonth 12 n cvv 909 n cardcompany mastercard n nheaders n content type application json n authorization bearer eyjhbgcioijsuzi1niisimtpzci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncising1dci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3nteyodewnzisimlhdci6mtc1mti4mta3miwizxhwijoxnzuxmjg0njcylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6ijzgrdfeqtc0qtm3mjrfn0ffn0m4mtvertbfrdreqtvfin0 jjby62elxuapzpau5gzyz2m3mdxdwzdjn iblgkq sensecqydw4skhk3hkmjy dv9w6kpyastze7tchngpqommzsr51umsyeiduw3yzqmqwydn0mm0brtfle2rgaywkftbspyxqeffiiofwubf6ormozhh8utf43twvhpqylfp 3alkuwojurhj8hq 5jdfxif6eysariyqqyf1vgahfhsflti v2eni6hb6r kzvlacw2xhj rrswbfkchfro tl5daanlmifqlmln8w3ghnmmnsbxjf ba2jhzkrgklxuubzwek1jn8gipj1pjm3lvvgcqzo1bqq3elxil8zwpg n n nresponse requests request post url headers headers data payload n nprint response text n customlabel id vzrb8m9bkl3nuvzum8535 language ruby code require uri nrequire json nrequire net http n nurl uri https pushtopaystaging crbnj net api card 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 eyjhbgcioijsuzi1niisimtpzci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncising1dci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3nteyodewnzisimlhdci6mtc1mti4mta3miwizxhwijoxnzuxmjg0njcylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6ijzgrdfeqtc0qtm3mjrfn0ffn0m4mtvertbfrdreqtvfin0 jjby62elxuapzpau5gzyz2m3mdxdwzdjn iblgkq sensecqydw4skhk3hkmjy dv9w6kpyastze7tchngpqommzsr51umsyeiduw3yzqmqwydn0mm0brtfle2rgaywkftbspyxqeffiiofwubf6ormozhh8utf43twvhpqylfp 3alkuwojurhj8hq 5jdfxif6eysariyqqyf1vgahfhsflti v2eni6hb6r kzvlacw2xhj rrswbfkchfro tl5daanlmifqlmln8w3ghnmmnsbxjf ba2jhzkrgklxuubzwek1jn8gipj1pjm3lvvgcqzo1bqq3elxil8zwpg nrequest body json dump n requestid 6871d966 2d3d 432f b02d 491f7321dfa8 n cardtoken d116e6a82b704cdfa2942f9b16ed3a65000000 n firstname millie68 hotmail com n lastname robel n ownerexternalid 411979997 n address1 864 wunsch station n address2 n city port aleneton n zipcode 08527 n state nj n countrycode us n phonenumber 730 572 6334 n email santiago hills91 example org n creditcardnumber 5102 5899 9999 9905 n expirationyear 30 n expirationmonth 12 n cvv 909 n cardcompany mastercard n n nresponse https request request nputs response read body n customlabel id 3k7pearh adzvznnmznn2 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 card n method post n n payload strings newreader n n requestid 8126336d 65bf 4c8e a60b 6de50a5af0a7 n n cardtoken d116e6a82b704cdfa2942f9b16ed3a65000000 n n firstname millie68 hotmail com n n lastname anderson n n ownerexternalid 411979997 n n address1 004 schuster ville n n address2 n n city dothan n n zipcode 08527 n n state nj n n countrycode us n n phonenumber 993 856 2324 n n email ardith cruickshank68 example com n n creditcardnumber 5102 5899 9999 9905 n n expirationyear 30 n n expirationmonth 12 n n cvv 909 n n cardcompany mastercard 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 eyjhbgcioijsuzi1niisimtpzci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncising1dci6ijdqrej4dgvldl9imxhprk9xeehvn19rrkdxncisinr5cci6ikpxvcj9 eyjpc3mioijodhrwczovl29hdxrodgvzdc5jcmjuai5uzxqilcjuymyioje3nteyodewnzisimlhdci6mtc1mti4mta3miwizxhwijoxnzuxmjg0njcylcjhdwqiolsiy3jiyxbpiiwiahr0chm6ly9vyxv0ahrlc3quy3jibmoubmv0l3jlc291cmnlcyjdlcjzy29wzsi6wyjjcmjhcgkixswiy2xpzw50x2lkijoiufrqrvjouk1tdgddbgllbnqilcjyb2xlijoic2vjuhrwzufwavn0z0v4dcisimp0asi6ijzgrdfeqtc0qtm3mjrfn0ffn0m4mtvertbfrdreqtvfin0 jjby62elxuapzpau5gzyz2m3mdxdwzdjn iblgkq sensecqydw4skhk3hkmjy dv9w6kpyastze7tchngpqommzsr51umsyeiduw3yzqmqwydn0mm0brtfle2rgaywkftbspyxqeffiiofwubf6ormozhh8utf43twvhpqylfp 3alkuwojurhj8hq 5jdfxif6eysariyqqyf1vgahfhsflti v2eni6hb6r kzvlacw2xhj rrswbfkchfro tl5daanlmifqlmln8w3ghnmmnsbxjf ba2jhzkrgklxuubzwek1jn8gipj1pjm3lvvgcqzo1bqq3elxil8zwpg 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 gum54b2sobgw9b7c7jeu3 results languages id mihyajysilugqie7xctpr language 200 customlabel code n version 1 0 0 0 n result n requestid c2deec7f 6230 42d8 8219 243d8c6209a1 n cardtoken 57193c2ghgdh98459e8dc0b26031d72dc4000000 n cardfingerprint npjneeghghf3ulcknd57mqfo582lcxhewi8ptbt7zum0nqgzhcqu7jccfy7ueiyg jszp kmwhqvc61xfcqlf q n firstname millie68 hotmail com n lastname roob n ownerexternalid 411979997 n address1 96371 giles view n address2 n city okunevaview n zipcode 08527 n isauthorizationsucceeded true n state nj n countrycode us n phonenumber 771 730 2219 n email torrey donnelly example com n expirationyear 30 n expirationmonth 12 n last4digits 9905 n cardcompany mastercard n isactive true n deactivatedat null n addedon 2025 06 30t11 16 44 880045z n authorizationjson r n requestid c2deec7f 6230 42d8 8219 243d8c6209a1 r n authorized true r n responsereceived true r n responsecode ok r n responsedescription ok r n timestamp 2025 06 30t11 16 44 880045z r n error null r n addressverified true r n rail mcsend r n cardtype debit r n isfastfundssupported true r n pushenabled true r n pullenabled true r n issuercountrycode us r n nameverificationused not supported r n nameverificationresult unknown r n producttype unknown r n n isfastfundssupported true n rail mcsend n pushenabled true n pullenabled true n issuercountrycode us n binnumber 510258 n producttype unknown n n issuccessfull true n issuccessful true n selectedlanguageid mihyajysilugqie7xctpr 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 firstname kind required type string description cardholder first name children name lastname kind required type string description cardholder last name children name sourcesenderid kind required type string description the guid that identifies the merchant partner children name ownerexternalid kind optional type string description a 4 digit code assigned by the merchant to identify the cardholder 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 countrycode kind optional type string description 2 letter country code children name state kind optional type string description 2 letter code of the cardholder s state 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 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 email kind optional type string description a valid cardholder email address for example me mailprovider com children name creditcardnumber kind required type string description the 15 or 16 digit number found on the front or back of a credit card children name expirationmonth kind required type string description card expiration month 2 digits numeric children name expirationyear kind required type string description card expiration year 2 digits numeric children name cvv kind required type string description the personal customer code on the card add the cvv to a function call only when you add a card post api card the api never returns the cvv when you perform a get or put call children formdataparameters currentnewparameter label body parameter value bodydataparameters response name requestid kind optional type string description the guid is a unique identifier that enables the application to link request with response name cardtoken kind optional type string description created when intially signing up a card a randomly generated string of characters that relates to the consumer s payment card 15 to 38 alphanumeric characters matches the creditcardtoken children name cardfingerprint kind optional type string description a unique identifier for this card derived from internal card information it can be used to detect multiple occurrences of attempts for the same card being authorized from multiple users children name firstname kind optional type string description cardholder first name children name lastname kind optional type string description cardholder last name children name ownerexternalid kind optional type string description a 4 digit code assigned by the merchant to identify the cardholder 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 children name address2 kind optional type string description secondary location details of cardholder for instance number of apartment or floor maximum 100 characters children name city kind optional type string description name of the cardholder s city 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 children name isauthorizationsucceeded kind optional type boolean description true if the card was authorized successfully otherwise false 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 phonenumber kind optional type string description optional at the start 7 15 characters made of digits spaces dashes brackets children name email kind optional type string description a valid cardholder email address for example me mailprovider com children name expirationyear kind optional type string description card expiration year 2 digits numeric children name expirationmonth kind optional type string description card expiration month 2 digits numeric children name last4digits kind optional type string description last 4 digits of the payment card number children name cardcompany kind optional type string description name of the payment card network n n visa n mastercard children name isactive kind optional type boolean description true if the card is active otherwise false children name deactivatedat kind optional type string description date and time card was deactivated if relevant in date time format children name addedon kind optional type string description the date and time the card was added to the merchant s account children name authorizationjson kind optional type object description the json authorization response received for this card from the card payments api the values returned are under the control of the card payment provider the information provided here is for reference children name requestid kind optional type string description the guid that enables the application to link request with response name authorized kind optional type boolean description determines whether a card is authorized for any financial activity by the cross river card network and issuing bank name responsereceived kind optional type boolean description true if p2c received a response from the external processor otherwise false name responsecode kind optional type string description a 2 digit code signifying the transaction result approved or decline for example 00 means successful name responsedescription kind optional type string description a string describing the transaction result for example approved name timestamp kind optional type string description the actual time the request was sent to the card networks name error kind optional type string description a code value returned if the network call fails name addressverified kind optional type boolean description the result of the check by the address verification service avs name rail kind optional type string description the processor that communicates with the card network n n mcsend n tabapay n visadirect name cardtype kind optional type string description the kind of payment card n n credit n debit n prepaid n combo n chargecard n deferreddebit name isfastfundssupported kind optional type boolean description fast funds are immediate payments true if fast funds is supported otherwise false name pushenabled kind optional type boolean description true if push payment to card is enabled otherwise false name pullenabled kind optional type boolean description true if pull payment from card is enabled otherwise false name issuercountrycode kind optional type string description a 2 letter code indicating the country where the card was issued name nameverificationused kind optional type string description indicates if cross river tried to contact the account name inquiry ani service n n used n not used n not supported n nif the merchant isn t configured for the ani service this response lets you know in that case contact your cross river relationship manager for information on connecting name nameverificationresult kind optional type string description this is the result of the account name inquiry ani service check n n match n partial match n no match n unknown name binnumber kind optional type string description the first 6 to 8 digits on the card this identification number indicates the card issuing bank children name producttype kind optional type string description cardholder card type n n consumer n commercial n government n business n unknown children