Skip to main content

NaverPay

Configuration

Configure the following parameters for the Connector (see Connector Config - NaverPay):

  1. Fill in the mandatory Extra Data: ClientId
  2. Fill in the mandatory Extra Data: ClientSecret
  3. Fill in the mandatory Extra Data: ChainId
  4. Fill in the optional Extra Data: DefaultItemCategoryType - Overrides the categoryType sent to NaverPay on every item
  5. Fill in the optional Extra Data: DefaultItemCategoryId - Overrides the categoryId sent to NaverPay on every item

Data Fetcher Configuration

Setup and configure your Data Fetcher on a Provider (see section Enable and Set Up Reconciliation on the Provider Level)

Provider Settlement

The retrieved settlement report is a combination of the responses of NaverPay Individual Settlements & NaverPay Daily Settlements providing information about transaction settlement details & line items. The settlements of the previous day are available on NaverPay after 12:00 PM KST.

Configure the following Parameters for the Settlements Provider Data Fetcher to fetch Settlement.

  1. Fill in the optional Name
  2. Fill in the expected Interval in which the Provider Settlement File should be fetched - days, hours
  3. Select the Adapter NaverPay
  4. Enable Testmode to test fetching of Provider Settlements from the NaverPay Sandbox (URL used https://dev-pay.paygate.naver.com), disabled the NaverPay Production (URL https://pay.paygate.naver.com) environment is used. NaverPay currently does not provide any settlement files to fetch on the Sandbox environment.
  5. Fill in the mandatory Extra Data: ClientId: used for authentication
  6. Fill in the mandatory Extra Data: ClientSecret: used for authentication
  7. Fill in the mandatory Extra Data: ChainId: used for authentication

Settlement fields

Batch Number

The batch number is build from the configured ChainId & fetched settlement date: e.g.: ChainId-123_20260210.

Payment Reference

NaverPay does not provide any payment reference.

Mapped Fields

We are mapping the following fields from the NaverPay settlement reports (NaverPay → IXOPAY platform):

ProviderIXOPAY platformdefault (if not set by Provider)
settleCompleteDatetransaction settlement datedate time of processing
payHistIdtransaction adapter tx idnone - required
paySettleAmounttransaction settlement amount, (+)paySettleAmount = Debit (-)paySettleAmount = Refundnone - required
totalCommissionAmounttransaction commission fee amountnone
settleAmountLine Item - net-settlement-amountnone
commissionSettleAmountLine Item - actual-fee-amountnone