Comenzi, plăți, anulări și upgrade prin AI

Un asistent AI conectat la contul dvs. prin MCP (https://api.app.blackbox.md/mcp) poate plasa comenzi, le poate achita din sold, le poate anula și poate face upgrade serverelor. Accesul i-l dați cu un token creat pe blackbox.md, în „Contul meu” → „Token-uri API” (blackbox.md/account/api-tokens). Rezultatul îl vedeți în „Contul meu” → „Comenzi” și „Sold”.

Disponibil pentru: titularul contului blackbox.md, printr-un token API cu permisiunea „Plasează și modifică comenzi în numele meu” (orders:write).

Ca să vadă serverele, comenzile și soldul, asistentul are nevoie și de permisiunile „Citește lista și statusul serverelor mele” și „Citește soldul, facturile și comenzile”. Ele sunt bifate implicit la crearea token-ului.

Cum sunt protejați banii dvs.

Important Dacă în clientul AI ați permis rularea automată a uneltelor, clientul nu vă mai întreabă nimic. Asistentul este instruit să vă ceară confirmarea înainte de a cheltui bani sau de a anula o comandă, dar BLACKBOX nu poate impune această întrebare. Păstrați aprobarea manuală pentru create_order, pay_order, cancel_order și resize_server.

Despre permisiuni: Permisiunile token-urilor (scopes). Crearea token-ului: Token-uri API: creare, copiere și revocare.

Cum plasați o comandă

1. Cereți asistentului o ofertă și spuneți-i explicit să aștepte confirmarea dvs.
2. Asistentul citește catalogul cu list_vm_plans și apelează create_order fără confirmare. Vă arată totalul în MDL. Încă nu se creează nimic.
3. Verificați planul, sistemul de operare, cheile SSH și totalul.
4. Confirmați. Asistentul repetă apelul cu aceleași date și confirm=true.
5. Comanda apare în „Comenzi” cu statusul „Nou” și un număr BBX-…. Primiți emailul obișnuit „Am primit solicitarea dumneavoastră — BBX-…”; la „Mesaj:” scrie Created via MCP (AI agent) on behalf of the customer.

Nu s-a retras niciun ban. Achitați comanda prin asistent (secțiunea următoare) sau pe site, cu „Achită comanda”.

Sfat O formulare care funcționează bine: „Fă o ofertă pentru … și așteaptă confirmarea mea înainte de a plăti.” De exemplu:

Fă o ofertă pentru un server vm-iops1-m cu Ubuntu 24.04 și așteaptă confirmarea mea înainte de a plasa și a plăti comanda.

Ce puteți cere în comandă:

Limită: cel mult 20 de apeluri create_order pe oră, inclusiv ofertele.

Cum achitați comanda din sold

pay_order achită din sold o comandă cu statusul „Nou”, creată de asistent sau plasată de dvs. pe site.

1. Verificați că soldul acoperă totalul: pagina „Sold” sau întrebați asistentul (unealta get_balance). Dacă nu ajunge, alimentați soldul pe site: Alimentarea soldului.
2. Cereți asistentului să achite comanda BBX-…. El transmite totalul curent al comenzii; dacă prețul s-a schimbat, plata se oprește cu price_changed și asistentul trebuie să vă arate totalul nou.
3. După plată:
   • comanda trece în „În lucru”;
   • în „Sold” → „Istoricul operațiunilor” apare „Comandă BBX-…” cu minus;
   • în „Facturi” apare factura BBX-… cu statusul „Achitată”, iar pe email primiți „Plată confirmată — BBX-…”;
   • planurile VPS: serverul se creează automat, de regulă în câteva minute după confirmarea plății, apoi primiți „Serverul dvs. este gata — BBX-…”;
   • serverele dedicate: serverul este pregătit manual de echipă; vă contactăm.

Limită: 10 apeluri pay_order pe minut. Restul detaliilor: Plata unei comenzi din sold.

Dacă apelul pare să fi expirat

Imediat după plată pornește crearea serverului, așa că apelul pay_order se poate prelungi. Dacă clientul AI raportează o expirare sau o eroare de conexiune, nu cereți o nouă plată. Rugați asistentul să verifice comanda cu list_orders sau deschideți „Comenzi”: statusul „În lucru” înseamnă că plata a reușit. O a doua plată pentru aceeași comandă este oricum refuzată (not_payable).

Cum anulați o comandă

Asistentul anulează comenzile cu statusul „Nou” sau „În lucru”, după aceleași reguli ca butonul „Anulează comanda” de pe site: Anularea comenzii și rambursări.

1. Cereți asistentului să verifice ce s-ar întâmpla dacă anulați comanda BBX-…. El apelează cancel_order fără confirmare și vă arată previzualizarea:
   • suma care se returnează în sold, în MDL;
   • regula aplicată: integral (full), proporțional (prorated) sau fără rambursare (none);
   • dacă se șterge un server și adresa lui IP.
2. Citiți previzualizarea. Dacă vreți să continuați, confirmați explicit.
3. Asistentul repetă apelul cu confirm=true. Comanda trece în statusul „Anulat”, iar pe email primiți „Comandă anulată — BBX-…”. Dacă se returnează o sumă, ea ajunge în sold („Rambursare comandă BBX-…” în „Istoricul operațiunilor”).

Ireversibil Dacă comanda are un server, la confirmare acesta se șterge imediat, cu toate datele de pe el. Spre deosebire de „Șterge definitiv” din panou, nu există perioada de grație de 24 de ore și ștergerea nu se poate opri.

• Rambursarea ajunge numai în sold. Pentru banii pe card, scrieți la support@blackbox.md.
• Cât timp serverul se creează, comanda nu se poate anula (provisioning_in_progress). Reveniți peste câteva minute.
• Limită: 5 apeluri cancel_order în 5 minute, inclusiv previzualizările.

Cum faceți upgrade unui server

Asistentul trece un server pe un plan mai mare din aceeași familie, cu plata din sold, la fel ca butonul „Upgrade” din panou: Upgrade server: trecerea la un plan mai mare.

1. Cereți opțiunile de upgrade pentru server. Asistentul apelează get_server_resize_options și vă arată planurile mai mari din aceeași familie, prețul lunar nou și suma care s-ar retrage acum (proporțional cu zilele rămase din ciclul curent de 30 de zile).
2. Alegeți planul. Asistentul apelează resize_server fără confirmare și vă arată previzualizarea: planul nou, suma care se retrage și soldul dvs. Dacă soldul nu ajunge, eroarea insufficient_balance apare deja acum.
3. Confirmați. Asistentul repetă apelul cu confirm=true: suma se retrage din sold („Upgrade server” în istoric), iar serverul repornește pe planul nou. Întreruperea durează câteva minute; adresa IP și datele se păstrează.
4. Asistentul află doar că upgrade-ul a pornit. Rezultatul îl vedeți în emailul „Serverul dvs. a fost actualizat — BBX-…” și în panou, unde câmpul „Configurație” de pe cardul serverului arată resursele noi.

• Upgrade-ul merge doar în sus: serverul nu se poate micșora și nu poate trece în altă familie.
• Funcționează pentru serverele comandate din contul dvs. pe planurile VPS din catalog (vm-…). La planurile „VPS hosting” și la planurile mai vechi, care nu se mai vând, apare not_upgradeable_plan, iar serverele dedicate nu se pot mări prin asistent: în ambele cazuri, scrieți-ne.
• Dacă upgrade-ul eșuează, suma revine automat în sold („Anulare upgrade server”).
• Limită: 3 apeluri resize_server în 10 minute, inclusiv previzualizările.

Erori frecvente

Dacă asistentul spune că serviciul de infrastructură este temporar indisponibil, încercați mai târziu. Toate codurile și limitele: Limite și coduri de eroare MCP.

Întrebări frecvente

Poate asistentul să cheltuie bani fără știrea mea? Doar dacă token-ul are permisiunea „Plasează și modifică comenzi în numele meu” și clientul AI nu vă cere aprobarea. Chiar și atunci plătește numai din sold și numai sume calculate de BLACKBOX: totalul curent al unei comenzi sau diferența pentru un upgrade. Pentru un asistent care doar citește date, creați un token fără această permisiune.

Pot plăti cu cardul o comandă creată de asistent? Da. Comanda apare în „Comenzi” cu statusul „Nou”. Apăsați „Achită comanda” și plătiți ca de obicei.

Poate asistentul să alimenteze soldul sau să plătească facturile emise de echipă? Nu. Alimentarea se face numai pe site, iar uneltele MCP nu plătesc facturi. Lista completă a uneltelor: Lista uneltelor MCP.

Vreau să șterg un server, dar cu posibilitatea de a mă răzgândi. Cum procedez? Folosiți „Șterge definitiv” din panou, care are o perioadă de grație de 24 de ore, dar nu rambursează nimic: Ștergerea definitivă a unui server. Prin asistent, anularea comenzii șterge serverul imediat.