shieldpay-api-sdkjs

Official JavaScript/TypeScript SDK for the ShieldPay API.

Anti-spam, VPN blocking, email authentication, and PayPal payments — all in one package.

Install

npm install shieldpay-api-sdkjs

Quick Start

import { ShieldPay } from 'shieldpay-api-sdkjs'

const sp = new ShieldPay({ apiKey: 'sk_live_YOUR_KEY' })
// All calls go to: https://fixle.ch/shieldpay/api/worker=sk_live_YOUR_KEY/...

// Create a PayPal payment
const order = await sp.payment.create({
  amount: 49.99,
  currency: 'CHF',
  return_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
})
window.location.href = order.approve_url // redirect to PayPal

// After PayPal redirects back, capture
const captured = await sp.payment.capture(orderId)

// Check IP reputation (Pro: real IPQS check)
const ip = await sp.security.checkIp('1.2.3.4')

// Passwordless email auth for your users
const { token } = await sp.auth.createToken('[email protected]')
const { verified } = await sp.auth.verifyToken(token)

API Endpoint

Your API key is embedded in the URL — no headers needed:

https://fixle.ch/shieldpay/api/worker=sk_live_YOUR_KEY/payment/create
https://fixle.ch/shieldpay/api/worker=sk_live_YOUR_KEY/security/check-ip
https://fixle.ch/shieldpay/api/worker=sk_live_YOUR_KEY/me

Plans

| Feature | Free | Pro (1 CHF/mo) | |---|---|---| | PayPal payments | ✓ | ✓ | | Transaction fee | 2% | 0% | | VPN/Tor blocking | Basic | Full IPQS | | Auto-fallback | ✗ | ✓ | | Email alerts | ✗ | ✓ |

Docs

Full documentation: https://fixle.ch/shieldpay/SDK/docs/