Developers
V1
V2

Toss

Toss simple payment integration guide

1. Configure Toss simple payment PG settings

Refer to the Toss simple pay 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: "tosspay", pay_method: "card", merchant_uid: "{Merchant created Order ID}", //Example: order_no_0001 name: "Order name: Test payment", amount: 14000, buyer_email: "iamport@siot.do", buyer_name: "Customer name", buyer_tel: "010-1234-5678", buyer_addr: "Samseong-dong, Gangnam-gu, Seoul", buyer_postcode: "123-456", m_redirect_url: "{URL to redirect to after payment approval}", //Example: http://yourservice.com/payments/complete }, 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 tosspay.

pay_method string

Payment method code

  • card (credit card)
  • trans (instant account transfer)

name * string

Product name

merchant_uid * string

Order ID

Must be unique for each request.

amount * integer

Payment amount

Must be an integer (not string)

Toss simple payment is processed in mobile Toss App.