Ejecuciones

monto de la operación formato xxx xx donde el punto es el separador decimal tab request url https api unicobros com ar p subscriptions id subscriber sid execution name ejecutar suscripci n manualmente method get request pathparameters queryparameters kind required name id type string description id de la suscripci n kind required name sid type string description id del suscriptor 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 para la cual desea realizar la operaci n bodydataparameters formdataparameters results languages id iq2v iudlgbmx99oahiam code n result true n data n language 200 selectedlanguageid iq2v iudlgbmx99oahiam examples languages id 5gqymwmocjofgm4cgyapv 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 get https api unicobros com ar p subscriptions t691pomk62sgc7chak subscriber y7b3p541b9vfbythsz execution ; nxhr setrequestheader x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij ; nxhr setrequestheader x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc ; n nxhr send ; language javascript id n4ob5lxq904w3tqqnu 00 code var request require request ; nvar options n method get n url https api unicobros com ar p subscriptions t691pomk62sgc7chak subscriber y7b3p541b9vfbythsz execution n headers n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n n ; nrequest options function error response n if error throw new error error ; n console log response body ; n ; n language nodejs id oh0f1wjc i9udczrbp1dk code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https api unicobros com ar p subscriptions t691pomk62sgc7chak subscriber y7b3p541b9vfbythsz execution n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest get n curlopt httpheader array n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n n ; n n response curl exec curl ; n ncurl close curl ; necho response; n language php selectedlanguageid oh0f1wjc i9udczrbp1dk description currentnewparameter label header parameter value headerparameters tab request url https api unicobros com ar p subscriptions id subscriber sid execution name ejecutar suscripci n manualmente con monto diferenciado method post request pathparameters queryparameters kind required name id type string description id de la suscripci n kind required name sid type string description id del suscriptor 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 para la cual desea realizar la operaci n bodydataparameters kind optional name total type number description total a cobrar al suscriptor si no se envia se cobrar el monto asignado al suscriptor monto personalizado por suscriptor o el monto de la suscripci n formato xxx xx donde el punto es el separador decimal kind optional name reference type string description referencia del cobro a ejecutar esta referencia deber ser nica optional kind optional name test type boolean description activa el modo de pruebas para la ejecuci n name source kind optional type string description siempre que el suscriptor tenga adherida una tarjeta alternativa se podr seleccionar sobre que tarjeta generar el cobro manual nvalores admitidos primary secondary children name description kind optional type string description permite definir una descripci n para el cobro a realizar el cual ser visualizado en el listado de operaciones permite definir una descripci n para el cobro a realizar el cual ser visualizado en el listado de operaciones name softdescriptor kind optional type string description permite definir una descripci n para el cobros visible por el tarjeta habiente en su resumen dependiente de su banco emisor utilice este campo solo en casos requeridos longitud m xima 25 caracteres permite definir una descripci n para el cobros visible por el tarjeta habiente en su resumen dependiente de su banco emisor utilice este campo solo en casos requeridos longitud m xima 25 caracteres formdataparameters results languages id dafgxomazln9dzswtdqg code n result true n data n language 200 selectedlanguageid dafgxomazln9dzswtdqg examples languages id si p sped0rm525qaf5qf code var data json stringify total 150 reference 230320211305 description cobro con una descripci n diferente ; 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 unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 subscriber y7b3p541b9vfbythsz execution ; 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 id ndz9siq7956ov3dwklocs code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https api unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 subscriber y7b3p541b9vfbythsz execution n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest post n curlopt postfields n total 150 n reference 230320211305 n description cobro con una descripci n diferente n n curlopt httpheader array n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n content type application json n n ; n n response curl exec curl ; n ncurl close curl ; necho response; n language php selectedlanguageid ndz9siq7956ov3dwklocs description el monto con el que se ejecuta la suscripci n puede ser diferente al definido en la suscripci n o el suscriptor currentnewparameter label body parameter value bodydataparameters tab examples url https api unicobros com ar p subscriptions id action execute name ejecutar cobros manuales masivamente method post request pathparameters queryparameters kind required name id type string description id de la suscripci n 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 para la cual desea realizar la operaci n bodydataparameters kind required name type array description el body es un array de objetos de tipo json kind required name type object description objeto con los datos del suscriptor a cobrar kind required name sid type string description identificador del suscriptor kind optional name total type number description monto de la operaci n formato xxx xx donde el punto es el separador decimal kind required name reference type string description referencia que identifique el cobro al suscriptor kind optional name description type string description permite personalizar la descripci n del cobro kind optional name test type boolean description marca la ejecuci n como prueba valores aceptados true false defecto false name source kind optional type string description siempre que el suscriptor tenga adherida una tarjeta alternativa se podr seleccionar sobre que tarjeta generar el cobro manual nvalores admitidos primary secondary children formdataparameters results languages id 17kymh4jcikmtarqr35fp code n result true n language 200 selectedlanguageid 17kymh4jcikmtarqr35fp examples languages id yktet8xla1jyhzudce5ar code var data json stringify n sid y7b3p541b9vfbythsz total 10 reference 230320211348 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 unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 action execute ; 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 id zn3ynwnugj 4valv7luyp code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https api unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 action execute n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest post n curlopt postfields n n sid y7b3p541b9vfbythsz n total 10 n reference 230320211348 n n n curlopt httpheader array n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n content type application json n n ; n n response curl exec curl ; n ncurl close curl ; necho response; language php selectedlanguageid zn3ynwnugj 4valv7luyp description permite ejecutar cobros masivos dentro de una misma suscripci n tenga en cuenta que esta api solamente retornar que el proceso fue aceptado exitosamente la ejecuci n se realizar de fondo y se notificar via webhooks currentnewparameter label body parameter value bodydataparameters tab examples url https api unicobros com ar p subscriptions id subscriber sid action schedule name programar una ejecuci n a futuro method post request pathparameters queryparameters kind required name id type string description id de la suscripci n kind required name sid type string description id del suscriptor 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 para la cual desea realizar la operaci n bodydataparameters kind required name date type object description objecto con la fecha de ejecuci n futura la fecha definida debe ser al menos 4 d as posterior a la fecha actual kind required name date day type integer description d a a agendar kind required name date month type integer description mes a agendar kind required name date year type integer description a o a agendar kind optional name total type number description total espec fico a cobrar al suscriptor si no se env a se cobrar el monto asignado al suscriptor monto personalizado por suscriptor o el monto de la suscripci n formdataparameters results languages id fvzcy5iup28bmg4x9dtxt code n result n language 200 selectedlanguageid fvzcy5iup28bmg4x9dtxt examples languages id khp6my7wa ttn vx1g5 t code var data json stringify n date n day 10 n month 4 n year 2021 n 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 unicobros com ar p subscriptions u5485jkgty subscriber 5sfty4iplt action schedule ; 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 id 3vnq9bi0ofselznrxagj2 code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https api unicobros com ar p subscriptions u5485jkgty subscriber 5sfty4iplt action schedule n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest post n curlopt postfields n date n day 10 n month 4 n year 2021 n n n curlopt httpheader array n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n content type application json n n ; n n response curl exec curl ; n ncurl close curl ; necho response; n language php selectedlanguageid 3vnq9bi0ofselznrxagj2 description currentnewparameter label body parameter value bodydataparameters acciones sobre una ejecución tab request url https api unicobros com ar p subscriptions id subscriber sid execution eid action retry name reintentar una ejecuci n method get request pathparameters queryparameters kind required name id type string description id de la suscripci n kind required name sid type string description id del suscriptor kind required name eid type string description id de la ejecuci n a reintentar 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 para la cual desea realizar la operaci n bodydataparameters formdataparameters results languages id phqyop37hchyau8 xmtm9 code n result true n language 200 selectedlanguageid phqyop37hchyau8 xmtm9 examples languages id waajatkbb4gnabyvfncyi code var data json stringify date day 28 month 5 year 2021 ; 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 unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 subscriber y7b3p541b9vfbythsz execution js73p5hg8avfbyt45z action retry ; 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 id 9a t xqxj1izkivi3ka9a code ?php n n curl curl init ; n ncurl setopt array curl array n curlopt url https api unicobros com ar p subscriptions r89blvmzrpdh3gmrh9 subscriber y7b3p541b9vfbythsz execution js73p5hg8avfbyt45z action retry n curlopt returntransfer true n curlopt encoding n curlopt maxredirs 10 n curlopt timeout 0 n curlopt followlocation true n curlopt http version curl http version 1 1 n curlopt customrequest post n curlopt postfields n date n day 28 n month 5 n year 2021 n n n curlopt httpheader array n x api key zj8lftbx6ba8d611e9io13fdzawj0qmko1hn1yij n x access token d31f0721 2f85 44e7 bcc6 15e19d1a53cc n content type application json n n ; n n response curl exec curl ; n ncurl close curl ; necho response; language php selectedlanguageid 9a t xqxj1izkivi3ka9a description currentnewparameter label header parameter value headerparameters tab request url https api unicobros com ar p subscriptions id subscriber sid execution eid action paid name marcar una ejecuci n como paga method get request pathparameters queryparameters kind required name id type string description id de la suscripci n kind required name sid type string description id del suscriptor kind required name eid type string description id de la ejecuci n a marcar como paga 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 para la cual desea realizar la operaci n bodydataparameters formdataparameters results languages id pnmgz1x4godisv5d9domf code n result true n language 200 id 4g6g6yosyt9oz b jnml code n message ain t no cake like that n language 404 selectedlanguageid pnmgz1x4godisv5d9domf examples languages id hmlcrlcl6g1rbbajei52t code fetch https api cakes com n method get n headers n accept application json n n n then response n console log response ; n n catch err n console error err ; n ; language javascript selectedlanguageid hmlcrlcl6g1rbbajei52t description currentnewparameter label query parameter value queryparameters webhooks los webhooks siempre serán enviados en formato application/x www form urlencoded nueva suscripción { "type" "subscription\ registration", "data" { "result" true, "view" { "type" "card" }, "payment" { "id" "ababbb78798", "description" "esto es un registro!", "operation" { "type" "validation" }, "status" { "code" "200", "text" "aprobado", "message" "transacción aprobada" }, "total" 14 3, "currency" { "code" "ars", "text" "peso argentino", "symbol" "$" }, "riskanalysis" { "band" "n/a", "level" "n/a" }, "created" "2020 12 02t18 12 11 122z", "updated" "2020 12 02t18 12 12 768z", "reference" "extenal reference", "source" { "name" "visa débito", "type" "card", "reference" "visa debit", "number" "4515 00 1234", "expiration" { "month" "01", "year" "26" }, "installment" { "description" "débito", "amount" 14 3, "count" 1, "reference" "1" } } }, "entity" { "name" "demo entity", "uid" "demo entity" }, "customer" { "uid" "12123123", "name" "juan perez wayne", "phone" "12123123", "identification" "110303456", "email" "soybatman\@wayneinc com" }, "user" { "name" "juan perez wayne", "email" "juan perez\@mimail com" }, "source" { "name" "visa débito", "type" "card", "reference" "visa debit" }, "subscription" { "uid" "drxr14kiuc4v8tfbrl", "interval" "1m", "limit" 4, "name" "el nombre de mi suscripción", "description" "esto es genial", "reference" "external reference", "total" 1595 }, "subscriber" { "uid" "rly80us2jz8zhtscph", "reference" "3447", "customer" { "identification" "12123123", "email" "juan perez\@mimail com", "name" "juan perez wayne" } }, "context" { "status" "success" }, "execution" {} } } cambio de método de pago { "type" "subscription\ change source", "data" { "result" true, "view" { "type" "card" }, "payment" { "id" "abc123123", "description" "validación de tarjeta ", "operation" { "type" "validation" }, "status" { "code" "410", "text" "denegada, fondos insuficientes", "message" "denegada, fondos insuficientes (cod 51)" }, "total" 17 15, "currency" { "code" "ars", "text" "peso argentino", "symbol" "$" }, "riskanalysis" { "band" "n/a", "level" "n/a" }, "created" "2020 12 02t11 31 56 544z", "updated" "2020 12 02t11 31 58 243z", "reference" "external reference", "source" { "name" "visa", "type" "card", "reference" "visa", "number" "4515 00 1234", "expiration" { "month" "01", "year" "24" }, "installment" { "description" "1 cuota", "amount" 17 15, "count" 1, "reference" "1" } } }, "entity" { "name" "demo entity", "uid" "demo entity" }, "customer" { "uid" "12123123", "name" "juan perez wayne", "phone" "12123123", "identification" "110303456", "email" "soybatman\@wayneinc com" }, "user" { "name" "juan perez wayne", "email" "juan perez\@mimail com" }, "source" { "name" "visa", "type" "card", "reference" "visa" }, "subscription" { "uid" "4546465465465", "interval" "1m", "limit" 0, "name" "mi suscripción", "description" "débitos automáticos? todavía existe eso?", "reference" "external reference", "total" 8000 14 }, "subscriber" { "uid" "fvon4enav5", "reference" "5defe0af e9be 4288 bed1 423a5cc41920", "customer" { "email" "juan perez\@mimail com", "name" "juan perez wayne", "identification" "12123123", "phone" "1112341234" } }, "context" { "status" "success" }, "execution" {} } } } suscripción ejecutada el servicio para este webhook utiliza los webhooks estandares descriptos en la sección webhooks de esta documentación agregando los nodos "subscription" y "subscriber" { "type" "subscription\ execution", "data" { "result" true, "view" { "type" "card" }, "payment" { "id" "abc121232", "description" "cobro ejecutado", "operation" { "type" "payment v2" }, "status" { "code" "410", "text" "denegada, fondos insuficientes", "message" "denegada, fondos insuficientes (cod 51)" }, "total" 1533 11, "currency" { "code" "ars", "text" "peso argentino", "symbol" "$" }, "riskanalysis" { "band" "n/a", "level" "n/a" }, "created" "2020 12 02t01 00 55 994z", "updated" "2020 12 02t01 00 57 091z", "reference" "external reference", "source" { "name" "visa débito", "type" "card", "reference" "visa debit", "number" "4515 00 1234", "expiration" { "month" "02", "year" "26" }, "installment" { "description" "débito", "amount" 1546 55, "count" 1, "reference" "1" } } }, "entity" { "name" "demo entity", "uid" "demo entity" }, "customer" { "uid" "12123123", "name" "juan perez wayne", "phone" "12123123", "identification" "110303456", "email" "soybatman\@wayneinc com" }, "user" { "name" "juan perez wayne", "email" "juan perez\@mimail com" }, "source" { "name" "visa débito", "type" "card", "reference" "visa debit" }, "subscription" { "uid" "fdsxu7rbc", "interval" "1m", "limit" 5, "name" "mi suscripción", "description" "dinosaurios", "reference" "external reference", "total" 1547 }, "subscriber" { "uid" "cba456456", "reference" "exernal reference", "period" 1, "customer" { "identification" "123123132", "email" "juan perez\@mimail com", "name" "juan perez wayne" } }, "context" { "status" "success" }, "execution" { "uid" "54z45drxez01qwylul" } } } suscriptor suspendido { "type" "subscription\ subscriber\ suspended", "data" { "subscription" { "uid" "jmfi3ml3d", "interval" "1m", "limit" 0, "name" "nombre de la suscripción", "description" "descripción de la suscripción", "total" 500 }, "subscriber" { "uid" "qy82nostm", "reference" "qy82nostm", "customer" { "name" "juan batman", "identification" "999999", "email" "soybatman\@gmail com" } } } } suscriptor activado { "type" "subscription\ subscriber\ active", "data" { "subscription" { "uid" "jmfi3ml3d", "interval" "1m", "limit" 0, "name" "nombre de la suscripción", "description" "descripción de la suscripción", "total" 500 }, "subscriber" { "uid" "qy82nostm", "reference" "qy82nostm", "customer" { "name" "juan batman", "identification" "999999", "email" "soybatman\@gmail com" } } } } redirección cuando el servicio redirige al suscriptor a la return url definida al crear la suscripción, se agregan un conjunto de parámetros en la url para indicarle al sitio el resultado de la suscripción los parámetros de tipo query que se agregan a la url definida son reference referencia asignada al suscriptor status estado de la transacción asociada a la operación de suscripción uid id de la suscripción sid id del suscriptor cuando se cancela el proceso de suscripción, el status será 0