Developers
V1
V2

Integrate payment

Payment integration management

  • Payment channel refers to the object of payment per credential issued by a PG. The merchant can use the payment channel directly or assign it to one of its sub-merchants.

  • Live integration: Enter the credential of the PG you selected and contracted through the online payment application to create a payment channel and use it to call imp.request_pay() to request payment.

  • Test integration: You can use test credentials for all PGs except Naver Pay, Toss, and PayPal. Get test credentials for Naver Pay, Toss, and PayPal directly from the PG.

  • From the payment integration page, you can add, view, and edit the above information for each merchant and its sub-merchants.

Webhook management

Webhook is required when using a virtual account or subscription payment, but it is also strongly recommended for a stable payment service. To configure a webhook:

  • Webhook (notification) URL: Merchant server URL to receive webhook notification.
  • Webhook test: Sends a test notification to the specified webhook URL.

Integration test management

  • In the integration test management, you can get the test Merchant ID and other credential information for each PG.

  • To test payment via a specific PG, call imp.request_pay(pg = 'Test PG.Test Merchant ID').

  • To test PGs like PayPal and Naver Pay, you need to get the test Merchant ID directly from the PG. From the PGโ€™s test card, click Edit information and enter the test Merchant ID.

Live integration management

  • Each live integration channel card can be created based on the PGโ€™s payment type requested through the online payment application. This means that you can create a card for entering the Merchant ID and other credentials issued by the PG according to the module. On the card, click Edit information and enter and save the information, and then proceed with the payment using the payment channel information.

  • Even for the same PG, you can create different modules depending on the payment method or payment type by entering the Merchant ID and other credentials on each channel card.

    • Payment type: PG issues a separate Merchant ID for each payment type as follows:

      • Payment window method (general/simple/subscription payment)
      • API method (key-in/subscription payment).
    • Payment method: PG issues a separate Merchant ID for each payment method.

    • A merchant can also request multiple MIDs in the contract.

Other settings

  • In the Other settings page, you can check the Whitelist settings and My ID and API keys.

  • Whitelist: In the iโ€™mport Admin, you must set the security whitelist setting to a CIDR block instead of an individual IP. \ For example, assume that you want to enter an IP of ๏ฟผ1.1.1.๏ฟผ. If you want to only allow this IP, enter ๏ฟผ 1.1.1.1/3๏ฟผ. If you want to allow the IP range from ๏ฟผ1.1.1.๏ฟผ ~๏ฟผ1.1.1.25๏ฟผ, enter ๏ฟผ1.1.1.0/2๏ฟผ. For more detailed notation information, refer to RFC4632.