Eximbay
Eximbay payment window integration guide
1. Configure Eximbay PG settings
Refer to the Eximbay 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 and mobile browsers, callback is invoked after calling IMP.request_pay(param, callback)
.
Javascript SDKIMP.request_pay( { pg: "eximbay", pay_method: "card", merchant_uid: "{Merchant created Order ID}", // Example: order_no_0001 name: "Order name: Test payment request", amount: 14.2, currency: "USD", buyer_email: "iamport@siot.do", buyer_name: "John Doe", buyer_tel: "010-1234-5678", // Required buyer_addr: "Shinsa-dong, Gangnam-gu, Seoul", buyer_postcode: "123-456", }, 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
eximbay
.
pay_method
* string
Payment method code
Payment method codes
Payment method codes
card
(credit card)wechat
card
(foreign credit card)unionpay
tenpay
econtext
(payment via Japanese convenience store)
merchant_uid
* string
Order ID
Must be unique for each request.
buyer_tel
*string
Customer phone
amount
* integer
Payment amount
Must be an integer (not string)
currency
string
Currency
- KRW
- USD
- EUR
- GBP
- JPY
- THB
- SGD
- RUB
- HKD
- CAD
- AUD
language``
string
- Korean : ko
- English : en
- Chinese : zh
- Japanese : jp
Note
iโmport does not support Eximbay subscription payment.
How to test convenience store payment
How to test convenience store payment
Convenience store payment method
As with virtual accounts in Korea, payment is processed at the convenience store counter using the message sent to the customer by e-mail or text message after requesting payment via the payment window.
- iโmport internally sets pay_method : vbank
- Sends callback and webhook to notify that Econtext has been created (status: ready / vbank_num is fixed as unknown)
- When Econtext confirms payment deposit, iโmport receives a response from Eximbay, changes status to
paid
, and sends a webhook for post-payment processing
Convenience store payment test procedure
As with the virtual account, you need to test the result of the customerโs deposit and receive a notification upon deposit.
-
Set Eximbay test mode to
ON
and proceed with the payment window. -
Write down the
pg_tid
value from the callback response (check the value from the PG approval number column in the iโmport Admin console) -
Log in from http://test.econ.ne.jp/site/tuchi_2/tuchi_menu_2.html
(ID: ectest / password: #eg0810# ) -
ShopID : 361301, orderID :
pg_tid
(from step 2) -
Click ็ป้ฒ button at the bottom
-
On the next page, click ็ป้ฒ button
-
Wait 10 minutes and then check that the status is changed to paid (at this point, webhook is sent to notify of the deposit)