Ctrlk
X2BEE Home
For the complete documentation index, see llms.txt. This page is also available as Markdown.
RSS feed

Release Notes (2026-03-30 – 2026-02-09)

Continuation of Release Notes — covers releases from 2026-03-30 to 2026-02-09.

Improvement

Identity Verification System Migration: migrated NICE identity verification to the new integrated authentication method, and improved the FO/member API integration structure to strengthen authentication stability and processing accuracy.

1. NICE Identity Verification Migrated to New Integrated Authentication

In this release, migration to the new integrated authentication method of the NICE identity verification service was completed. The authentication integration structure across FO and the member APIs was overhauled to match the latest specification, increasing authentication stability, and strengthening the accuracy and consistency of authentication result processing.

View Details

Key Details

  • [Common] As the NICE identity verification service moved to a new version, the identity verification integration method for both FO and the member APIs was migrated together

  • [FO] Changed so that clicking the identity verification button opens a popup to the new authentication page provided by NICE, instead of the previous method

  • [FO] Improved the way results are received after authentication completes, so that authentication results are not processed twice or dropped

  • [FO] Kept the same flow of navigating to the sign-up / already-registered notice / re-registration restriction / member information mismatch screens based on the authentication result

  • [API-MEMBER] Overhauled authentication request and result receipt handling to match the new NICE specification

  • [API-MEMBER] Changed so that authentication result values (name, date of birth, gender, domestic/foreign national, carrier, etc.) are organized into a form matching member information before being returned

  • [API-MEMBER] Unified the response format delivered to the user when an error occurs during the authentication process

Screen Path

  • (Changed) FO > Member > Identity Verification Popup

  • (Changed) FO > Member > Identity Verification Result Processing Page

  • (Changed) FO > Sign Up > Post-Verification Sign-Up/Notice Branch Screen

Target APIs

  • [api-member][Changed] NICE identity verification request API View API

  • [api-member][Changed] NICE identity verification result lookup View API

Source Change List

api-member

  • /src/main/java/com/x2bee/api/member/app/constant/Constants.java

  • /src/main/java/com/x2bee/api/member/app/controller/member/MemberController.java

  • /src/main/java/com/x2bee/api/member/app/service/member/MemberServiceImpl.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/VerificationService.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/VerificationServiceImpl.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/model/VerificationAuthResultResponse.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/model/VerificationMakeKeyRequest.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/model/VerificationResponse.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/model/VerificationReturnDataRequest.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/model/VerificationReturnDataResponse.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/nice/NiceApiUtil.java

  • /src/main/java/com/x2bee/api/member/app/service/verification/nice/NiceAuth.java

fo

  • next.config.ts

  • src/api/member/auth-api.ts

  • src/app/[locale]/(root)/common/(empty

  • page)/verification-return/page.tsx

  • src/app/[locale]/(root)/goods/layout.tsx

  • src/app/[locale]/(root)/login/layout.tsx

  • src/app/[locale]/(root)/member/layout.tsx

  • src/app/[locale]/(root)/order/order/layout.tsx

  • src/components/member/personal-info/personal-info-edit-v2.tsx

  • src/components/member/verification/verification-button.tsx

  • src/components/member/verification/verification-popup.tsx

  • src/contexts/verification-context.tsx

  • src/hooks/member/use-verification.ts

  • src/types/member/verification-types.ts

Improvement

Taxable/Tax-Exempt Process Enhancement: improved so taxable/tax-exempt amounts are handled separately throughout the entire order, payment, claim, refund, and proof-document issuance process, strengthening payment and settlement accuracy.

1. Taxable/Tax-Exempt Process Development

In this release, the payment process was enhanced so that taxable/tax-exempt amounts are accurately separated throughout the entire order and claim process. On the FO side, the tax-exempt amount is pre-calculated before payment, and at the API level, the taxable/tax-exempt amounts are managed consistently through order, refund, and proof-document issuance, greatly improving PG integration and settlement accuracy.

View Details

Key Details

  • [FO] Improved so the tax-exempt amount lookup API is called upon entering the order sheet, pre-calculating the tax-exempt amount to be used at payment

  • [FO] Separated taxable/tax-exempt amounts and passed them to the PG (Toss, Inicis) during order and claim (cancellation/return/exchange) payment

  • [FO] Recalculated the tax-exempt amount and passed it to the PG during claim submission and additional payment

  • [API-ORDER] Determines the taxable/tax-exempt status of products and shipping fees at order creation time and stores it in the payment information

  • [API-ORDER] Accurately allocates amounts by taxable/tax-exempt ratio during payment allocation, and recalculates the taxable/tax-exempt amounts and passes them to the PG even during partial refunds

  • [API-ORDER] Separates taxable/tax-exempt amounts when issuing cash receipts and tax invoices

