Checkout.com Integration

# Connect Checkout.com
$ hyperfold integrate add checkout
Enter your Checkout.com Secret Key: sk_xxx
Enter your Checkout.com Public Key: pk_xxx
Testing connection...
✓ Connected to Checkout.com
CHECKOUT.COM CONNECTED
  Entity ID:        ent_xxx
  Mode:             live
  Processing:       enabled
# View connection details
$ hyperfold integrate show checkout
INTEGRATION: Checkout.com
Entity ID:          ent_xxx
Business:           Acme Sports Inc.
Mode:               live
Status:             active
CAPABILITIES
  ✓ Card Payments
  ✓ Network Tokens
  ✓ 3D Secure
  ✓ Apple Pay / Google Pay
  ✓ Multi-currency

# Network Token support for agent payments
# Benefits for agent commerce:
# - Higher approval rates (5-10% improvement)
# - Automatic card updates (no expired card failures)
# - PCI scope reduction
# - Lower interchange fees on some networks
# Configure Network Tokens
$ hyperfold integrate config checkout \
  --enable-network-tokens \
  --token-provider=visa,mastercard
# Token flow:
# 1. Customer saves card → Checkout.com requests Network Token
# 2. Network Token stored instead of PAN
# 3. Agent transactions use Network Token
# 4. Card updates propagate automatically

POST /acp/checkout/finalize
{
  "checkout_id": "chk_xyz789",
  "payment": {
    "method": "checkout_nt",
    "network_token_id": "tok_nt_abc123"
  }
}

# Payment processing with Checkout.com
@OnACPEvent("checkout.finalize")
async handleCheckoutPayment(event: CheckoutEvent) {
  const payment = await this.tools.payments.charge({
    provider: "checkout",
    amount: event.total * 100,  // Checkout.com uses minor units
    currency: "USD",
    source: {
      type: "network_token",
      token: event.payment.network_token_id
    },
    reference: event.order_id,
    metadata: {
      session_id: event.session_id,
      customer_id: event.customer.id
    },
    "3ds": {
      enabled: event.total > 100,
      attempt_n3d: true
    }
  });
  return {
    status: payment.approved ? "success" : "payment_failed",
    payment_id: payment.id,
    auth_code: payment.auth_code
  };
}

# View payment details
$ hyperfold pay show pay_xxx
PAYMENT: pay_xxx
Provider:           Checkout.com
Status:             Captured
Amount:             $167.79 USD
CARD
  Brand:            Visa
  Last 4:           4242
  Network Token:    Active
3D SECURE
  Version:          2.2
  Status:           Authenticated

# Multi-currency processing
$ hyperfold integrate config checkout \
  --currencies=USD,EUR,GBP,JPY \
  --auto-conversion=true
# Intelligent acceptance
$ hyperfold integrate config checkout \
  --smart-routing=true \
  --retry-on-soft-decline=true \
  --cascade-to-backup=true
# Fraud prevention
$ hyperfold integrate config checkout \
  --fraud-detection=enabled \
  --risk-threshold=medium \
  --block-high-risk=true
# View processing statistics
$ hyperfold pay stats --provider=checkout --period=30d