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 SDKIMP.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
Required3. Additional functions
javascript{ "display": { "card_quota": [6] // Display up to 6 months installment plans } }
Parameters
- card_quota :
[]
: Only immediate pay2,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.