ConfirmResolution — @gj-kit/toss-payments

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

Verified import example

import { ConfirmResolution } from '@gj-kit/toss-payments/server';

Signature, parameters, and return type

/**
 * §3.7 confirm 실패 복구·안내 3분기 — "confirm Err ≠ 결제 실패"(G8).
 *
 * transport 실패(승인됐는데 응답 유실)·ALREADY_PROCESSED_PAYMENT(새로고침 이중 confirm)를
 * 일괄 실패 처리하면 "돈은 나갔는데 실패 안내"라는 최악의 CS 사고가 난다 — 조회로 진실을
 * 확정한 뒤 분기하라.
 */
type ConfirmResolution =
/** 조회로 DONE|WAITING_FOR_DEPOSIT 및 (가상계좌라면) secret까지 확인됨. */
{
    readonly resolution: 'actually-confirmed';
    readonly payment: ConfirmedPayment;
}
/** 결제는 확인됐지만 가상계좌 secret은 lookup으로 복구할 수 없다 — 주문 보류/운영 복구. */
 | {
    readonly resolution: 'confirmed-without-deposit-secret';
    readonly payment: ConfirmedWithoutDepositSecret;
}
/** NOT_FOUND_PAYMENT_SESSION(10분 초과) 등 — 결제 재요청 유도. */
 | {
    readonly resolution: 'retry-payment';
}
/** 조회로도 미승인 확정. */
 | {
    readonly resolution: 'definitively-failed';
    readonly error: ConfirmError;
};

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: ./server
• Source: GitHub