MÓDULOS
Tokenización de Tarjetas y Cuentas Bancarias - Wallet Transparent
8 min
este módulo permite la implementación de la funcionalidad de billetera virtual o wallet a través de api, permitiendo la tokenización de tarjetas y su posterior utilización para realizar cobros sin necesidad de que el cliente tenga que reingresar todos los datos de la tarjeta (a excepción del cvv o código de seguridad que siempre es requerido) administración de clientes tab request url https api mobbex com p wallet name creaci n de cliente method post request pathparameters queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso del comercio bodydataparameters kind required name reference type string description referencia interna nica que permite identificar a su cliente dentro de su aplicaci n y dentro de mobbex kind required name customer type object description objeto con los datos del cliente kind required name customer email type string description email del cliente kind required name customer name type string description nombre del cliente kind required name customer identification type string description dni o identificaci n del cliente kind optional name test type boolean description permite colocar al cliente en modo de pruebas y realizar operaciones con tarjetas de prueba kind optional name features type array description array de strings que permite configurar caracter sticas espec ficas para el cliente formdataparameters results languages id nrrbqaxkmnoxmrrva1ehn code n result true n data n uid seaw3sdtif5e3ofht n test true n customerdata n identification 12123123 n email demo mobbex com n name demo n n status active n id 60a408e3d7816c3dd4ca5f3de n reference my unique reference n entity 984660654629173000df9552 n created 2021 05 18t18 35 15 451z n updated 2021 05 18t18 35 15 459z n sources n v 0 n n language 200 id 68ka22mbqayyv 1dvgadz code n language 404 selectedlanguageid nrrbqaxkmnoxmrrva1ehn examples languages id h9gkaemshqm1qtzphdw2n code curl location request post https api mobbex com p wallet r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc r n header content type application json r n data raw r n reference my unique reference r n customer r n email demo mobbex com r n name cliente demo r n identification 12123123 r n r n test true r n language curl id dbxgojvczt3g3wsdttquz code language none selectedlanguageid h9gkaemshqm1qtzphdw2n description a partir de esta api se crean los clientes a los cuales luego se le asocian las diferentes tarjetas currentnewparameter label body parameter value bodydataparameters ejemplos del nodo features validate id validate id controlará el dni del cliente contra el tarjeta habiente, rechazando la operación en caso de no coincidir accept no funds accept no funds aceptará los casos donde la tarjeta no posea fondos como un caso válido de tokenización tab examples url https api mobbex com p wallet customeruid name consultar cliente method get request pathparameters kind required name customeruid type string description uid del cliente obtenido al crearlo queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso del comercio bodydataparameters formdataparameters results languages id vp eb2wm513sxo1t6r6p code n result true n data n id 60a40c08d7816c3dd4ca5f41 n uid seaw3sdtif5e3ofht n test true n customerdata n identification 12123123 n email demo mobbex com n name demo n n status active n reference my unique reference n entity n id 984660654629173000df9552 n name demo entity n uid h1rjexyr n description n logo n filename car jpg n url https s3 amazonaws com mobbex files images 34cfcef0 fd4c 42f5 8bce 0c6f57e68035 jpg n mimetype image jpeg n extension jpg n size 10490 n width 170 n height 170 n sizes n medium n small n square n n versions n https s3 amazonaws com mobbex files images 34cfcef0 fd4c 42f5 8bce 0c6f57e68035 medium jpg n https s3 amazonaws com mobbex files images 34cfcef0 fd4c 42f5 8bce 0c6f57e68035 small jpg n https s3 amazonaws com mobbex files images 34cfcef0 fd4c 42f5 8bce 0c6f57e68035 square jpg n n n tax id 99999999999 n countryreference arg n n created 2021 05 18t18 48 40 555z n updated 2021 05 18t18 48 40 557z n sources n n uid 7ig1f2kojf4ielrl5w n name visa d bito terminada en 0010 n cardnumber 450799 0010 n priority primary n n n v 0 n n language 200 id osequgniclyknzwt34i code n message ain t no cake like that n language 404 selectedlanguageid vp eb2wm513sxo1t6r6p examples languages id vzhdfazamvvdhypjtavto code curl location request get https api mobbex com p wallet seaw3sdtif5e3ofht r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc language curl id vfzodi1xwckqxozcqd65a code language none selectedlanguageid vzhdfazamvvdhypjtavto description permite consultar los datos de un cliente por currentnewparameter label header parameter value headerparameters tab examples url https api mobbex com p wallet customeruid action edit name editar cliente method post request pathparameters kind required name customeruid type string description uid del cliente obtenido al crearlo queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso del comercio bodydataparameters kind optional name reference type string description nueva referencia del cliente kind optional name customer type object description objeto con los nuevos datos del cliente kind required name customer email type string description nuevo email del cliente kind required name customer identification type string description nueva identificaci n del cliente kind required name customer name type string description nuevo nombre del cliente kind optional name test type boolean description permite cambiar el modo del cliente formdataparameters results languages id d0lwf6x3bxe56umqeur5w code n result true n data n language 200 id eldluwb fcmbgkfryzpxh code n message ain t no cake like that n language 404 selectedlanguageid d0lwf6x3bxe56umqeur5w examples languages id wkp1vp2hp3yndnvyesed2 code curl location request post https api mobbex com p wallet seaw3sdtif5e3ofht action edit r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc r n header content type application json r n data raw r n reference my new unique reference r n customer r n email demo mobbex com r n name cliente demo r n identification 12123123 r n r n test false r n language curl id 4sweqkjrffn6fxuzydg4 code var myheaders new headers ; nmyheaders append x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; nmyheaders append x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; nmyheaders append content type application json ; n nvar raw json stringify n reference my new unique reference n customer n email demo mobbex com n name cliente demo n identification 12123123 n n test false n ; n nvar requestoptions n method post n headers myheaders n body raw n redirect follow n ; n nfetch https api mobbex com p wallet seaw3sdtif5e3ofht action edit requestoptions n then response response text n then result console log result n catch error console log error error ; language javascript selectedlanguageid wkp1vp2hp3yndnvyesed2 description currentnewparameter label body parameter value bodydataparameters tab examples url https api mobbex com p wallet customeruid action delete name eliminar un cliente method delete request pathparameters kind required name customeruid type string description uid del cliente generado al crearlo queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso del comercio bodydataparameters formdataparameters results languages id vxzav4n huujfvb3yakz8 code n result true n data n language 200 id ikzxefhjti plu2vmqzhz code n message ain t no cake like that n language 404 selectedlanguageid vxzav4n huujfvb3yakz8 examples languages id adusqmteza5i tsu00idx code curl location request delete https api mobbex com p wallet seaw3sdtif5e3ofht action delete r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc language curl id yu18yzpdrfhkulfg v66z code language none selectedlanguageid adusqmteza5i tsu00idx description currentnewparameter label path parameter value pathparameters administración de medios de pago información importante para utilizar cualquiera de los métodos descriptos a continuación e ingresar los datos de los medios de pago a través de api, por favor contacta a operatoria\@mobbex com e indica los accesos que necesitas además, el sitio debe cumplir con una serie de requisitos, incluyendo las normas pci dss ingresar los datos vía api tab examples url https api mobbex com p sources token name generar token de medio de pago method post request pathparameters queryparameters headerparameters kind required name api key type string description clave p blica de la entidad bodydataparameters kind required name source type object description objeto con los datos del medio de pago a tokenizar children name card kind optional type object description objeto con los datos de la tarjeta children name number kind required type string description pan o n mero de la tarjeta name month kind required type string description mes de expiraci n de la tarjeta con formato xx name year kind required type string description a o de expiraci n de la tarjeta con formato yy name identification kind optional type string description n mero de documento del tarjetahabiente name name kind required type string description nombre del tarjetahabiente name securitycode kind optional type string description c digo de seguridad de la tarjeta a tokenizar valor opcional s lo requerido en el caso de activar la opci n de validar la tarjeta name bank kind optional type object description objeto de medio de pago de tipo cuenta bancaria o virtual children name cbu kind optional type string description cbu s lo argentina name cvu kind optional type string description cvu s lo argentina name alias kind optional type string description alias de cbu o cvu s lo argentina name identification kind optional type string description identificador del propietario de la cuenta kind optional name test type boolean description habilita el modo de pruebas esto permite tokenizar tarjetas de prueba para realizar operaciones en este modo kind optional name validate type boolean description activando esta opci n se realiza una operaci n de validaci n de la tarjeta como mecanismo para aceptar la misma como v lida formdataparameters results languages id o orawgydthqczlfg6xcr code n result true n data n token t y 50nd1cd n description visa d bito terminada en 0010 n source n references n visa debit n n reference visa debit n generic visa debit n compatreference visa debit n name visa d bito n shortname visa d bito n currency ars n card n level classic n product n name visa d bito n shortname visa d bit n variant debit n lengths n 16 n n gaps n 4 n 8 n 12 n n code n name cvv n length 3 n position 1 n n logo https res mobbex com images sources png visa png n validation n length n exp n cvv n luhn n n n issuer n shortname visa n name visa n color 122d98 n type unknown n logo https res mobbex com images sources png visa png n n n type card n priority 0 n n isvalid true n n language 200 id 0pydoenp abcay9skionj code n message ain t no cake like that n language 404 selectedlanguageid o orawgydthqczlfg6xcr examples languages id mkdncddinmywakbjbmbqc code curl location request post https api mobbex com p sources token n header api key 6icjn xjdkf51zs71234k506bprha nsvvws n header content type application json n data raw n source n card n number 4507990000000010 n month 12 n year 34 n identification 12123123 n name cliente demo n n n language curl id uavo ao sergugr ttc3x code var data json stringify r n source r n card r n number 4507990000000010 r n month 12 r n year 34 r n identification 12123123 r n name cliente demo r n r n r n ; r n r nvar xhr new xmlhttprequest ; r nxhr withcredentials true; r n r nxhr addeventlistener readystatechange function r n if this readystate 4 r n console log this responsetext ; r n r n ; r n r nxhr open post https api mobbex com p sources token ; r nxhr setrequestheader api key 6icjn xjdkf51zs71234k506bprha nsvvws ; r nxhr setrequestheader content type application json ; r n r nxhr send data ; language javascript selectedlanguageid mkdncddinmywakbjbmbqc description a trav s de esta api se podr crear el token del medio de pago necesario para agregarlo a la billetera currentnewparameter label body parameter value bodydataparameters medio de pago válido un medio de pago es válido al crear su token únicamente si la propiedad "isvalid" retornada en la respuesta es verdadera en caso contrario, el medio de pago no es válido tab request url https api mobbex com p wallet customeruid source name agregar medio de pago al cliente method post request pathparameters kind required name customeruid type string description uid del customer obtenido al crearlo queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso del comercio bodydataparameters kind required name token type string description id del token generado kind optional name priority type string description nivel de prioridad del token en la cuenta del cliente valores admitidos primary secondary none por defecto el primer medio es agregado con la prioridad primary el segundo con secondary y el resto con none formdataparameters results languages id hdmbhqybsiutisxtt53gv code n result true n data n status success n code 200 n text el m todo de pago se agreg exitosamente n sourceuid ybatg1w8so3sghmzt n operation n view result n options n id rj 4h4ohc n status n code 200 n text aprobado n message transacci n aprobada n n total 13 15 n currency n value test n label test money n symbol t n hidden false n n data n actions n n n language 200 id xqpvomroscjyjpntmf4di code n message ain t no cake like that n language 404 selectedlanguageid hdmbhqybsiutisxtt53gv examples languages id tkngzbw94hjjt3wz6j4 z code curl location request post https api mobbex com p wallet seaw3sdtif5e3ofht source r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc r n header content type application json r n data raw r n token t y 50nd1cd r n priority primary r n language curl id ufq4fiwznnfvsaw8jny5d code var data json stringify n token t y 50nd1cd n priority primary n ; n nvar xhr new xmlhttprequest ; nxhr withcredentials true; n nxhr addeventlistener readystatechange function n if this readystate 4 n console log this responsetext ; n n ; n nxhr open post https api mobbex com p wallet seaw3sdtif5e3ofht source ; nxhr setrequestheader x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; nxhr setrequestheader x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; nxhr setrequestheader content type application json ; n nxhr send data ; language javascript selectedlanguageid tkngzbw94hjjt3wz6j4 z description currentnewparameter label path parameter value pathparameters tab examples url https api mobbex com p wallet customeruid source sourceuid action edit name editar un medio de pago method post request pathparameters kind required name customeruid type string description uid del customer obtenido al crearlo kind required name sourceuid type string description uid del source a editar queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso al comercio bodydataparameters kind optional name priority type string description nivel de prioridad del token en la cuenta del cliente valores admitidos primary secondary none formdataparameters results languages id xirpgekvxkoktbsqxl309 code n result true n data n language 200 id roncto4ttjq82u0wa1dt code language 404 selectedlanguageid xirpgekvxkoktbsqxl309 examples languages id mvki dpwpz6tjooak2sxh code curl location request post https api mobbex com p wallet seaw3sdtif5e3ofht source ybatg1w8so3sghmzt action edit r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc r n header content type application json r n data raw r n priority secondary r n language curl id 2ol8vlqkm0kcs eb8ams4 code var data json stringify r n priority secondary r n ; r n r nvar xhr new xmlhttprequest ; r nxhr withcredentials true; r n r nxhr addeventlistener readystatechange function r n if this readystate 4 r n console log this responsetext ; r n r n ; r n r nxhr open post https api mobbex com p wallet seaw3sdtif5e3ofht source ybatg1w8so3sghmzt action edit ; r nxhr setrequestheader x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; r nxhr setrequestheader x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; r nxhr setrequestheader content type application json ; r n r nxhr send data ; language javascript selectedlanguageid mvki dpwpz6tjooak2sxh description currentnewparameter label path parameter value pathparameters tab examples url https api mobbex com p wallet customeruid source sourceuid action delete name eliminar medio de pago del cliente method delete request pathparameters kind required name customeruid type string description uid del cliente kind required name sourceuid type string description uid del medio de pago a eliminar queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso de la entidad bodydataparameters formdataparameters results languages id bcqkxn3jtzov6wjg9cip code n result true n data n language 200 id ipijms79r syri 1hewj code language 404 selectedlanguageid bcqkxn3jtzov6wjg9cip examples languages id 7lgb7uw8omurmcsr4dsfk code curl location request delete https api mobbex com p wallet seaw3sdtif5e3ofht source ybatg1w8so3sghmzt action delete r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc language curl id iwgx7xhhisrbaioculr z code var xhr new xmlhttprequest ; nxhr withcredentials true; n nxhr addeventlistener readystatechange function n if this readystate 4 n console log this responsetext ; n n ; n nxhr open delete https api mobbex com p wallet seaw3sdtif5e3ofht source ybatg1w8so3sghmzt action delete ; nxhr setrequestheader x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; nxhr setrequestheader x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; n nxhr send ; language javascript selectedlanguageid 7lgb7uw8omurmcsr4dsfk description currentnewparameter label path parameter value pathparameters procesamiento de operaciones a partir de un cliente y un medio de pago, podemos generar una operación utilizando la siguiente api tab examples url https api mobbex com p wallet customeruid payment name generar operaci n method post request pathparameters kind required name customeruid type string description uid del cliente de la billetera queryparameters headerparameters kind required name x api key type string description clave api de su aplicaci n kind required name x access token type string description token de acceso a la entidad bodydataparameters kind required name source type string description uid del medio de pago a utilizar del cliente si no es enviado se utilizar el medio de pago primario si existe kind required name reference type string description referencia de la operaci n este valor debe ser nico y no podr n existir 2 operaciones en estado aprobado con el mismo reference kind optional name test type boolean description permite realizar operaciones en modo de pruebas utilizando las tarjeta de prueba kind required name total type number description total de la operaci n formato xxx xx donde el punto es el separador de decimales kind optional name intent type string description tipo de operatoria de la operaci n ver documentaci n sobre operatoria en 2 pasos kind optional name split type array description array de objetos sobre los cuales se va a realizar el split si esta funcionalidad es requerida para m s informaci n ver documentaci n marketplace y split de pagos kind optional name description type string description descripci n de la operaci n a realizar kind optional name currency type string description moneda de la operaci n valores admitidos ars valor por defecto ars kind optional name installment type string description referencia del plan de cuotas con el cual se va a procesar la operaci n valor por defecto 1 kind optional name webhook type string description url a la cual ser informado el pago mediante webhooks post kind optional name securitycode type string description c digo de seguridad de la tarjeta s lo si la misma lo requiere formdataparameters results languages id pt0tzo03hg5v874ouptnk code n result true n data n result true n view n type card n n payment n id xrjzmlavi n description test payment n operation n type payment v2 n n status n code 200 n text aprobado n message transacci n aprobada n n total 100 n currency n code test n text test money n symbol t n n riskanalysis n band n a n level n a n n created 2021 05 18t18 58 51 882z n updated 2021 05 18t18 58 52 019z n reference 202105271429 n source n name visa d bito n type card n reference visa debit n number 450799 0010 n cardholder n name demo n identification 12123123 n n expiration n month 12 n year 34 n n installment n description 1 n amount 0 n count 1 n reference n n n n user n name demo n email demo mobbex com n n source n name visa d bito n type card n reference visa debit n n n language 200 id 1nnlrirtwqazn4xizpqom code language 404 selectedlanguageid pt0tzo03hg5v874ouptnk examples languages id jlboqw90trzz1xcepglxn code curl location request post https api mobbex com p wallet seaw3sdtif5e3ofht operation r n header x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij r n header x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc r n header content type application json r n data raw r n source ybatg1w8so3sghmzt r n total 100 50 r n reference 202105271429 r n webhook https mobbex com process webhook r n securitycode 200 r n test true r n r n language curl id aq5z0we3oaj1pgmbskdc1 code var data json stringify r n source ybatg1w8so3sghmzt r n total 100 5 r n reference 202105271429 r n webhook https mobbex com process webhook r n securitycode 200 r n test true r n ; r n r nvar xhr new xmlhttprequest ; r nxhr withcredentials true; r n r nxhr addeventlistener readystatechange function r n if this readystate 4 r n console log this responsetext ; r n r n ; r n r nxhr open post https api mobbex com p wallet seaw3sdtif5e3ofht operation ; r nxhr setrequestheader x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; r nxhr setrequestheader x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; r nxhr setrequestheader content type application json ; r n r nxhr send data ; language javascript selectedlanguageid jlboqw90trzz1xcepglxn description currentnewparameter label body parameter value bodydataparameters