Agentul tău AI poate alimenta contul singur

Cum funcționează

Endpointul urmează Machine Payments Protocol, un standard deschis scris de Stripe și Tempo. Orice client compatibil MPP funcționează; Link CLI face întreaga buclă într-o singură comandă.

1. Agentul apelează POST /api/v1/billing/topup cu suma de credit dorită, folosind cheia API a contului ca bearer token.
2. Răspunsul este 402 Payment Required. Antetul WWW-Authenticate: Payment conține provocarea: metoda stripe, totalul în cenți, id-ul profilului nostru Stripe și o expirare de cinci minute. Corpul JSON repetă creditul, taxa și totalul.
3. Agentul plătește provocarea din portofelul său, care emite un Shared Payment Token de unică folosință (spt_…) limitat la acest comerciant și la această sumă, și repetă cererea cu credențialul în antetul Payment-Authorization.
4. Încasăm tokenul, adăugăm exact creditul cerut, emitem factura (credit plus taxă) și răspundem 200 cu soldul și un antet Payment-Receipt.

Exemple

Primul apel, fără credențial: serverul răspunde cu provocarea.

curl -i -X POST https://cloudlinux.ro/api/v1/billing/topup \
  -H "Authorization: Bearer cl_your_token" \
  -H "Content-Type: application/json" \
  -d '{"amount": 20}'

HTTP/2 402
WWW-Authenticate: Payment id="…", realm="www.cloudlinux.ro", method="stripe",
  intent="charge", request="…", expires="…", header="Payment-Authorization", opaque="…"

{"error":"payment_required","credit":20,"fee":0.97,"total":20.97,"currency":"EUR", …}

Al doilea apel, cu credențial: serverul încasează și creditează.

curl -i -X POST https://cloudlinux.ro/api/v1/billing/topup \
  -H "Authorization: Bearer cl_your_token" \
  -H "Payment-Authorization: Payment <base64url credential with your spt_… token>" \
  -H "Content-Type: application/json" \
  -d '{"amount": 20}'

HTTP/2 200
Payment-Receipt: <base64url receipt>

{"data":{"credit_added":20,"fee":0.97,"charged":20.97,"currency":"EUR","balance":…,"payment":"pi_…"}}

Cu Link CLI de la Stripe, cele două apeluri și plata din portofel sunt o singură comandă:

npx @stripe/link-cli auth login
npx @stripe/link-cli mpp pay https://cloudlinux.ro/api/v1/billing/topup -X POST \
  -H "Authorization: Bearer cl_your_token" \
  -d '{"amount": 20}' --context "cloudlinux.ro credit top-up"

Cât costă

Taxa de procesare a plății online este 3.4% din total plus €0.25, calculată invers astfel încât, după comisionul procesatorului, să rămână exact creditul cerut. Exemplu: €20.00 credit costă €20.97, din care €0.97 este taxa. Taxa este facturată împreună cu creditul. Depunerile prin transfer bancar făcute de titular nu au taxă.

Reguli

• Doar conturi verificate. Prima depunere este făcută întotdeauna de titular, din consolă; plățile de la mașini nu sunt niciodată primii bani intrați într-un cont.
• Titularul contului trebuie să fi acceptat Termenii și Condițiile curente în consolă. Altfel endpointul răspunde 403 cu un link către termeni.
• Sume între €5 și €5.000 per apel. Provocările expiră după cinci minute și sunt legate de cont și de sumă; o sumă schimbată sau tokenul altui cont primește o provocare nouă, niciodată o încasare.
• Orice cheie API a contului funcționează; nu e nevoie de o permisiune suplimentară, pentru că agentul plătește, nu cheltuie. Cheltuirea creditului după aceea trece prin permisiunile și limita de cheltuieli ale cheii.

Metodele de plată pe care le acceptăm

Agenții plătesc astăzi cu cardul prin Shared Payment Tokens (portofelul pentru agenți Link). Plățile cu stablecoin prin același protocol sunt planificate. Oamenii adaugă credit pe pagina de plată cu metodele de mai jos.

• Visa, Mastercard și alte carduri
• Apple Pay
• Google Pay
• Link
• PayPal
• Revolut Pay
• Transfer bancar (factură proformă)
• Plăți făcute de agenți AI (Machine Payments Protocol)