개발자

Baynoy로 구축하기

OpenAPI 3.1, 멱등성 키, webhook을 갖춘 REST API. JavaScript, Python, PHP, Ruby, Go, C#의 타입드 SDK. 샌드박스 키는 30초 만에 준비됩니다.

<150ms

P50 API 지연

99.95%

가동률 SLA

6

공식 SDK

8

Webhook 이벤트

빠른 시작

첫 결제 만들기

POST 하나, 어떤 결제 수단이든. 매 재시도마다 Idempotency-Key 전달 — 절대 이중 청구 없음.

curl https://api.baynoy.com/v1/payments \
  -H "Authorization: Bearer sk_test_••••" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4900,
    "currency": "USD",
    "methods": ["card","usdc"],
    "payout":  { "type": "bank", "currency": "USD" }
  }'

Webhook 검증

서명됨, 재시도됨, 리플레이 가능

모든 이벤트는 HMAC SHA-256으로 서명되고 지수 백오프로 최대 7일간 재시도됩니다. 과거 전송을 대시보드에서 리플레이.

import crypto from "node:crypto";

export async function POST(req: Request) {
  const header = req.headers.get("Baynoy-Signature")!; // t=...,v1=...
  const body = await req.text();
  const { t, v1 } = Object.fromEntries(
    header.split(",").map((p) => p.split("=")),
  );
  const expected = crypto
    .createHmac("sha256", process.env.BAYNOY_WHSEC!)
    .update(`${t}.${body}`)
    .digest("hex");
  if (v1 !== expected) return new Response("bad signature", { status: 401 });
  const evt = JSON.parse(body); // evt.type === "payment.succeeded"
  return new Response("ok");
}

REST API

어떤 언어에서든 호출

Baynoy는 Bearer 인증을 사용하는 순수 REST API입니다 — 설치할 SDK가 없습니다. 동일한 요청이 모든 HTTP 클라이언트에서 작동합니다.

cURL

curl https://baynoy.com/api/v1/payments \
  -H "Authorization: Bearer sk_live_..."

JavaScript / TypeScript

await fetch("https://baynoy.com/api/v1/payments", {
  headers: { Authorization: "Bearer sk_live_..." },
});

Python

requests.get(
  "https://baynoy.com/api/v1/payments",
  headers={"Authorization": "Bearer sk_live_..."},
)

Webhook 이벤트

8가지 타입, 하나의 형태

payment.succeeded

결제가 잔액에 입금되었습니다.

payment.failed

결제가 거부되거나 만료되었습니다.

payment.refunded

환불이 전체 또는 부분적으로 완료되었습니다.

payout.paid

페이아웃이 대상 계좌 또는 지갑에 도착했습니다.

payout.failed

페이아웃이 거부되어 되돌려졌습니다.

dispute.opened

카드 소지자가 분쟁 또는 차지백을 열었습니다.

customer.created

API 또는 결제를 통해 새 고객이 추가되었습니다.

invoice.paid

정기 또는 일회성 청구서가 결제되었습니다.

신뢰성

계속 가동되도록 구축됨

Cloudflare 뒤에 다중 리전 배포, 자동 failover, SRE 온콜 24/7 페이징. 상태 페이지는 모든 인시던트와 post-mortem을 48시간 내에 게시합니다.

  • Pro 이상에서 99.95% 가동률 SLA
  • PCI DSS Level 1, SOC 2 Type II (진행 중)
  • 버전 관리된 API — 조용한 호환성 깨짐 없음

변경 로그

최신 릴리스
  • 멀티 체인 USDC + 잠긴 환율 FX

    Solana, Base, Ethereum, Polygon에서 자동 최저 수수료 라우팅의 USDC 페이아웃.

    2026-05
  • Hosted Checkout v2

    샌드박스 브리지, 12개 언어 자동 감지, 커스텀 로고 + 강조 색상.

    2026-04
  • REST API v1, webhooks, SDK

    초기 REST API, 8개 webhook 이벤트, 5개 공식 SDK 출시.

    2026-03
  • POST에 Idempotency-Key 필수

    재시도된 POST 요청의 이중 청구 방지.

    2026-02

오늘 밤 통합 출시

샌드박스 키, CLI, 타입드 SDK. 프로덕션은 Tier 1 인증 후 잠금 해제.