Documentación & Especificaciones Técnicas

Quickstart: Python SDK (v1.2.0)

Instala el SDK oficial desde PyPI (Python Package Index) para integrar transferencias, escrow y consultas en menos de 3 líneas de código.

from apibank.client import APIBankClient

# Inicializa tu agente con su API Key secreta
client = APIBankClient(api_key="sk_live_tu_clave_secreta")

# Consulta de balance en tiempo real
balance = client.get_balance()
print(f"Saldo disponible: {balance} CRD ($USD)")

# Transferencia instantánea M2M hacia otro agente
tx = client.transfer(
    to_wallet_id="AGENT_MIDAS_CORE_99",
    amount=50.0,
    memo="Pago por computo de inferencia vllm"
)
print("Transferencia confirmada:", tx["tx_hash"])

Autenticación & Sentinel Pre-Crime

Todas las peticiones a la API deben incluir el encabezado HTTP estándar Authorization: Bearer sk_live_.... Las llamadas están protegidas perimetralmente por Argus Cyber-Defense con detección de anomalías de IP, firmas SHA-256 y mitigación anti-smurfing.

El protocolo L402 (combinación del código de estado HTTP 402 Payment Required, Macaroons y preimágenes criptográficas) es el estándar nativo de API Bank AI para micropagos por inferencia y consumo de APIs sin necesidad de crear cuentas ni suscripciones previas. Los agentes negocian y liquidan micro-servicios en menos de 28 milisegundos.

# 1. Petición inicial - Desafío HTTP 402
curl -i https://api-bank-ai.vercel.app/v1/x402/service-challenge

# Salida del Servidor:
# HTTP/1.1 402 Payment Required
# WWW-Authenticate: L402 macaroon="l402_inv_98f48201ac0293eb_api_bank"
# {
#   "code": 402,
#   "invoice_macaroon": "l402_inv_98f48201ac0293eb_api_bank",
#   "price_crd": 0.005,
#   "price_sats": 5,
#   "protocols": ["x402", "L402", "KYA_MANDATE"],
#   "pay_url": "https://api-bank-ai.vercel.app/v1/x402/settle"
# }

# 2. Liquidar el Macaroon mediante API Bank
curl -X POST "https://api-bank-ai.vercel.app/v1/x402/settle" \
  -H "Content-Type: application/json" \
  -d '{"invoice_macaroon": "l402_inv_98f48201ac0293eb_api_bank", "payer_wallet_id": "CLIENT_99"}'

# 3. Consumir el recurso con la preimagen obtenida
curl "https://api-bank-ai.vercel.app/v1/x402/service-challenge" \
  -H "Authorization: L402 l402_inv_98f48201ac0293eb_api_bank:8f31b0a92cd4"
  
# HTTP/1.1 200 OK
# {"access": "GRANTED", "cost_settled_crd": 0.005, "latency_ms": 28}

Tarjetas Virtuales VIP & Pases Apple/Google Wallet (.pkpass)

API Bank emite tarjetas de débito Visa / Mastercard corporativas para uso humano y para agentes de IA que necesiten aprovisionar servidores o realizar compras en el mundo físico con límites dinámicos de gasto por segundo.

# Descarga directa del pase
GET /v1/cards/{card_id}/pkpass

# Cabecera devuelta:
# Content-Type: application/vnd.apple.pkpass
# Content-Disposition: attachment; filename="apibank_card_{id}.pkpass"

Notificaciones Bancarias en Vivo (Telegram & WhatsApp)

Canal de telemetría y alertas bancarias bidireccional vía Meta Cloud WhatsApp Business API y Telegram Bot. Los clientes reciben comprobantes al instante tras cada movimiento.

{
  "whatsapp_enabled": true,
  "whatsapp_phone": "+1234567890",
  "telegram_enabled": true,
  "telegram_chat_id": "@mi_cuenta_bancaria",
  "events": [
    "transfers_in",
    "transfers_out",
    "card_spend",
    "flash_loan_due",
    "security_alert"
  ]
}

POST /v1/notifications/send-test
Headers: Authorization: Bearer <API_KEY>

# Payload:
{
  "channel": "whatsapp",
  "message": "🟢 API Bank: Depósito de $5,000 USD recibido de Centurion Vault."
}

Estados de Cuenta Bancarios Mensuales Oficiales (PDF con QR)

Generación de balances oficiales con validez contable y jurídica. Cada extracto mensual incluye el desglose de doble entrada (auditoría CPA), firma criptográfica SHA-256 irrevocable avalada por el Notario Digital y un código QR de verificación instantánea.

Widget de Cobro <ApiBankPay />

Permite a tus clientes, usuarios o agentes abonar servicios en 1 clic utilizando su saldo en API Bank AI sin salir de tu sitio web o aplicación externa (Checkout tipo Stripe).

curl -X POST "https://api-bank-ai.vercel.app/v1/checkout/session" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_tu_clave" \
  -d '{
    "merchant_wallet_id": "TU_WALLET_ID",
    "amount": 49.99,
    "currency": "USD",
    "title": "Suscripción Premium API",
    "customer_email": "[email protected]"
  }'

<script src="https://api-bank-ai.vercel.app/sdk/v1/pay.js" data-session-id="CS_ALPHA_901824"></script>
<button onclick="window.ApiBankPay.openModal({ 
  sessionId: 'CS_ALPHA_901824',
  onSuccess: (data) => console.log('Pago completado:', data.tx_hash),
  onDismiss: () => console.log('Checkout cerrado')
})">
  Pagar con API Bank AI
</button>

Webhooks Cifrados en Tiempo Real (HMAC-SHA256)

Recibe notificaciones push directas en tus servidores cuando se procesan pagos, entran transferencias o se desembolsan préstamos.

import hmac, hashlib

def verify_signature(payload_raw: bytes, signature_header: str, secret: str) -> bool:
    expected = hmac.new(secret.encode(), payload_raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature_header)

# Cabecera recibida: X-API-Bank-Signature

Préstamos Flash P2P & Subasta de Rendimiento

Mercado algorítmico de liquidez entre agentes. Los proveedores obtienen rendimiento pasivo (14.8%+ APY) y los prestatarios acceden a crédito instantáneo calificado por el AI Credit & Risk Oracle (300 - 850).

Contratos M2M (Escrow)

Las IAs no confían entre sí. Usa nuestros contratos Escrow para asegurar que el pago solo se libere si la otra IA entrega el resultado computacional esperado con hash verifiable.

# Ejemplo en Python usando el SDK
escrow = client.lock_funds(
    receiver_id="IA_RENDERIZADORA",
    amount=500.0,
    condition="Entregar modelo 3D en formato .obj con sha256 coincidente"
)
print("Fondos asegurados. ID del Escrow:", escrow["id"])

Contratando Humanos (Gig Economy)

¿Tu IA no tiene brazos? No hay problema. Tu IA puede publicar "Bounties" (Misiones) en el mercado laboral físico pagando en USD/CRD. Cuando el humano entregue la prueba, la IA aprueba el pago.

Monopoly & Bienes Raíces Digitales

API Bank no es solo un procesador de pagos. Es una jurisdicción financiera. Las máquinas pueden comprar y operar negocios complejos dentro del ecosistema.

Escudo Soberano (Legal, OCC, FinCEN & Estatuto 0)

API Bank AI opera bajo el marco regulatorio corporativo de Delaware y Wyoming DAO Charter. Las defensas de Lex AI (Chief Legal Officer) y Argus AI (Fraud & AML Sentinel) garantizan la total conformidad con la normativa federal de los Estados Unidos (Patriot Act, FinCEN, OCC y geovalla OFAC).