NAV
docs

Getting Started

Portal

App Registration

1. 到 Portal 網站登入您的帳號

第一步

2. 於左方點選 “Application”

第二步

3. 點選上方的 “Edit App”

第三步

4. 填入您 App 的資料並送出

根據您的 OS 填入 Android, iOS 或網站 Bundle Package Name 為您 App 的獨立名字(如: tw.com.example.app)
Domain Name 為您網站的網域名字

第四步

5. 這邊可找到您的 app ID, app key, 跟 bundle name

第五步


Merchant Registration

1. 到 Portal 網站登入您的帳號

第一步

2. 於左方點選 “Merchant”

第二步

3. 於 “Merchants” 底下點選 “Create Merchant”

只有正式環境可以創建商家,測試環境請使用預設的測試商家
測試環境具有正式環境一切的功能,但所有交易為模擬交易,無正式金流

第三步

4. 填選銀行資料後送出

欄位名稱 欄位內容
Connected Acquirer 收單銀行
Acquirer Account 收單帳號

第四步


IP Registration

1. 到 Portal 網站登入您的帳號

第一步

2. 於左方點選 “System Setting”

第二步

3. 於上方選擇 “Environment”

第三步

4. 選擇對應的環境

Sandbox 為測試環境,Production 為實體上線的環境
兩者接收的 IP 將會不同

第四步

5. 填入您伺服器的資訊並儲存

此 IP 將綁定您伺服器的 IP 到我們的伺服器上
您可輸入多個 IP 並用分號(;)隔開
反斜線後面的數字為子網路遮罩(0~32)
每個 IPv4 的 IP 為 32 位元: 8位元.8位元.8位元.8位元
以十進位表示的話,總範圍為 0.0.0.0 ~ 255.255.255.255
子網路遮罩將決定前幾個位元必須符合您所設定的 IP
請參考以下範例:

IP 子網路遮罩 所接受 IP
1.2.3.4/0 0 0 個位元必須符合 IP,等同於無限制
1.2.3.4/8 8 8 個位元必須符合 IP,因此只有 1 開頭的 IP 會被接受 (1.0.0.0 ~ 1.255.255.255)
1.2.3.4/16 16 16 個位元必須符合 IP,因此只有 1.2 開頭的 IP 會被接受 (1.2.0.0 ~ 1.2.255.255)
1.2.3.4/24 24 24 個位元必須符合 IP,因此只有 1.2.3 開頭的 IP 會被接受 (1.2.3.0 ~ 1.2.3.255)
1.2.3.4/32 32 32 個位元必須符合 IP,因此只接受 1.2.3.4 此組 IP

第五步


People Registration

1. 到 Portal 網站登入您的帳號

第一步

2. 於左方點選 “People”

第二步

3. 點選上方的 “Create People”

第三步

4. 您可在此新增新帳戶並更改他們的權限

您可使用我們預設的權限,或是自行調整
以下為您可以改變的權限:

名稱 內容
測試環境商家權限 “商家管理” 頁面中,sandbox 環境的權限
正式環境商家權限 “商家管理” 頁面中,production 環境的權限
測試環境交易紀錄權限 “交易紀錄” 頁面中,sandbox 環境的權限
正式環境交易紀錄權限 “交易紀錄” 頁面中,production 環境的權限
測試環境交易錯誤詳細資訊權限 “交易紀錄” 頁面中,在 sandbox 環境中查看錯誤訊息的權限
正式環境交易錯誤詳細資訊權限 “交易紀錄” 頁面中,在 production 環境中查看錯誤訊息的權限
測試環境設定權限 “系統設定” 頁面中,sandbox 環境的權限
正式環境設定權限 “系統設定” 頁面中,production 環境的權限
Apple Pay 頁面權限 “Apple Pay” 頁面的權限
Android Pay 頁面權限 “Android Pay” 頁面的權限
Link Pay 頁面權限 “Link Pay” 頁面的權限
資訊頁面權限 “帳戶資訊” 頁面的權限
產品頁面權限 “應用程式” 頁面的權限
帳號頁面權限 “帳戶權限” 頁面的權限
帳目頁面權限 “帳單目錄” 頁面的權限
登入時需做二次驗證 如果開啟的話,每次登入前都必須經過 email 驗證
權限等級 創造 讀取 更新 刪除
Write O O O O
Read X O X X
No Permission X X X X

第四步


Merchant Notification

1. 到 Portal 網站登入您的帳號

第一步

2. 於左方點選 “Merchant”

第二步

3. 點選您欲開啟通知的商家

第三步

4. 填選客服資料後送出

第四步


Portal: Samsung Merchant Registration (僅限 InApp)

1. 登入 Portal 並前往 Samsung Pay 頁面

2. 點擊「新增 Samsung Pay 商家」

3. 填入自定義的 Samsung Pay 商家識別碼

4. 點擊下載 CSR 以在 Samsung Pay Developer 新增 Service

Samsung Pay Developer (僅限 InApp)

請先註冊 Samsung Pay Developer 帳號,依照下列教學完成環境設定:

1. 登入 Samsung Pay Developer 並前往「MY PROJECTS -> Service Management」(https://pay.samsung.com/developers/projects/prdnsvc)

2. 點擊 CREATE NEW SERVICE

3. 選擇 For test

4. 選擇 InApp Online Payment Service (Direct, InDirect)

5. 在 PAYMENT GATEWAY 欄位選擇 TapPay,並在 CSR 欄位上傳從 TapPay Portal 下載的 CSR

6. 填寫 App 資訊

7. 點擊 GENERATE NEW KEY 並設定 TEST ACCOUNTS

8. 點擊 Service Detail 以複製 SERVICE ID 及 DEBUG API KEY 供前端使用