透過 API 將前台網頁上輸入的金額直接帶入到結帳頁面（集資專案適用）

【注意事項】

1. 此功能僅有「集資」類型的專案適用。
2. 此功能需工程技術支援。

 

API 使用情境

您可以先在網頁的前台製作一個讓贊助者輸入金額的介面，再將其輸入的金額帶到結帳頁面的「直接贊助金額」欄位。（或「額外贊助金額」欄位）

下面以《One-Forty》專案的捐款頁面（https://one-forty.org/donate/）來舉例：

1. 贊助者可以在您的專案網頁先輸入期望贊助的金額，之後按下「立即捐款」按鈕進入貝殼集器的結帳頁面。
   
   
   
   
   
2. 進入結帳頁面，可以看到先前網頁上所填寫的金額已經自動帶入「直接贊助金額」欄位了。
   
   
   
   註：如您的回饋本身沒有設定任何金額，則此欄位標題是為「直接贊助金額」；如回饋或客製化選項已有金額，則此欄位標題為「額外贊助金額」。兩者功能是一樣的。

 

API 使用說明

• 此方法「單次回饋連結」與「定期定額贊助」皆適用。
• 建議您可將此回饋商品的 金額 設定為 0，便可僅依結帳畫面中「直接贊助金額」欄位的金額作為訂單金額了。
• 由於商品金額本身為 0 ，也建議可將此回饋商品的 最小贊助量、最大贊助量 設定為 1，讓贊助者／消費者不需要在結帳頁面變更贊助數量。

操作步驟：

1. 到專案後台的回饋設定頁面，並點擊您要串接之回饋項目的連結按鈕，打開連結說明頁面。
   
   
   
   
   
2. 在連結說明頁面取得該回饋的結帳連結。
   
   
   
   
   
3. 於您的連結網址透過 GET 帶入參數請求此 URL ：
   
   網址後方增加 &additional_support=(填上您想要預填的額外／直接贊助金額) 即可。
   
   

   GET: https://{backme_tag}.backme.tw/checkout/{project_id}/{product_id}?locale=zh-TW&additional_support={number}

Query 參數

name	type	description
additional_support	Number	額外贊助金額／直接贊助金額