TossPay.authorize

함수형 API checkoutPayment로도 같은 기능을 쓸 수 있어요. 함수형 API는 v2와 같은 { params: { payToken } } 형태의 인자를 받아요.

기능 설명

토스페이 결제창을 띄우고 사용자 인증을 수행해요. 인증이 완료되면 성공 여부를 반환해요.

실제 결제 승인은 서버에서 payToken으로 별도 처리해야 해요.

타입

TossPay.authorize(params: CheckoutPaymentOptions): Promise<CheckoutPaymentResult>;

Params

type CheckoutPaymentOptions = {
  /** 결제 토큰이에요. */
  payToken: string;
};

Response

type CheckoutPaymentResult = {
  /** 인증이 성공했는지 여부예요. */
  success: boolean;
  /** 인증이 실패했을 경우의 이유예요. */
  reason?: string;
};

예시 코드

import { TossPay } from "@apps-in-toss/web-framework";

async function handlePayment() {
  try {
    // 실제 구현 시 결제 생성 역할을 하는 API 엔드포인트로 대체해 주세요.
    const { payToken } = await fetch("/my-api/payment/create").then((res) =>
      res.json(),
    );

    const { success, reason } = await TossPay.authorize({ payToken });

    if (success) {
      // 실제 구현 시 결제를 실행하는 API 엔드포인트로 대체해 주세요.
      await fetch("/my-api/payment/execute", {
        method: "POST",
        body: JSON.stringify({ payToken }),
        headers: { "Content-Type": "application/json" },
      });
    } else {
      console.log("인증 실패:", reason);
    }
  } catch (error) {
    console.error("결제 인증 중 오류가 발생했어요:", error);
  }
}

document.querySelector("#pay-button").addEventListener("click", handlePayment);