온라인 결제 받기

첫 테스트 결제부터 3-D Secure가 필수인 실제 카드 결제까지.

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

1 — Create a link

Create a payment link with a title, an amount in minor units and an asset key. The response gives you the slug of a hosted payment page.

Node
// 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}`);

2 — Let the customer pay

Card fields are hosted by the card processor; 3-D Secure runs on every card payment typed in by hand. Apple Pay and Google Pay appear on the hosted page where the device supports them: the wallet authenticates the payer instead of 3-D Secure, and the payment is a card payment in every other respect (same price, same webhooks). Subscription sign-up takes cards only.

3 — Trust the webhook, not the redirect

The redirect tells the customer what happened; the signed webhook tells your system. Fulfil on payment.captured only.