【注意事項】
- 此功能僅在 Backme 上適用。
- 此功能需工程技術支援。
一、若您的官網會員資料僅有贊助者的姓名、手機、 Email 欄位資訊時,可參考的串接方式:
API 會員資料帶入項目
- 贊助人姓名
- 贊助人電話
- 贊助人 Email (以登入的 Email 為準)
- 贊助人信箱確認
API 使用情境
您的官網若建有會員系統,在串接 Backme 純金流系統時,使用此API可將官網中的會員資料裡頭的「Email」、「會員姓名」、「會員電話」,帶入 backme 結帳頁面的訂購人資訊中的「Email」、「真實姓名」、「手機」欄位中,此設定可以使登入的會員省去填寫訂購人資訊的動作。
下面以測試環境來舉例說明:
- 當贊助者是已登入會員官網狀況下進入到結帳流程。
- 進入「填寫收件資訊」頁面,即可看到會員的「姓名」、「手機」、「 Email 」已被帶入訂購人的「真實姓名」、「手機」、「 Email 」欄位。
註:如贊助者在登入的狀況下進入結帳流程,則不可修改訂購人 Email;若贊助者在沒有登入的狀況下進入結帳流程,則可以修改 Email,但也不會帶入會員資料。
API 使用說明
- 此方法「單次回饋連結」與「定期定額贊助」皆適用。
- 如果贊助者有登入會員,則會以 Email 作為兩邊系統身分的優先判斷依據。
- Backme 會優先比對登入的會員 Email 。
- 登入狀態是不能在結帳時修改訂購人 Email 。
- 若贊助者沒有登入網站,則可以修改訂購人 Email 。
操作步驟:
- 到專案後台的回饋設定頁面,並點擊您要串接之回饋項目的連結按鈕,打開連結說明頁面。
- 在連結說明頁面取得該回饋的結帳連結。
- 於您的連結網址透過 GET 帶入參數請求此 URL :網址後方增加 ?transaction[recipient_attributes][name]=(贊助人姓名)&intl_cellphone_recipient=(贊助人電話)&transaction[recipient_attributes][contact_email]=(贊助人信箱)&transaction[recipient_attributes] &transaction[recipient_attributes][contact_email_confirm]=(贊助人信箱確認)即可。
GET: https://{backme_tag}.backme.tw/checkout/{project_id}/{product_id}?locale=zh-TW?transaction[recipient_attributes][name]=(贊助人姓名)&intl_cellphone_recipient=(贊助人電話)&transaction[recipient_attributes][contact_email]=(贊助人信箱)&transaction[recipient_attributes]&transaction[recipient_attributes][contact_email_confirm]=(贊助人信箱確認)
查詢參數
欄位名稱 | Key | example |
贊助人姓名 | transaction[recipient_attributes][name] | 王大明 |
贊助人電話 | intl_cellphone_recipient | 0900000000 |
贊助人信箱 | transaction[recipient_attributes][contact_email] | wang@mail.com |
贊助人信箱確認 | transaction[recipient_attributes][contact_email_confirm] | wang@mail.com |
*若您的方案為定期定額訂單時,transaction 需更換成 recurring_transaction。
二、若您的官網會員資料,含有「會員資訊」與「收件人資訊」時,可參考的串接方式:
API 會員資料帶入項目
- 贊助人姓名
- 贊助人電話
- 贊助人Email(以登入的Email為準)
- 贊助人信箱確認
- 收件人姓名
- 收件人電話
- 收件人信箱
- 收件人國家
- 收件人城市(洲)
- 收件人區域
- 收件人區碼
- 收件人地址
*其中「收件人國家」、「收件人城市」、「收件人區域」三個欄位為下拉選單,請參考網站內的下拉選單設定的`option`來預填資料。
API 使用情境
您的官網若建有會員系統,在串接Backme純金流系統時,使用此API可將官網中的會員資料與收件人資訊相關的欄位資料,帶入backme結帳頁面的訂購人資訊中的「Email」、「真實姓名」、「手機」,以及收件人資料中的「真實姓名」、「手機」、「Email」、「國家」、「城市/ 州 / 區」、「郵遞區號」、「地址」欄位中,此設定可以使登入的會員省去填寫訂購人與收件人資訊的動作。
下面以測試環境來舉例說明:
- 當贊助者是已登入會員官網狀況下進入到結帳流程。
- 進入「填寫收件資訊」頁面,即可看到官網中的會員資料與收件人資訊相關的欄位資料,帶入 backme 結帳頁面的訂購人資訊中的「Email」、「真實姓名」、「手機」,以及收件人資料中的「真實姓名」、「手機」、「 Email 」、「國家」、「城市/ 州 / 區」、「鄉 / 鎮 / 市 / 區」、「郵遞區號」、「地址」欄位中。
註:如贊助者在登入的狀況下進入結帳流程,則不可修改訂購人Email;若贊助者在沒有登入的狀況下進入結帳流程,則可以修改 Email ,但也不會帶入會員資料。
API 使用說明
- 此方法「單次回饋連結」與「定期定額贊助」皆適用。
- 如果贊助者有登入會員,則會以 Email 作為兩邊系統身分的優先判斷依據。
- Backme會優先比對登入的會員 Email 。
- 登入狀態是不能在結帳時修改訂購人Email
- 若贊助者沒有登入網站,則可以修改訂購人Email
操作步驟:
- 到專案後台的回饋設定頁面,並點擊您要串接之回饋項目的連結按鈕,打開連結說明頁面。
- 在連結說明頁面取得該回饋的結帳連結。
- 於您的連結網址透過 GET 帶入參數請求此 URL :網址後方增加 ?transaction[recipient_attributes][name]=(贊助人姓名)&intl_cellphone_recipient=(贊助人電話)&transaction[recipient_attributes][contact_email]=(贊助人信箱)&transaction[recipient_attributes] &transaction[recipient_attributes][contact_email_confirm]=(贊助人信箱確認)&transaction[recipient_attributes][recipient_name]=(收件人姓名)&intl_recipient_cellphone_recipient=(收件人電話)transaction[recipient_attributes][recipient_contact_email]=(收件人信箱)&transaction[recipient_attributes][recipient_country]=(收件人國家)&transaction[recipient_attributes][recipient_subdivision]=(收件人城市)&transaction[recipient_attributes][recipient_cityarea]=(收件人區域)&transaction[recipient_attributes][recipient_postal_code]=(收件人區碼)&transaction[recipient_attributes][recipient_address]=(收件人地址)即可。
GET: https://{backme_tag}.backme.tw/checkout/{project_id}/{product_id}?locale=zh-TW?transaction[recipient_attributes][name]=(贊助人姓名)&intl_cellphone_recipient=(贊助人電話)&transaction[recipient_attributes][contact_email]=(贊助人信箱)&transaction[recipient_attributes]&transaction[recipient_attributes][contact_email_confirm]=(贊助人信箱確認)&transaction[recipient_attributes][recipient_name]=(收件人姓名)&intl_recipient_cellphone_recipient=(收件人電話)transaction[recipient_attributes][recipient_contact_email]=(收件人信箱)&transaction[recipient_attributes][recipient_country]=(收件人國家)&transaction[recipient_attributes][recipient_subdivision]=(收件人城市)&transaction[recipient_attributes][recipient_cityarea]=(收件人區域)&transaction[recipient_attributes][recipient_postal_code]=(收件人區碼)&transaction[recipient_attributes][recipient_address]=(收件人地址)
查詢參數
欄位名稱 | Key | example |
贊助人姓名 | transaction[recipient_attributes][name] | 王大明 |
贊助人電話 | intl_cellphone_recipient | 0900000000 |
贊助人信箱 | transaction[recipient_attributes][contact_email] | wang@mail.com |
贊助人信箱確認 | transaction[recipient_attributes][contact_email_confirm] | wang@mail.com |
收件人姓名 | transaction[recipient_attributes][recipient_name] | 王大明 |
收件人電話 | intl_recipient_cellphone_recipient | 0900000000 |
收件人信箱 | transaction[recipient_attributes][recipient_contact_email] | wang@mail.com |
收件人國家 | transaction[recipient_attributes][recipient_country] | TW |
收件人城市(州) | transaction[recipient_attributes][recipient_subdivision] | TPE |
收件人區域 | transaction[recipient_attributes][recipient_cityarea] | 中正區 |
收件人區碼 | transaction[recipient_attributes][recipient_postal_code] | 200 |
收件人地址 | transaction[recipient_attributes][recipient_address] | 復興路 |