To open the payment window, call 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.
Javascript SDK
IMP.request_pay({
pg : 'html5_inicis',
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... *//
});
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 html5_inicis.
pay_method* string
Payment method code
Payment method codes
card (credit card)
trans(instant account transfer)
vbank(virtual account)
phone(mobile micropayment)
samsung(Samsung Pay hub-type)
kakaopay(Kakao Pay)
payco ( PAYCO hub-type)
tosspay (Toss Simple Pay hub-type)
ssgpay (SSG Pay hub-type)
chai (CHAI Pay)
lpay (LPAYhub-type)
naverpay (Naver Pay)
cultureland(Cultureland)
smartculture(Smart Culture)
happymoney(Happy Money)
merchant_uid* string
Order ID
Must be unique for each request.
amount* integer
Payment amount
Must be an integer (not string)
buyer_tel*string
Customer phone number
Required
You can request for a billing key through the KG INICIS payment window.
To open non-authenticated payment window, specify the customer_uid parameter.
After getting a billing key from the window, you can request payment using the billing key.
amount parameter is for display purpose only. Actual payment approval is not processed.
Javascript SDK
IMP.request_pay({
pg : 'html5_inicis',
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');
}
});
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 html5_inicis.
If you have multiple merchant IDs (each for general and subscription) issued by KG INCIS, set to html5_inicis.{Merchant ID} or inicis.{Merchant ID}(for ActiveX).
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
Amount to display in the payment window, but actual payment approval is not processed. (To request payment, use the REST API with the customer_uid.)
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 APIwith the customer_uid as follows:
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) with the customer_uid as follows:
