가상계좌 플로우

발급

POST /v1/virtual-accounts
{
  "orderId": "order-va-001",
  "orderName": "무통장 주문",
  "amount": 25000,
  "customerName": "홍길동"
}

{
  "paymentKey": "pay_va_123",
  "status": "WAITING_FOR_DEPOSIT",
  "virtualAccount": {
    "bank": "신한",
    "accountNumber": "140-123-456789",
    "dueDate": "2026-04-22T23:59:59+09:00",
    "expired": false
  }
}

결제 승인 시 상태

가상계좌를 포함한 결제를 승인하면 즉시 `DONE`이 아니라 `WAITING_FOR_DEPOSIT` 상태가 내려오고 `virtualAccount` 객체가 같이 포함됩니다.

{
  "paymentKey": "pay_va_123",
  "orderId": "order-va-001",
  "status": "WAITING_FOR_DEPOSIT",
  "virtualAccount": {
    "bank": "신한",
    "accountNumber": "140-123-456789",
    "dueDate": "2026-04-22T23:59:59+09:00"
  }
}

DEPOSIT_CALLBACK 웹훅

{
  "eventType": "DEPOSIT_CALLBACK",
  "createdAt": "2026-04-21T10:30:00+09:00",
  "secret": "whsec_123",
  "data": {
    "paymentKey": "pay_va_123",
    "depositedAmount": 25000,
    "status": "DONE"
  }
}

export async function POST(request: Request) {
  const payload = await request.json();
  console.log("deposit webhook", payload.data.paymentKey, payload.data.status);
  return Response.json({ received: true });
}