API & SDK

빌더를 위해 만들어진 API

OpenAPI 3.1, 멱등성 키, 커서 페이지네이션 및 JavaScript, Python, PHP, Ruby, Go, C# SDK를 갖춘 REST API.

Baynoy API로 작업하는 개발자

<150ms

P50 API 지연

99.95%

가동률 SLA

6

공식 SDK

  • OpenAPI 3.1 spec
  • 멱등성 키
  • 커서 페이지네이션
  • Bearer 인증
  • HMAC webhook
  • 샌드박스 + 테스트 카드
  • 6개 공식 SDK
  • 초당 1,000 req 속도 제한
  • 99.95% 가동률 SLA

결제 생성

하나의 엔드포인트, 30가지 방법

단일 리소스를 POST하면 Baynoy가 나머지를 처리합니다 — 카드, Apple Pay, Google Pay. 목적지 통화를 설정하면 정산 시 은행 또는 지갑으로 지급을 라우팅합니다.

  • Idempotency-Key가 재시도 시 이중 청구를 방지
  • 대용량 리포트를 위한 커서 페이지네이션
  • checkout_url을 통한 인라인 3DS 챌린지
  • 샌드박스 키는 절대 실제 돈을 만지지 않음

요청

POST /v1/payments
Authorization: Bearer sk_live_••••
Idempotency-Key: 7a1f2e

{
  "amount": 125000,
  "currency": "EUR",
  "payout":  { "type": "bank", "currency": "TRY" },
  "methods": ["card","usdc","sepa"],
  "metadata": { "patient_id": "p_8821" }
}

응답

{
  "id": "pmt_a7c91...",
  "status": "requires_action",
  "checkout_url": "https://pay.baynoy.com/c/a7c91"
}

빠른 시작

# No SDK to install — it's a plain REST API.
# Create a payment link from any HTTP client:
curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"title":"Invoice 0042","amount":2000,"currency":"USD"}'

REST API

어떤 언어에서든 호출

Bearer 인증을 사용하는 순수 REST API — 설치할 SDK가 없습니다. curl, fetch, requests 등 모든 HTTP 클라이언트에서 호출하세요. 프로덕션에 최적화: 버전 관리 응답, 멱등 재시도, 서명된 웹훅, 커서 페이지네이션.

  • Baynoy-Version 헤더를 통한 안정적인 버전 관리 응답
  • 모든 POST에 Idempotency-Key — 재시도해도 이중 청구 없음
  • HMAC-SHA256 서명 웹훅 (t=…,v1=…)
  • 모든 목록 엔드포인트에 커서 페이지네이션
문서 읽기

Webhook

신뢰할 수 있는 이벤트

모든 webhook은 HMAC SHA-256으로 서명되고, 지수 백오프로 최대 7일간 재시도되며, 대시보드에서 전체 request / response 기록과 함께 탐색 가능. 과거 이벤트를 원클릭으로 리플레이.

  • HMAC SHA-256 서명된 페이로드
  • 전체 결제 라이프사이클을 커버하는 8가지 이벤트 타입
  • 최대 7일까지 지수 백오프
  • 대시보드에서 원클릭 리플레이
엔드포인트 관리

서명된 이벤트

POST /your-endpoint
Baynoy-Signature: t=1716210000,v1=8b3...
Content-Type: application/json

{
  "id": "evt_2zX...",
  "type": "payment.succeeded",
  "data": { "object": { "id": "pmt_a7c91..." } }
}

키를 받고 결제를 보내세요

샌드박스 키는 즉시 발급됩니다. Tier 1 인증 후 프로덕션이 잠금 해제됩니다.