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.
General payment request
Javascript SDK
pg : 'tosspay',
pay_method : 'card',
merchant_uid: '{Merchant created Order ID}', //Example: order_no_0001
name : 'Order name: Test payment',
amount : 14000,
buyer_email : '[email protected]',
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:
}, 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 window example
Toss simple payment is processed in mobile Toss App.
Last modified 9mo ago