btcfactura pentru Agenti AI

btcfactura pentru Agenti AI

btcfactura.com expune catalogul complet si procesul de checkout prin MCP, astfel incat un agent AI poate sa navigheze printre operatori romani si branduri de gift carduri, sa aleaga o denominatie, sa plateasca o factura Lightning si sa livreze o reincarcare mobila sau un voucher PIN – fara cont, fara inregistrare, fara interventie umana.

Endpoint MCP

https://btcfactura.com/mcp

Fara sesiuni, raspunsuri JSON. Compatibil cu Claude, GPT-4o, Cursor si orice client MCP.

English version

Cum functioneaza

Reincarcare mobila (type: prepay_msisdn)

  1. Apeleaza lookup_carrier pentru a identifica operatorul unui numar de telefon.
  2. Apeleaza get_supplier_products pentru a naviga prin denominatiile disponibile.
  3. Apeleaza create_order cu type: "prepay_msisdn", produsul si numarul de telefon (msisdn).
  4. Plateste factura Lightning returnata in raspuns.
  5. Interogheaza get_order_status – creditul este adaugat pe telefon automat dupa confirmarea platii.

Gift card / Voucher PIN (type: prepay_pin)

  1. Apeleaza list_suppliers cu category: "prepayPin" pentru a vedea brandurile disponibile.
  2. Apeleaza get_supplier_products pentru a naviga prin denominatii.
  3. Apeleaza create_order cu type: "prepay_pin" si produsul – nu este necesar numarul de telefon.
  4. Plateste factura Lightning returnata in raspuns.
  5. Interogheaza get_order_status – cand dispatchStatus este COMPLETED, PIN-ul este livrat.

Instrumente

InstrumentDescriere
list_suppliersListeaza furnizorii disponibili pe btcfactura.com, optional filtrat dupa categorie (prepayMSISDN, prepayPin, utility).
get_supplier_productsListeaza denominatiile disponibile pentru un furnizor.
lookup_carrierIdentifica operatorul mobil pentru un numar de telefon romanesc. Returneaza supplierUid pentru create_order.
create_orderCreeaza o comanda si primesti o factura Lightning (bolt11). Foloseste type: "prepay_msisdn" + msisdn pentru reincarcari mobile; type: "prepay_pin" pentru gift carduri si vouchere PIN (fara numar de telefon). Nu necesita token de autentificare.
get_order_statusVerifica statusul platii (PENDING / PAID / EXPIRED) si al livrarii (PENDING / PROCESSING / COMPLETED / FAILED). Interogheaza la fiecare 10-15 s dupa plata.
healthVerifica daca serverul MCP este accesibil.

Plata

Agentul plateste o factura Lightning din propriul portofel. Reincararile si voucherele sunt ireversibile dupa livrare – de aceea Lightning este potrivit: decontare instantanee, fara rambursari, fara retele de carduri. Pretul perceput este identic cu pretul de pe site – include marja operatorului si orice taxe aplicabile.

Limite

  • Limita de cereri: 30 pe minut per IP.
  • Expirare factura: 30 de minute de la creare.
  • Reincarcari mobile: Vodafone Romania, Orange Romania, Digi (RCS&RDS), Telekom si altii prin list_suppliers.
  • Gift carduri si vouchere: navigheaza brandurile disponibile cu list_suppliers si category: "prepayPin".

Pentru oameni

Nu esti agent AI? Cumpara de pe site – aceleasi produse, Lightning + crypto + card.