用Rails從零開始串金流-以藍新API為例(1)前置作業:註冊帳號、技術串接手冊閱讀

**小提醒:此文為觀念分享,不見得能直接適用你的專案,請各位看倌走過路過各取所需,歡迎交流🎈,祝大家能順利收到全天下的錢。💰💰💰

首先,你的專案主題是電商網站,串金流是一個重要技術,畢竟網站再美,不能收錢都是枉然。在一陣餵狗(google)流程後,你選了家看得順眼的公司,硬著頭皮打開金流平台的網站。來到這個頁面。

https://www.newebpay.com/website/Page/content/download_api

心裡想說太好了,還好API文件可以看,不用通靈。😂 如果不知道API是什麼的可以先去看以下的影片:

這不是笑話,真的有公司沒提供API的。但對於菜鳥工程師來說,第一次看API也跟天書沒兩樣,因為它打開來就是一堆表格,長這樣:

藍新金流Newebpay_MPG串接手冊_MPG_1.0.6

串接文件的重點、在於告訴你它需要的必填參數、以及金流的運作原理(flow)。這裡是以信用卡支付作為例子:

藍新金流Newebpay_MPG串接手冊_MPG_1.0.6

大略掃過一遍後,你會覺得有講等於沒講,但之後進入coding就會知道邏輯所在,先別急~按照手冊裡的網址先去藍新的測試平台註冊。

藍新金流Newebpay_MPG串接手冊_MPG_1.0.6

因為測試平台跟正式平台乍看之下長的一樣,所以小心不要跑錯網址,記得測試網址起頭是”cwww” 而不是 ”www”。進入註冊頁面,我們的目的是要串API,所以請選企業會員👉

https://cwww.newebpay.com/

我們的目的是跑測試,所以填寫內容就大家自由發揮,會過就好,註冊流程跑完,就可以登入做基本設定啦👏

https://cwww.newebpay.com/

登入後進入會員中心➡️商店管理➡️執行➡️詳細資料

https://cwww.newebpay.com/

藍新的後台很多設定可以調整,但不要搞死自己先開放信用卡就好。基本上都是下拉式選單,隨君挑選,基本上這裡的設定會決定結帳頁面出現什麼,所以開關就在這裡決定就好(更細緻的跳轉頁面是另一回事)。以測試平台來說,幾乎市面上所有的支付都含括了。不要問我為啥沒有LINE PAY😂

https://cwww.newebpay.com/

接著是我們的串接的重頭戲~金鑰的取得,藍新還有提供API的回傳URL,但要注意的是,這裡不能使用localhost,要有實際的網址才行,因應這個需求,可以使用虛擬網址的套件 Ngork,可以參考這篇:

不過我當時裝有點卡住,只好去跟助教求救,之後再寫一個極短篇來講解。

https://cwww.newebpay.com/

咦?所以我說那個rials呢?你讓我看到這裡,一行code都沒有是騙點閱嗎?

當我成功之後回頭重新順流程,發現要寫成文章,你還是必須要切換成當時那個啥都不懂的自己。因此還是決定從0開始寫,下一篇再開始進入coding。文件看懂是必須之痛,所以不要覺得你可以跳過這一段直接打code,有經驗的人也會得到這個結論。😩 May the coding be with you~

--

--

Jocelyn LEE
Jocelyn’s轉職工程師日誌

一名數位宅女,射手座。待過研究單位、美術館從事藝術推廣和藏品管理,主責過數位展示服務專案,目前正朝向把全端技能樹點滿的道路邁進。