除了web應(yīng)用程序中的用戶界面,Airwallex還為商家提供了一個API解決方案,用于我們的Pay By Link產(chǎn)品。通過鏈接支付使商家能夠發(fā)布支付鏈接(URL或二維碼)與他們的客戶分享并通過重定向到我們的安全托管支付頁面非常輕松地接受付款。商戶可以自定義支付鏈接,選擇金額、幣種和到期日。商家還可以選擇使鏈接可重復(fù)使用或一次性使用。
以下是生成付款鏈接的主要步驟:
我們的API允許商家:
我們的Pay By Link API是帶有JSON的典型REST API。要開始使用我們的API,商家需要在入職時提供他們的帳戶ID才能繼續(xù)。
總流量
為了開始使用Merchant Links API,商家需要先使用Merchant Config API完成其配置。前兩步應(yīng)該在webapp中完成。要繼續(xù)創(chuàng)建鏈接,商家需要調(diào)用Merchant Links API。
商戶鏈接API
此API用于對支付鏈接進行CRUD操作,并允許商家執(zhí)行下述操作。
·創(chuàng)建支付鏈接將允許商家生成支付鏈接并在以下參數(shù)中進行選擇:“code”、“expiryDate”、“reusable”、“amount”、“minAmount”、“title”、“description”、“merchantRef”
·更新付款鏈接將允許商家更改現(xiàn)有的付款鏈接。
·Retrieve Merchant's Payment Links將允許商家從給定的linkID獲取支付細節(jié)。
·獲取PaymentLinks列表將返回商家之前創(chuàng)建的鏈接。此端點將返回所有未刪除的鏈接。
·激活鏈接將允許商家激活給定的支付鏈接ID。
·停用鏈接將允許商家停用給定的支付鏈接ID。
·刪除鏈接將允許商家刪除給定的支付鏈接ID。
發(fā)送支付鏈接
主API的此端點用于向商家和購物者發(fā)送電子郵件。有兩種不同的電子郵件可以作為Pay by Link產(chǎn)品的一部分生成。每當商家之前創(chuàng)建的付款鏈接成功付款時,都會發(fā)送一封電子郵件以通知商家。第二個鏈接作為付款收據(jù)發(fā)送給購物者,其中包含主要的付款詳細信息。
付款鏈接已創(chuàng)建購物者通知將允許商家在成功付款完成時收到通知
請注意,商家還可以訂閱webhook以接收有關(guān)成功付款的通知(payment_intent.succeeded)。
錯誤處理
一般來說,所有的API調(diào)用都可能失敗,在這種情況下,商家會在正文中獲得特定的HTTP狀態(tài)和錯誤代碼和錯誤消息。