@k-wallet/server

쇼핑몰 백엔드에서 Wallet 서버를 호출하기 위한 Node.js SDK입니다.

설치

npm i @k-wallet/server

사용 예시

import { createWalletServerClient } from '@k-wallet/server';

const wallet = createWalletServerClient(process.env.WALLET_SECRET_KEY!, {
  baseUrl: 'https://api.kst-wallet.xyz',
  timeoutMs: 10000,
});

const prepared = await wallet.prepareCheckout(
  {
    orderId: 'order-20260326-001',
    merchantName: 'my-shop',
    amount: 32000,
    successUrl: 'https://shop.example.com/pay/success',
    failUrl: 'https://shop.example.com/pay/fail',
  },
  { idempotencyKey: 'checkout-order-20260326-001' },
);

const confirmed = await wallet.confirmPayment(
  {
    paymentKey: 'pay_...',
    orderId: 'order-20260326-001',
    amount: 32000,
  },
  { idempotencyKey: 'confirm-order-20260326-001' },
);

if (confirmed.confirmed) {
  // 주문 확정
}

인증 헤더

• x-secret-key: 필수
• idempotency-key: 선택 (prepare/confirm 권장)