1. Configure KG INICIS settings

Refer to the KG INICIS settings page to configure the PG settings.

2. Request payment

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 escrow: true, // Settings when escrow payment vbank_due: "YYYYMMDD", bypass: { // When PC acceptmethod: "noeasypay", // Remove the Easypay checkout button from the integrated checkout window(PC) // acceptmethod: "cardpoint", // Settings when using card company points(PC) // When Mobile P_RESERVED: "noeasypay=Y", // Remove the Easypay checkout button from the integrated checkout window(Mobile) // P_RESERVED: "cp_yn=Y", // Settings when using card company points(Mobile) // P_RESERVED: "twotrs_bank=Y&iosapp=Y&app_scheme=your_app_scheme://", / /Go back to the app where the payment was made with account transfer on iOS }, period: { from: "20200101", //YYYYMMDD to: "20201231", //YYYYMMDD }, }, 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

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

3. Additional functions

javascript
{ "display": { "card_quota": [6] // Display up to 6 months installment plans } }

Parameters

  • card_quota :
    • []: Only immediate pay
    • 2,3,4,5,6: immediate, 2, 3, 4, 5, 6 month installment plans\

Installment plan option is available only for KRW 50,000 or more.