Target APIs

  • [api-order][Added] Payment - payment allocation info lookup View API

  • [api-order][Added] Order - tax-exempt amount lookup View API

  • [api-order][Changed] Order - order creation View API

  • [api-order][Changed] Claim - return acceptance View API

  • [api-order][Changed] Claim - exchange acceptance View API

  • [api-order][Changed] Order cancellation - order cancellation View API

  • [api-order][Changed] Order return - return completion View API

Source Change List

api-order

  • api-order-app/src/test/java/com/x2bee/api/order/app/service/order/document/DocumentInvoiceServiceImplTest.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/controller/document/DocumentController.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/controller/order/OrderSheetController.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/controller/payment/PaymentDivController.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/claim/OpOrdPayDivRequest.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/order/SinglePriceResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/payment/InicisCancelRequest.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/payment/PaymentOrderInfo.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/payment/TossCancelRequest.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/request/payment/inicis/v2/InicisRefundData.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/document/PayDivInfo.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/mypage/OrderDetailGoodsInfoResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/mypage/OrderDetailPayInfoResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/order/tax/CancelTaxInvoicePriceResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/InicisPcResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/PaymentCancelInfo.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/PaymentClaimResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/TossCancelResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/TossResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/dto/response/payment/VBankResponse.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/entity/order/OpOrdPayBase.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/entity/order/OpOrdPayDivInfo.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/enums/product/PR007.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/repository/orderrodb/payment/OpOrdPayBaseMapper.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/repository/orderrodb/payment/OpOrdPayDivInfoMapper.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/ClaimExternalServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/creator/impl/ReturnTransformModelCreator.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/creator/payment/ClaimDeliveryFeeCancelPaymentDivider.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/creator/payment/ClaimWithdrawPaymentDivider.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/creator/payment/OrderCancelPaymentDivider.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/creator/payment/ReturnCompletePaymentDivider.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/claim/module/strategy/validator/ClaimCommonValidator.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/document/DocumentQueryService.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/document/DocumentQueryServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/DocumentService.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/cashReceipt/DefaultCashReceiptServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/cashReceipt/InicisCashReceiptServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/issuer/factory/DocumentIssuerFactory.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/taxInvoice/DefaultTaxInvoiceServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/document/taxInvoice/PopbillTaxInvoiceServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/register/OrderService.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/register/OrderServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/register/after/OrderCommonAfterProcess.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/register/creator/payment/OpOrdPayDivInfoCreator.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/sheet/OrderSheetService.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/order/sheet/OrderSheetServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/InicisVBankServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/module/PaySaveServiceImpl.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/module/strategy/pgway/impl/InicisMoStrategy.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/module/strategy/pgway/impl/InicisPcStrategy.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/util/InicisApiReqMaker.java

  • api-order-core/src/main/java/com/x2bee/api/order/app/service/payment/util/TossRequestCreator.java

  • api-order-core/src/main/java/com/x2bee/api/order/base/advice/PaymentApiError.java

  • api-order-core/src/main/resources/mapper/orderrodb/order/OpOrdBaseMapper.xml

  • api-order-core/src/main/resources/mapper/orderrodb/order/OpTaxinvoiceLinkInfoMapper.xml

  • api-order-core/src/main/resources/mapper/orderrodb/payment/OpOrdPayDivInfoMapper.xml

  • api-order-core/src/main/resources/mapper/orderrwdb/payment/OpOrdPayBaseTrxMapper.xml

  • api-order-core/src/main/resources/message/order/paymentCommon.properties

  • api-order-core/src/main/resources/message/order/paymentCommon_en.properties

  • api-order-core/src/main/resources/message/order/paymentCommon_ko.properties

fo

  • .env.development.set

  • .env.local.set

  • .env.production.set

  • .env.stage.set

  • next.config.ts

  • src/api/order/order-api.ts

  • src/api/order/payment-api.ts

  • src/components/claim/accept/accept-additional-fee-payment.tsx

  • src/components/claim/common/claim-refund-payment-info.tsx

  • src/components/claim/common/proof-doc-apply.tsx

  • src/components/claim/modal/claim-fee-payment.tsx

  • src/components/order/order/order-sheet.tsx

  • src/components/order/order/payment.tsx

  • src/components/order/order/pg-interface-module.tsx

  • src/constants/claim/claim-constants.ts

  • src/lib/claim/utils/claim-accept-util.ts

  • src/types/claim/claim-types.ts

  • src/types/order/billing-card-detail-types.ts

  • src/types/order/order-types.ts

  • src/utils/order/pg-inicis-utils.ts

  • src/utils/order/pg-toss-utils.ts

PreviousRelease Notes (2026-04-17 – 2026-04-10)
NextRelease Notes (2026-01-14)