付款方式:裕富無卡分期

應用場景

特店提供消費者在綠界付款頁面自己選擇付款方式時 

  • Step 1. 特店:將ChoosePayment 選擇預設付款方式設定為BNPL
  • Step 2. 綠界:接受特店訂單並檢核資料,依特店開通的付款方式顯示付款選擇頁。
❗ 注意事項:
  • 若串接付款方式ChoosePayment 選擇為All 時可直接支援BNPL,無需調整串接程式。

API介接網址

  • 測試環境:https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5
  • 正式環境:https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5

HTTPS 傳輸協定

  • Content Type :application/x-www-form-urlencoded
  • HTTP Method :POST

特店傳入參數說明

MerchantID String(10)
特店編號 必填

MerchantTradeNo String(20)
特店訂單編號 必填

  • 特店訂單編號均為唯一值,不可重複使用。
  • 英數字大小寫混合

❗ 注意事項:

MerchantTradeDate String(20)
特店交易時間 必填

格式為:yyyy/MM/dd HH:mm:ss

PaymentType String(20)
交易類型 必填

請固定填入 aio

TotalAmount Int
交易金額 必填

  • 請帶整數,不可有小數點。
  • 僅限新台幣

❗ 注意事項:

  • 金額不可小於3000元或大於30萬元

TradeDesc String(200)
交易描述 必填

請勿帶入特殊字元。

ItemName String(400)
商品名稱 必填

商品名稱

  • 如果商品名稱有多筆,需在金流選擇頁一行一行顯示商品名稱的話,商品名稱請以符號#分隔。
  • 商品名稱字數限制為中英數400字內,超過此限制系統將自動截斷。
    詳細的使用注意事項請參考FAQ

ReturnURL String(200)
付款完成通知回傳網址 必填

  • ReturnURL為付款結果通知回傳網址,為特店server或主機的URL,用來接收綠界後端回傳的付款結果通知。
  • 當消費者付款完成後,綠界會將付款結果參數以幕後回傳到該網址。詳細說明請參考付款結果通知

❗ 注意事項:

  1. 請勿設定與Client端接收付款結果網址OrderResultURL相同位置,避免程式判斷錯誤。
  2. ReturnURL收到綠界後端回傳的付款結果通知後,請回應字串1|OK給綠界。
  3. 1|OK僅是廠商回應綠界是否收到通知,並不會改變付款狀態。
  4. 參數內容若有包含%26(&)及%3C(<) 這二個值時,請先進行urldecode() 避免呼叫API失敗。

ChoosePayment String(20)
選擇預設付款方式 必填

綠界提供下列付款方式:
  • BNPL:指定付款方式,使用裕富URICH分期付款方式。

CheckMacValue String
檢查碼 必填

請參考檢查碼機制

EncryptType Int
CheckMacValue加密類型 必填

請固定填入1,使用SHA256加密。

StoreID String(10)
特店旗下店舖代號

提供特店填入分店代號使用,僅可用英數字大小寫混合。

ClientBackURL String(200)
Client端返回特店的按鈕連結

消費者點選此按鈕後,會將頁面導回到此設定的網址

❗ 注意事項:

  1. 導回時不會帶付款結果到此網址,只是將頁面導回而已。
  2. 設定此參數,綠界會在付款完成或取號完成頁面上顯示[返回商店]的按鈕。
  3. 設定此參數,發生簡訊OTP驗證失敗時,頁面上會顯示[返回商店]的按鈕。
  4. 若未設定此參數,則綠界付款完成頁或取號完成頁面,不會顯示[返回商店]的按鈕。
  5. 若導回網址未使用https時,部份瀏覽器可能會出現警告訊息。

ItemURLString(200)
商品銷售網址

Remark String(100)
備註欄位

OrderResultURL String(200)
Client端回傳付款結果網址

有別於ReturnURL (server端的網址),OrderResultURL為特店的client端(前端)網址。消費者付款完成後,綠界會將付款結果參數以POST方式回傳到到該網址。詳細說明請參考付款結果通知

❗ 注意事項:

  1. 若與[ClientBackURL]同時設定,將會以此參數為主。
  2. 銀聯卡及非即時交易( ATM、CVS、BARCODE )不支援此參數。
  3. 參數內容若有包含%26(&)及%3C(<) 這二個值時,請先進行urldecode() 避免呼叫API失敗。

NeedExtraPaidInfo String(1)
是否需要額外的付款資訊

額外的付款資訊

  • 若不回傳額外的付款資訊時,參數值請傳:
  • 若要回傳額外的付款資訊時,參數值請傳:,付款完成後綠界後端會以POST方式回傳額外付款資訊到特店的ReturnURL。

❗ 注意事項:回傳額外付款資訊參數請參考-額外回傳的參數

PlatformID String(10)
特約合作平台商代號

為專案合作的平台商使用。

CustomField1 String(50)
自訂名稱欄位1

提供合作廠商使用記錄用客製化使用欄位。

❗ 注意事項:提供合作廠商使用記錄用客製化使用欄位。

CustomField2 String(50)
自訂名稱欄位2

提供合作廠商使用記錄用客製化使用欄位。

❗ 注意事項:提供合作廠商使用記錄用客製化使用欄位。

CustomField3 String(50)
自訂名稱欄位3

提供合作廠商使用記錄用客製化使用欄位。

❗ 注意事項:提供合作廠商使用記錄用客製化使用欄位。

CustomField4 String(50)
自訂名稱欄位4

提供合作廠商使用記錄用客製化使用欄位。

❗ 注意事項:提供合作廠商使用記錄用客製化使用欄位。

Language String(3)
語系設定

預設語系為中文,若要變更語系參數值請帶:

  • ENG:英語
  • KOR:韓語
  • JPN:日語
  • CHI:簡體中文

BNPL付款參數

PaymentInfoURL String(200)
Server端回傳付款相關資訊

  • 若有設定此參數,訂單建立完成後(非付款完成),綠界會Server端背景回傳消費者付款方式相關資訊

ClientRedirectURL String(200)
Client端回傳付款相關資訊

  • 若有設定此參數,訂單建立完成後(非付款完成),綠界會Client端回傳消費者付款方式相關資訊且將頁面轉到特店指定的頁面。

❗ 注意事項:

  1. 若設定此參數,將會使設定的返回特店的按鈕連結[ClientBackURL]失效。
  2. 若導回網址未使用https時,部份瀏覽器可能會出現警告訊息。
  3. 參數內容若有包含%26(&)及%3C(<) 這二個值時,請先進行urldecode() 避免呼叫API失敗。

付款畫面

交易流程圖

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站