API 레퍼런스

REST 엔드포인트, 요청과 응답 형태, 오류 응답 구조와 버전 관리.

아직 사용할 수 없습니다 — api.baynoy.com 도메인이 조회되지 않으므로 아래 예제는 지금 실행되지 않습니다. 저희가 만들어 가는 계약을 설명한 것이며, 이 페이지의 형식은 아직 바뀔 수 있습니다.

Resources

/v1/payment_links · /v1/payment_intents · /v1/payment_methods · /v1/refunds · /v1/disputes · /v1/accounts · /v1/balances · /v1/transactions · /v1/beneficiaries · /v1/payouts · /v1/fx_quotes · /v1/cards · /v1/cardholders · /v1/stablecoin_addresses · /v1/deposits · /v1/withdrawals · /v1/webhook_endpoints · /v1/events.

The error envelope

Every non-2xx response carries {"error": {"code", "message", "details?"}}. Codes are stable identifiers you can branch on; messages are human-readable and may change.

Idempotency

Financial POSTs require an Idempotency-Key header, scoped to your account and endpoint. The same key with the same body safely returns the first result; the same key with a different body is a conflict.

Node
const baynoy = require("@baynoy/sdk")("bk_test_...");

const link = await baynoy.paymentLinks.create({
  amount: 4900, // integer minor units — never floats
  currency: "EUR",
  title: "Design retainer",
});
Python
import baynoy
client = baynoy.Client("bk_test_...")

link = client.payment_links.create(
    amount=4900,  # integer minor units
    currency="EUR",
    title="Design retainer",
)