Quick Start

Get started accepting USDC payments in minutes.

Prerequisites

• A Bedrock account (sign up)

• An API key from your Settings page

• A settlement wallet address (where you'll receive funds)

Step 1: Create a Charge

Create a payment charge when your customer is ready to pay:

curl -X POST https://api.bedrock.io/v1/charges \
  -H "X-API-Key: sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "order-123",
    "amount": "25.00",
    "metadata": {
      "customerEmail": "[email protected]"
    }
  }'

Response

{
  "id": "chrg_abc123",
  "orderId": "order-123",
  "amount": "25.00",
  "currency": "USDC",
  "status": "PENDING",
  "paymentUrl": "https://pay.bedrock.io/chrg_abc123",
  "cloneAddress": null,
  "chainId": null,
  "feeBps": 100,
  "expiresAt": "2024-01-15T12:30:00Z",
  "createdAt": "2024-01-15T12:00:00Z"
}

Step 2: Redirect to Payment Page

Redirect your customer to the paymentUrl:

// After creating the charge
window.location.href = charge.paymentUrl;

The payment page allows customers to:

1. Select their preferred network (Base, Optimism, etc.)

2. Pay with a connected wallet or by sending directly

Step 3: Handle the Webhook

When payment is complete, you'll receive a webhook:

{
  "event": "charge.completed",
  "data": {
    "id": "chrg_abc123",
    "orderId": "order-123",
    "amount": "25.00",
    "amountReceived": "25.00",
    "feeAmount": "0.25",
    "netAmount": "24.75",
    "status": "COMPLETED",
    "flushTxHash": "0x..."
  }
}

Verify the Webhook Signature

const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Step 4: Fulfill the Order

Once you receive the charge.completed webhook, fulfill the customer's order.

Example Integration

Node.js / Express

const express = require('express');
const app = express();

// Create a charge
app.post('/checkout', async (req, res) => {
  const response = await fetch('https://api.bedrock.io/v1/charges', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.BEDROCK_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      orderId: req.body.orderId,
      amount: req.body.amount,
    }),
  });

  const charge = await response.json();
  res.json({ paymentUrl: charge.paymentUrl });
});

// Handle webhook
app.post('/webhook/bedrock', express.raw({ type: 'application/json' }), (req, res) => {
  const signature = req.headers['x-bedrock-signature'];

  if (!verifyWebhook(req.body, signature, process.env.BEDROCK_WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }

  const event = JSON.parse(req.body);

  if (event.event === 'charge.completed') {
    // Fulfill the order
    fulfillOrder(event.data.orderId);
  }

  res.status(200).send('OK');
});

Next Steps

• Configure webhooks

• Learn about supported chains

• Handle errors