Get your API keys

curl https://api.caravelpay.app/v1/connect \
  -H "Content-Type: application/json" \
  --data-binary '{
    "site_url": "https://shop.example",
    "payout_address": "0x52908400098527886E0F7030069857D2E4169EE7",
    "email": "[email protected]",
    "platform": "api"
  }'

// Node.js 18+ (built-in fetch). Run once, on your server.
import { writeFile } from "node:fs/promises";

const res = await fetch("https://api.caravelpay.app/v1/connect", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    site_url: "https://shop.example",
    payout_address: "0x52908400098527886E0F7030069857D2E4169EE7",
    email: "[email protected]", // optional: service notices only
    platform: "api",
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);

// The secret is in this response only. Save it outside your web root.
await writeFile(
  ".env.caravel",
  `CARAVEL_MERCHANT=${data.merchant_id}\nCARAVEL_SECRET=${data.secret}\n`,
  { mode: 0o600 },
);
console.log(`Connected as ${data.merchant_id}`);

<?php
// PHP 7.4+ with the curl extension. Run once, on your server.
$ch = curl_init('https://api.caravelpay.app/v1/connect');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 15,
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'site_url'       => 'https://shop.example',
        'payout_address' => '0x52908400098527886E0F7030069857D2E4169EE7',
        'email'          => '[email protected]', // optional: service notices only
        'platform'       => 'api',
    ], JSON_UNESCAPED_SLASHES),
]);
$data = json_decode((string) curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status !== 201) {
    throw new RuntimeException(($data['error']['code'] ?? 'http_' . $status) . ': ' . ($data['error']['message'] ?? ''));
}

// The secret is in this response only. Save it outside your web root.
file_put_contents('.env.caravel', "CARAVEL_MERCHANT={$data['merchant_id']}\nCARAVEL_SECRET={$data['secret']}\n");
chmod('.env.caravel', 0600);
echo "Connected as {$data['merchant_id']}\n";

# Python 3.8+ with requests (pip install requests). Run once, on your server.
import os
import requests

res = requests.post("https://api.caravelpay.app/v1/connect", timeout=15, json={
    "site_url": "https://shop.example",
    "payout_address": "0x52908400098527886E0F7030069857D2E4169EE7",
    "email": "[email protected]",  # optional: service notices only
    "platform": "api",
})
data = res.json()
if res.status_code != 201:
    raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")

# The secret is in this response only. Save it outside your web root.
fd = os.open(".env.caravel", os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
with os.fdopen(fd, "w") as f:
    f.write(f"CARAVEL_MERCHANT={data['merchant_id']}\nCARAVEL_SECRET={data['secret']}\n")
print(f"Connected as {data['merchant_id']}")