WebhookRejection — @gj-kit/toss-payments

A public type from @gj-kit/toss-payments/webhook. The signature below is taken directly from the 0.6.1 release declaration.

Verified import example

import { WebhookRejection } from '@gj-kit/toss-payments/webhook';

Signature, parameters, and return type

type WebhookRejection = {
    readonly kind: 'invalid-signature';
    readonly signatureCount: number;
    readonly keysTried: number;
}
/** 위조 의심 — 저장된 secret과 불일치. */
 | {
    readonly kind: 'secret-mismatch';
    readonly orderId: string;
}
/** depositSecrets가 null 반환 — 승인 시 저장 누락. */
 | {
    readonly kind: 'unknown-order';
    readonly orderId: string;
} | {
    readonly kind: 'missing-config';
    readonly needed: 'securityKeys' | 'depositSecrets';
} | {
    readonly kind: 'untrusted-source-ip';
    readonly ip: string;
}
/** 서명·secret이 없는 이벤트에서 출처 IP 미제공 — 기본 fail-closed. */
 | {
    readonly kind: 'missing-source-ip';
} | {
    readonly kind: 'invalid-transmission-time';
    readonly value: string;
} | {
    readonly kind: 'stale-transmission-time';
    readonly value: string;
}
/** 동일 이벤트가 아직 처리 중 — 어댑터는 503으로 재전송을 유도한다. */
 | {
    readonly kind: 'processing';
    readonly dedupeKey: string;
} | {
    readonly kind: 'parse-failed';
    readonly detail: string;
} | {
    readonly kind: 'store-failure';
    readonly cause: unknown;
};

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/toss-payments
• Version: 0.6.1
• Public entry: ./webhook
• Source: GitHub