# JTNET ### 1. Configure JTNet settings Refer to the [**JTNET settings**](https://portone.gitbook.io/docs-en/ready/2.-pg/payment-gateway-settings/jtnet) page to configure the PG settings. ![](https://2814812280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhTv8JEzyM5h4cYcL5StH%2Fuploads%2FQjetQctKP48IpPH1UAEl%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202022-05-31%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2012.07.01.png?alt=media\&token=93018de2-b547-4638-a4e1-1a936eec5087) ### 2. Request payment To open the payment window, call [JavaScript SDK](https://portone.gitbook.io/docs-en/sdk/javascript-sdk) 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**](https://portone.gitbook.io/docs-en/api/api/api) 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**](https://portone.gitbook.io/docs-en/api/api/request-non-authenticated-payment-one-time-api). 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}**](https://portone.gitbook.io/docs-en/api/billing-key-api/api-1). ``` 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**](https://portone.gitbook.io/docs-en/api/api/request-non-authenticated-payment-one-time-api). * **`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**](https://portone.gitbook.io/docs-en/api/api/api)) 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="../../auth/guide-1" %} [guide-1](https://portone.gitbook.io/docs-en/auth/guide-1) {% 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 %}