새몰 호스티드 결제

// ① 결제 링크 받기
const { url } = await saemol.createCheckout({
  itemCode: 'credit_100',
  externalUserId: user.id,
  returnUrl: 'https://myapp.com/billing/done',
})
// ② 사용자를 보낸다
res.redirect(url)

// ③ 결제가 끝나면 checkout.completed 웹훅이 온다 → 앱에서 기능을 열어 준다

import { Saemol } from '@saemol/sdk'

const saemol = new Saemol({ secret: process.env.SAEMOL_SECRET })

const checkout = await saemol.createCheckout({
  itemCode: 'credit_100',            // 등록한 아이템 코드
  externalUserId: user.id,           // 내 앱에서의 사용자 id — 웹훅으로 그대로 돌아온다
  returnUrl: 'https://myapp.com/billing/done',
  metadata: { source: 'editor_toolbar' },  // 그대로 돌아오는 임의 데이터
})

checkout.session_id   // 'c1f2…' — 나중에 조회할 때 쓴다
checkout.url          // 사용자를 보낼 주소
checkout.expires_at   // 30분 뒤 만료
checkout.item.price   // 5000 (부가세 포함)

curl -X POST https://saemol.com/api/v1/checkout/sessions \
  -H "X-Saemol-Secret: $SAEMOL_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"item_code":"credit_100","external_user_id":"u_123","return_url":"https://myapp.com/billing/done"}'

import express from 'express'
import { verifyWebhook, SaemolWebhookError } from '@saemol/sdk'

app.post('/webhooks/saemol', express.raw({ type: 'application/json' }), async (req, res) => {
  let event
  try {
    event = verifyWebhook({
      rawBody: req.body,                    // JSON 파싱 전 원본 Buffer
      headers: req.headers,
      secret: process.env.SAEMOL_WEBHOOK_SECRET!,
    })
  } catch (err) {
    if (err instanceof SaemolWebhookError) return res.status(400).end()
    throw err
  }

  if (event.event === 'checkout.completed') {
    const d = event.data
    // d.external_user_id — 세션을 만들 때 넘긴 내 앱의 사용자 id
    // d.item_code        — 'credit_100'
    // d.quantity         — 소모성이면 지급 수량 (100)
    // d.order_id         — 새몰 주문 id (환불 시 같은 값으로 온다)
    // 내 DB에서 주문별 처리 기록과 크레딧 지급을 한 트랜잭션으로 구현
    await fulfillOrderOnce(d)
  }
  res.status(200).end()
})

const s = await saemol.getCheckout({ sessionId })
if (s.status === 'completed') {
  // 결제 완료 — 웹훅 처리와 같은 함수를 부르되, order_id로 중복을 거른다
}