결제창 에러 처리

<script src="https://js.bootpay.co.kr/bootpay-5.3.0.min.js"></script>
<script>
Bootpay.requestPayment({
    client_key: '[ Client Key ]',
    price: 50000,
    order_name: '나이키 운동화 외 2건',
    order_id: 'order_' + Date.now(),
    pg: 'nicepay',
    method: 'card',
    extra: {
        separately_confirmed: true,
        open_type: 'redirect',
        redirect_url: 'https://yoursite.com/order/result',
        // true면 오류 발생 시 부트페이 제공 결과 UI에 에러 내용을 표시합니다.
        display_error_result: true
    }
}).catch(function (data) {
    // cancel: 사용자가 결제창을 닫은 경우. 주문은 미결제 상태로 유지해야 합니다.
    // error: 결제 요청·승인 과정에서 오류가 발생한 경우. error_code, pg_error_code, message를 로그로 남깁니다.
    if (data.event === 'cancel') {
        keepOrderUnpaid(data)
        return
    }

    if (data.event === 'error') {
        logPaymentError(data.error_code, data.pg_error_code, data.message)
        showPaymentError(data.message)
    }
})
</script>html

Bootpay.requestPayment(viewController: self, payload: payload)
    .onIssued { data in
        // issued: 가상계좌 발급. 주문은 입금 대기 상태로 저장해야 합니다.
        self.savePendingVbankOrder(data)
    }
    .onConfirm { data in
        // confirm: 서버 승인 방식을 쓰면 receipt_id를 백엔드로 보내야 합니다.
        self.requestServerApproval(data)
        return false
    }
    .onDone { data in
        // done: 서버 승인(separately_confirmed: true)에서는 호출되지 않습니다.
        // 클라이언트 자동 승인 방식에서만 결제 완료 후 호출됩니다.
    }
    .onCancel { data in
        // cancel: 사용자가 결제창을 닫은 경우. 주문은 미결제 상태로 유지해야 합니다.
        self.keepOrderUnpaid(data)
    }
    .onError { data in
        // error: 결제 요청·승인 과정에서 오류가 발생한 경우.
        // error_code, pg_error_code, message를 로그로 남기고 재시도 흐름을 보여줍니다.
        self.logPaymentError(data)
        self.showPaymentError(data)
    }
    .onClose {
        // close: 결제창이 닫힌 경우. UI 상태만 정리하고 주문 확정 처리하면 안 됩니다.
        self.resetPaymentUi()
    }swift

Bootpay.init(supportFragmentManager)
    .setPayload(payload)
    .setEventListener(object : BootpayEventListener {
        override fun onConfirm(data: String): Boolean {
            requestServerApproval(data)
            return false
        }

        override fun onCancel(data: String) {
            // 사용자가 결제창을 닫은 경우. 주문은 미결제 상태로 유지해야 합니다.
            keepOrderUnpaid(data)
        }

        override fun onError(data: String) {
            // 결제 요청·승인 과정에서 오류가 발생한 경우.
            // data에서 error_code, pg_error_code, message를 확인해 로그로 남깁니다.
            logPaymentError(data)
            showPaymentError(data)
        }

        override fun onClose() {
            // close: 결제창이 닫힌 경우. UI 상태만 정리하고 주문 확정 처리하면 안 됩니다.
            Bootpay.removePaymentWindow()
        }

        override fun onIssued(data: String) {
            // issued: 가상계좌 발급. 주문은 입금 대기 상태로 저장해야 합니다.
            savePendingVbankOrder(data)
        }

        override fun onDone(data: String) {
            // done: 서버 승인(separately_confirmed: true)에서는 호출되지 않습니다.
            // 클라이언트 자동 승인 방식에서만 결제 완료 후 호출됩니다.
        }
    })
    .requestPayment()kotlin

Bootpay().requestPayment(
  context: context,
  payload: payload,
  onConfirm: (data) {
    // confirm: 서버 승인 방식을 쓰면 receipt_id를 백엔드로 보내야 합니다.
    requestServerApproval(data);
    return false;
  },
  onIssued: (data) {
    // issued: 가상계좌 발급. 주문은 입금 대기 상태로 저장해야 합니다.
    savePendingVbankOrder(data);
  },
  onDone: (data) {
    // done: 서버 승인(separatelyConfirmed: true)에서는 호출되지 않습니다.
    // 클라이언트 자동 승인 방식에서만 결제 완료 후 호출됩니다.
  },
  onCancel: (data) {
    // cancel: 사용자가 결제창을 닫은 경우. 주문은 미결제 상태로 유지해야 합니다.
    keepOrderUnpaid(data);
  },
  onError: (data) {
    // error: 결제 요청·승인 과정에서 오류가 발생한 경우.
    // data에서 error_code, pg_error_code, message를 확인해 로그로 남깁니다.
    logPaymentError(data);
    showPaymentError(data);
  },
  onClose: () => resetPaymentUi(),
);dart

Bootpay().requestPayment(
  context: context,
  payload: payload,
  onIssued: (data) {
    // issued: 가상계좌 발급. 주문은 입금 대기 상태로 저장해야 합니다.
    savePendingVbankOrder(data);
  },
  onDone: (data) {
    // done: 서버 승인(separatelyConfirmed: true)에서는 호출되지 않습니다.
    // 클라이언트 자동 승인 방식에서만 결제 완료 후 호출됩니다.
  },
  onCancel: (data) {
    // cancel: Flutter Web에서 결제창이 닫히면 주문은 미결제 상태로 유지해야 합니다.
    keepOrderUnpaid(data);
  },
  onError: (data) {
    // error: 결제 요청·승인 과정에서 오류가 발생한 경우.
    // redirect_url로 넘어온 error 결과도 서버에서 같은 기준으로 처리해야 합니다.
    logPaymentError(data);
    showPaymentError(data);
  },
  onClose: () => resetPaymentUi(),
);dart

<Bootpay
    ref={bootpay}
    client_key={'[ Client Key ]'}
    onConfirm={(data) => {
        // confirm: 서버 승인 방식을 쓰면 receipt_id를 백엔드로 보내야 합니다.
        requestServerApproval(data)
        return false
    }}
    onIssued={(data) => {
        // issued: 가상계좌 발급. 주문은 입금 대기 상태로 저장해야 합니다.
        savePendingVbankOrder(data)
    }}
    onDone={(data) => {
        // done: 서버 승인(separately_confirmed: true)에서는 호출되지 않습니다.
        // 클라이언트 자동 승인 방식에서만 결제 완료 후 호출됩니다.
    }}
    onCancel={(data) => {
        // cancel: 사용자가 결제창을 닫은 경우. 주문은 미결제 상태로 유지해야 합니다.
        keepOrderUnpaid(data)
    }}
    onError={(data) => {
        // error: 결제 요청·승인 과정에서 오류가 발생한 경우.
        // error_code, pg_error_code, message를 로그로 남기고 재시도 흐름을 보여줍니다.
        logPaymentError(data)
        showPaymentError(data.message)
    }}
    onClose={() => {
        // close: 결제창이 닫힌 경우. UI 상태만 정리하고 주문 확정 처리하면 안 됩니다.
        resetPaymentUi()
    }}
/>jsx