# JTNET ### 1. Configure JTNet settings Refer to the [**JTNET settings**](/docs-en/ready/2.-pg/payment-gateway-settings/jtnet.md) page to configure the PG settings. ![](/files/iP9OklZXPkn714kbZQB7) ### 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 : 'jtnet', 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 }, 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 **`jtnet`**. **`pay_method`** **\***\*\* \*\***string** **Payment method code**
Payment method codes * `card` (credit card) * `trans`(instant account transfer) * `vbank`(virtual account) * `phone`(mobile micropayment)
**`merchant_uid`** **\***\*\* \*\***string** **Order ID** Must be unique for each request. **`amount`** **\***\*\* \*\***integer** **Payment amount** Must be an integer (not string) {% embed url="" %} {% endtab %} {% tab title="Non-authenticated payment request" %} To open non-authenticated payment window, specify the **customer\_uid** parameter. {% hint style="danger" %} **amount** * If requesting **both billing key and initial payment**, specify the payment amount. * If only requesting for billing key, set to **0**. {% endhint %} {% code title="Javascript SDK" %} ```javascript IMP.request_pay({ pg : 'jtnet', pay_method : 'card', // only 'card' supported. merchant_uid : '{Merchant created Order ID}', // Example: issue_billingkey_monthly_0001 name : 'Initial billing key request', amount : 0, // For display purpose only (no payment approval). customer_uid : '{Unique ID for the card (billing key)}', // Required (Example: gildong_0001_1234) buyer_email: "johndoe@gmail.com", buyer_name: "John Doe", buyer_tel : '02-1234-1234', m_redirect_url : '{redirect URL}' // Example: https://www.my-service.com/payments/complete/mobile (for mobile only) }, function(rsp) { if ( rsp.success ) { alert('Success'); } else { alert('Failed'); } }); ``` {% 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 **`jtnet`**. > **`customer_uid`** **\***\*\* \*\***string** **Credit card billing key** Billing key to be mapped 1:1 with the user-entered credit card information. **`amount`** **\***\*\* \*\***Integer** **Payment amount** 0: only billing key, **> 0: billing key + initial payment**\\ #### Request payment with billing key (customer\_uid) After successfully getting the billing key, 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 [**non-authenticated payment request REST API**](/docs-en/api/api/api.md) with the `customer_uid` as follows: {% code title="sever-side" %} ``` 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 ``` {% endcode %} {% 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 ``` **For detailed information, refer to:** {% content-ref url="/pages/w7yF516zjWzAAzC2X7LE" %} [Non-authenticated payment](/docs-en/auth/guide-1.md) {% endcontent-ref %} {% endtab %} {% endtabs %} ### 3. Additional functions {% tabs %} {% 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)** {% 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/jtnet.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.