NaverPay

This page provides an overview of the payments methods provided by the NaverPay adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating NaverPay within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment Method	Transaction Flows	Transaction Types
NaverPay	Full-Page Redirect	Debit, Refund, Partial-Refund

Additional Parameters

Debit

Parameter	Type	Required	Description
currency	String	true	Currency of the transaction (Accepted: KRW).
successUrl	String	true	Redirect to URL on success/pending.
extraData.productName	String	false	Main product name. (Default = first item name)
l2l3Data.taxDetails[]	Object	false	To declare a tax-free amount, set type to "tax_free_amount" and amount to the tax-free amount in KRW. Both fields are required together.

Item Parameters (Debit)

At least one item is required. The following parameters apply per item:

Parameter	Type	Required	Description
name	String	true	Name of the item.
identification	String	true	Identifier of the item. More information: NaverPay Product Item Details
quantity	Number	true	Quantity of the item. Has to be > 0.
extraData.categoryType	String	true	Category type of the item. Possible values: NaverPay Product Item Details
extraData.categoryId	String	true	Category id of the item. Possible values: NaverPay Product Item Details

Refund & Partial-Refund

Parameter	Type	Required	Description
currency	String	true	Currency of the transaction (Accepted: KRW).
extraData.cancelRequester	String	true	"1" = Buyer, "2" = Merchant admin.
description	String	true	Reason for refund.
l2l3Data.taxDetails[]	Object	false	To declare a tax-free amount, set type to "tax_free_amount" and amount to the tax-free amount in KRW. Both fields are required together.

Additional Postback Extra Data

Debit

Parameter	Value
extraData.paymentId	Mapped from body.detail.paymentId.
extraData.payHistId	Mapped from body.detail.payHistId.
extraData.primaryPayMeans	Mapped from body.detail.primaryPayMeans.
extraData.cardCorpCode	Mapped from body.detail.cardCorpCode.
extraData.cardNo	Mapped from body.detail.cardNo.
extraData.cardAuthNo	Mapped from body.detail.cardAuthNo.
extraData.cardInstCount	Mapped from body.detail.cardInstCount.
extraData.usedCardPoint	Mapped from body.detail.usedCardPoint.
extraData.bankCorpCode	Mapped from body.detail.bankCorpCode.
extraData.bankAccountNo	Mapped from body.detail.bankAccountNo.
extraData.userIdentifier	Mapped from body.detail.userIdentifier.

Refund & Partial-Refund

Parameter	Value
extraData.paymentId	Mapped from body.paymentId.
extraData.payHistId	Mapped from body.payHistId.
extraData.primaryPayMeans	Mapped from body.primaryPayMeans.

Additional Information

NaverPay requires a security check after completing the debit payment. This checks the initial sent amount and the received body.detail.totalPayAmount. If those values don't match the transaction will fail with an error even though the transaction was completed. This then requires a follow-up with the merchant and NaverPay.

References:

• NaverPay Developers Documentation