站內付 SDK (JS) ​

應用場景 ​

使適用於前端 Web，提供廠商站內付金流功能。

使用方式 ​

(1) 引用外部 JS 元件: ​

javascript
<script src=" https://code.jquery.com/jquery-3.5.1.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/node-forge@0.7.0/dist/forge.min.js"></script>

(2) 引用歐買尬金流 JS 元件 ​

  • 正式環境：
javascript
<script src="https://ecpg.funpoint.com.tw/Scripts/sdk-1.0.0.src.js?t=20210121100116"></script>
  • 測試環境：
javascript
<script src="https://ecpg-stage.funpoint.com.tw/Scripts/sdk-1.0.0.src.js?t=20210121100116"></script>

※ 注意事項：

(1) 引用 歐買尬金流 JS 元件時，必須放在 <div id="funpointPayment"></div> 的後面。

(3) Html區塊定義: ​

html
<div id="funpointPayment"></div>	//呈現付款方式畫面

※ 注意事項：

(1) 引用定義 CSS 參數時，請勿與站內付 SDK 定義的相同，請參考CSS 參數定義列表。

(4) Initialize: 初始化 SDK，環境參數請參考下段說明。 ​

javascript
funpoint.initialize( ServerType, callBack(errMsg))

帶入參數 ​

參數 / 型態參數名稱說明
*ServerType
String		環境參數Stage：測試環境 funpoint.ServerType.Stage
Prod：正式環境 funpoint.ServerType.Prod
*callBack
Function		CallBack執行回呼函式
1. errMsg - 執行失敗時，可在 callBack 接收錯誤訊息
2. 需於此處呼叫 funpoint.createPayment

(5) GetPayToken: 取得付款代碼(PayToken) ​

javascript
funpoint.getPayToken( callBack( paymentInfo, errMsg ))

回傳參數 ​

參數 / 型態參數名稱說明
PaymentInfo
JSON		付款資訊 
PayToken
String(64)		付款代碼付款代碼；
有效期限為 30 分鐘
（取得付款代碼後，用法請參考 建立交易）
PaymentType
String(20)		使用者選擇的付款方式● CreditCard：信用卡一次付清
● CreditInstallment：信用卡分期付款
● ATM：ATM
● CVS：超商代碼
● Period：信用卡定期定額
● UnionPay：銀聯卡
callBack
Function		callBack● paymentInfo - 執行成功時，可取得付款設定
● errMsg - 執行失敗時，可在 callBack 接收錯誤訊息

(6) CreatePayment: 取得站內付 2.0 功能畫面 ​

javascript
funpoint.createPayment(Token, Language, callBack(errMsg) )

帶入參數 ​

參數 / 型態參數名稱說明
*Token
String(64)		廠商驗證碼初始化站內付 2.0 畫面代碼。（此參數具 30 分鐘時效性）
*Language
String(10)		多語系可使用以下方式設定使用語系：
● 繁中：funpoint.Language.zhTW
● 英語：funpoint.Language.enUS
*callback
Function		CallbackerrMsg - 執行失敗時，可在 callBack 接收錯誤訊息，成功時該參數為 null

(7) GetLanguage: 取得設定語系 ​

javascript
funpoint.getLanguage()

回傳參數 ​

內容說明
zh-TW，en-US切換語系時，可取出於 SDK 目前設定的語系 ( 預設 : zh-TW )

範例程式 ​

javascript
//初始化 SDK
funpoint.initialize( serverType, function (errMsg) {
    var lang = getCookie("language");

    if (!lang) { lang = funpoint.Language.zhTW; }

    funpoint.createPayment(
        "55a026b8df314f9bb2dc808a5fe21c9d", /* Token 廠商驗證碼*/
        lang, 
        function (errMsg) {
            if (errMsg != null)
            {
            /*請依實際需求自行處理失敗結果*/
            }
        }
    );