Kütüphaneler ve SDK'lar
Python ve Node için resmî kütüphaneler ve API'yi düz HTTPS ile çağırmanın yolu.
Henüz yayında değil — api.baynoy.com çözümlenmiyor, dolayısıyla aşağıdaki örnekler bugün çalışmaz. Hedeflediğimiz sözleşmeyi anlatıyorlar ve bu sayfadaki şemalar hâlâ değişebilir.
Official libraries
Python: pip install baynoy (Python 3.9+, requests only), on PyPI. Node: npm install @baynoy/sdk (Node 18+, ESM and CommonJS, no dependencies), on npm. Both sign money-moving requests when given the key's id and signing secret, put an Idempotency-Key on every POST and reuse it on retries, refuse float amounts before sending, raise typed errors carrying code and requestId, and verify webhooks with webhooks.constructEvent.
// npm install @baynoy/sdk
import { Baynoy } from "@baynoy/sdk";
const baynoy = new Baynoy(process.env.BAYNOY_SECRET_KEY, {
keyId: process.env.BAYNOY_KEY_ID, // signs money-moving requests
signingSecret: process.env.BAYNOY_SIGNING_SECRET,
});
// amounts are strings of integer minor units — a float is refused before sending
const { slug } = await baynoy.paymentLinks.create({ title: "Design retainer", amountMinor: "4900", assetKey: "fiat:EUR" });
console.log(`https://baynoy.com/pay/${slug}`);# pip install baynoy
import os, baynoy
client = baynoy.Baynoy(
os.environ["BAYNOY_SECRET_KEY"],
key_id=os.environ["BAYNOY_KEY_ID"], # signs money-moving requests
signing_secret=os.environ["BAYNOY_SIGNING_SECRET"],
)
link = client.payment_links.create(title="Design retainer", amount_minor="4900", asset_key="fiat:EUR")
print("https://baynoy.com/pay/" + link["slug"])Calling without an SDK
Plain HTTPS does everything the libraries do: Bearer authentication, JSON bodies, an Idempotency-Key on money-moving POSTs, and a Baynoy-Signature on the ones that require it. The same call in three shapes.
curl https://api.baynoy.com/v1/catalog/links \
-H "Authorization: Bearer bk_test_..." \
-H "Content-Type: application/json" \
-d '{"title": "Design retainer", "amountMinor": "4900", "assetKey": "fiat:EUR"}'
# -> {"id": "lnk_...", "slug": "k3x9q2"} — the page is https://baynoy.com/pay/k3x9q2// Node 18+, no package needed
const res = await fetch("https://api.baynoy.com/v1/catalog/links", {
method: "POST",
headers: {
authorization: `Bearer ${process.env.BAYNOY_SECRET_KEY}`,
"content-type": "application/json",
},
// amounts are strings of integer minor units — never floats
body: JSON.stringify({ title: "Design retainer", amountMinor: "4900", assetKey: "fiat:EUR" }),
});
const { slug } = await res.json();
console.log(`https://baynoy.com/pay/${slug}`);import os, requests
r = requests.post(
"https://api.baynoy.com/v1/catalog/links",
headers={"Authorization": f"Bearer {os.environ['BAYNOY_SECRET_KEY']}"},
json={"title": "Design retainer", "amountMinor": "4900", "assetKey": "fiat:EUR"},
)
print("https://baynoy.com/pay/" + r.json()["slug"])