# NICE Payments ### 1. Configure NICE Payments PG settings Refer to the [**NICE Payments settings**](/docs-en/ready/2.-pg/payment-gateway-settings/nice-payments.md) page to configure the PG settings. ![](/files/fLoLRm5DzxkH2ans1FB5) ### 2. Request payment To open the payment window, call [JavaScript SDK](/docs-en/sdk/javascript-sdk.md) IMP.**request\_pay**(param, callback). In PC browsers, **callback** is invoked after calling `IMP.request_pay(param, callback)`. In mobile browsers, the page is redirected to **m\_redirect\_url**. {% tabs %} {% tab title="Authenticated payment request" %} {% code title="Javascript SDK" %} ```javascript IMP.request_pay({ pg : 'nice', pay_method : 'card', merchant_uid : '{Merchant created Order ID}', // Example: order_no_0001 name : 'Order name: Test payment request', amount : 14000, buyer_email : 'iamport@siot.do', buyer_name : 'John Doe', buyer_tel : '010-1234-5678', buyer_addr : 'Shinsa-dong, Gangnam-gu, Seoul', buyer_postcode : '123-456', m_redirect_url : '{Mobile only - URL to redirect to after payment approval}', // Example: https://www.my-service.com/payments/complete/mobile niceMobileV2 : true // Set to 'true' to enable new mobile version }, function(rsp) { // callback logic //* ...Omitted... *// }); ``` {% endcode %} #### Key parameter description **`pg`** **\***\*\* \*\***string** **PG code** * If not specified and this is the only PG setting that exists, `default PG` is automatically set. * If there are multiple PG settings, set to **`nice`**. **`pay_method`** **\***\*\* \*\***string** **Payment method code**
Payment method codes * `card` (credit card) * `trans`(instant account transfer) * `vbank`(virtual account) * `samsung`(Samsung Pay) * `phone`(mobile micropayment) * `kakaopay`(Kakao Pay) * `payco` ( PAYCO hub-type) * `naverpay` (Naver Pay)
**`merchant_uid`** **\***\*\* \*\***string** **Order ID** Must be unique for each request. **`amount`** **\***\*\* \*\***integer** **Payment amount** Must be an integer (not string). **` niceMobileV2`` `` `****`boolean`** Option to enable new NICE mobile version (default: false) **` escrow`` `` `****`boolean`** **Ecrow option** {% embed url="" %} NICE Payments payment window {% endembed %} {% endtab %} {% tab title="Non-authenticated API request" %} **You can use i'mport REST API to request billing key, request payment, and schedule payment.** #### Request one-time payment To request a one-time payment, use the key-in REST[ **API POST /subscribe/payments/onetime**](/docs-en/api/api/request-non-authenticated-payment-one-time-api.md). The card information is not saved during this process. ``` curl -H "Content-Type: application/json" \ -X POST -d '{"merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \ https://api.iamport.kr/subscribe/payments/onetime ``` #### #### Request billing key To request a billing key, use the billing key request REST [**API POST /subscribe/customers/{customer\_uid}**](/docs-en/api/billing-key-api/api-1.md). ``` curl -H "Content-Type: application/json" \ -X POST -d '{"card_number":"1234-1234-1234-1234", "expiry":"2025-12", "birth":"820213", "pwd_2digit":"00"}' \ https://api.iamport.kr/subscribe/customers/your-customer-unique-id ``` #### Request billing key + initial payment To request a billing key and initial payment, use the key-in REST [**API POST /subscribe/payments/onetime**](/docs-en/api/api/request-non-authenticated-payment-one-time-api.md). * **`customer_uid`** : required for saving the billing key. ``` curl -H "Content-Type: application/json" \ -X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "card_number":"1234-1234-1234-1234", "expiry":"2019-01", "birth":"123456", "amount":3000}' \ https://api.iamport.kr/subscribe/payments/onetime ``` #### Request payment with billing key After successfully getting the billing key and making the initial payment, the billing key is stored on the i'mport server mapped 1:1 with the specified `customer_uid`. For security reasons, the server cannot directly access the billing key. Subsequent payments can be requested by calling the repeat pay REST API ([**POST /subscribe/payments/again**](/docs-en/api/api/api.md)) with the `customer_uid` as follows: ``` curl -H "Content-Type: application/json" \ -X POST -d '{"customer_uid":"your-customer-unique-id", "merchant_uid":"order_id_8237352", "amount":3000}' \ https://api.iamport.kr/subscribe/payments/again ``` {% hint style="info" %} **NICE Payments supports non-authenticated payments only through the API method.** To integrate non-authenticated payments, you need to provide a UI for accepting user's card information. For more information, refer to the [**REST API**](/docs-en/auth/guide-1/bill/rest-api.md) page. {% endhint %} {% endtab %} {% endtabs %} ### 3. Additional functions {% tabs %} {% tab title="Installment setting" %} {% code title="javascript" %} ```javascript display: { card_quota: [6] // Display up to 6 months installment plans } ``` {% endcode %} **Parameters** * **card\_quota :** * `[]`: Only immediate pay * `2,3,4,5,6`: immediate, 2, 3, 4, 5, 6 month installment plans {% hint style="info" %} Installment plan option is available only for **KRW 50,000 or more**. {% endhint %} {% embed url="" %} Example of enabling up to **3 month installment plans** {% endembed %} {% endtab %} {% tab title="Direct credit card module call" %} {% code title="javascript" %} ```javascript card: { direct: { code: "367", quota: 3 } } ``` {% endcode %} **Parameters** * **code**: [**Credit card code**](https://chaifinance.notion.site/53589280bbc94fab938d93257d452216?v=eb405baf52134b3f90d438e3bf763630) (**string**) * **quota**: Installment plan. For immediate, set to 0. (**integer**) {% hint style="danger" %} **Precautions** * Some PGs do not support direct call to credit card company's payment windows for all Merchant IDs. You must check your Merchant ID with each PG for direct call support. {% endhint %} {% embed url="" %} Example of direct call to **Hyundai Card** module {% endembed %} {% endtab %} {% tab title="Enable specific credit cards" %} {% code title="javascript" %} ```javascript card : { detail : [ {card_code:"*", enabled:false}, // Disable all credit cards {card_code:'366', enabled:true} // Enable specific credit card ] } ``` {% endcode %} **Parameters** * **card\_code:** [**Credit card code**](https://chaifinance.notion.site/53589280bbc94fab938d93257d452216?v=eb405baf52134b3f90d438e3bf763630) (**string)** * **enabled:** Option to enable the credit card (**boolean)** {% embed url="" %} Example of showing only **Shinhan Card** in the payment window {% endembed %} {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://portone.gitbook.io/docs-en/payment-integration-by-pg/payment-gateways/nice.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.