GroundedPay Documentation

Getting Started

GroundedPay is a non-custodial crypto payment gateway. Funds go directly to your wallet -- we never hold your money. Here is how to get up and running:

Installation Guide

Choose your platform below. All integrations use a lightweight JavaScript snippet that loads the GroundedPay checkout widget.

<!-- GroundedPay Checkout Widget -->
<script
  src="https://cdn.groundedpay.com/checkout.js"
  data-merchant="YOUR_MERCHANT_ID"
  data-key="YOUR_API_KEY"
  defer>
</script>

<!-- GroundedPay Checkout Widget -->
<script
  src="https://cdn.groundedpay.com/checkout.js"
  data-merchant="YOUR_MERCHANT_ID"
  data-key="YOUR_API_KEY"
  data-platform="woocommerce"
  defer>
</script>

<script src="https://cdn.groundedpay.com/checkout.js" defer></script>

const gp = new GroundedPay({
  merchantId: 'YOUR_MERCHANT_ID',
  apiKey: 'YOUR_API_KEY',
});

// When the user clicks "Pay with Crypto"
document.getElementById('pay-btn').addEventListener('click', () => {
  gp.open({
    amount: '49.99',         // USD amount
    label: 'Order #1234',     // Description shown in widget
    onSuccess: (tx) => {
      console.log('Payment confirmed:', tx.hash);
    },
    onCancel: () => {
      console.log('Payment cancelled');
    }
  });
});

Widget Customization

Customize the checkout widget appearance using data attributes on the script tag or through the JavaScript API.

Available Options

Example: Custom Colors and Coins

<script
  src="https://cdn.groundedpay.com/checkout.js"
  data-merchant="YOUR_MERCHANT_ID"
  data-key="YOUR_API_KEY"
  data-color="#22c55e"
  data-button-text="Checkout with Crypto"
  data-coins="ETH,USDC"
  data-logo="https://yoursite.com/logo.png"
  defer>
</script>

Supported Cryptocurrencies

• ETH -- Ethereum (mainnet & Base L2)
• USDC -- USD Coin (ERC-20 & Base)
• USDT -- Tether (ERC-20)
• BTC -- Bitcoin (on-chain)

API Reference

All API requests require your API key in the x-api-key header. The base URL is https://api.groundedpay.com.

Create a Payment

curl -X POST https://api.groundedpay.com/api/checkout/create \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "amount": 49.99,
    "label": "Order #1234",
    "metadata": { "order_id": "1234", "customer": "jane@example.com" },
    "redirect_url": "https://yoursite.com/thanks"
  }'

{
  "id": "pay_abc123def456",
  "checkout_url": "https://pay.groundedpay.com/c/pay_abc123def456",
  "amount_usd": "49.99",
  "status": "pending",
  "created_at": "2026-04-14T12:00:00Z",
  "expires_at": "2026-04-14T12:30:00Z"
}

Check Payment Status

curl https://api.groundedpay.com/api/checkout/status/pay_abc123def456 \
  -H "x-api-key: YOUR_API_KEY"

{
  "id": "pay_abc123def456",
  "status": "confirmed",
  "amount_usd": "49.99",
  "amount_crypto": "0.02841",
  "coin": "ETH",
  "tx_hash": "0x8a3f...b7e2",
  "confirmed_at": "2026-04-14T12:05:23Z"
}

Webhooks

GroundedPay sends webhook notifications to your server when payment status changes. Configure your webhook URL in the dashboard settings.

Webhook Payload

Webhooks are sent as POST requests with a JSON body:

{
  "event": "payment.confirmed",
  "payment": {
    "id": "pay_abc123def456",
    "status": "confirmed",
    "amount_usd": "49.99",
    "amount_crypto": "0.02841",
    "coin": "ETH",
    "tx_hash": "0x8a3f...b7e2",
    "metadata": { "order_id": "1234" }
  },
  "timestamp": "2026-04-14T12:05:23Z"
}

Webhook Events

Verifying Webhooks

Each webhook includes a x-groundedpay-signature header containing an HMAC-SHA256 signature. Verify it using your API key:

const crypto = require('crypto');

function verifyWebhook(body, signature, apiKey) {
  const expected = crypto
    .createHmac('sha256', apiKey)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Pricing

GroundedPay offers simple, transparent pricing. Lower per-transaction rates as you grow -- no hidden fees, no surprises.

Need higher volume or custom rates? Contact Sales for Enterprise pricing.

Frequently Asked Questions

Support

We are here to help you get set up and answer any questions.