Airwallex API解決方案

除了web應(yīng)用程序中的用戶界面，Airwallex還為商家提供了一個(gè)API解決方案，用于我們的Pay By Link產(chǎn)品。通過(guò)鏈接支付使商家能夠發(fā)布支付鏈接（URL或二維碼）與他們的客戶分享并通過(guò)重定向到我們的安全托管支付頁(yè)面非常輕松地接受付款。商戶可以自定義支付鏈接，選擇金額、幣種和到期日。商家還可以選擇使鏈接可重復(fù)使用或一次性使用。

以下是生成付款鏈接的主要步驟：

我們的API允許商家：

我們的Pay By Link API是帶有JSON的典型REST API。要開(kāi)始使用我們的API，商家需要在入職時(shí)提供他們的帳戶ID才能繼續(xù)。

總流量

為了開(kāi)始使用Merchant Links API，商家需要先使用Merchant Config API完成其配置。前兩步應(yīng)該在webapp中完成。要繼續(xù)創(chuàng)建鏈接，商家需要調(diào)用Merchant Links API。

商戶鏈接API

此API用于對(duì)支付鏈接進(jìn)行CRUD操作，并允許商家執(zhí)行下述操作。

·創(chuàng)建支付鏈接將允許商家生成支付鏈接并在以下參數(shù)中進(jìn)行選擇：“code”、“expiryDate”、“reusable”、“amount”、“minAmount”、“title”、“description”、“merchantRef”

·更新付款鏈接將允許商家更改現(xiàn)有的付款鏈接。

·Retrieve Merchant's Payment Links將允許商家從給定的linkID獲取支付細(xì)節(jié)。

·獲取PaymentLinks列表將返回商家之前創(chuàng)建的鏈接。此端點(diǎn)將返回所有未刪除的鏈接。

·激活鏈接將允許商家激活給定的支付鏈接ID。

·停用鏈接將允許商家停用給定的支付鏈接ID。

·刪除鏈接將允許商家刪除給定的支付鏈接ID。

發(fā)送支付鏈接

主API的此端點(diǎn)用于向商家和購(gòu)物者發(fā)送電子郵件。有兩種不同的電子郵件可以作為Pay by Link產(chǎn)品的一部分生成。每當(dāng)商家之前創(chuàng)建的付款鏈接成功付款時(shí)，都會(huì)發(fā)送一封電子郵件以通知商家。第二個(gè)鏈接作為付款收據(jù)發(fā)送給購(gòu)物者，其中包含主要的付款詳細(xì)信息。

付款鏈接已創(chuàng)建購(gòu)物者通知將允許商家在成功付款完成時(shí)收到通知

請(qǐng)注意，商家還可以訂閱webhook以接收有關(guān)成功付款的通知(payment_intent.succeeded)。

錯(cuò)誤處理

一般來(lái)說(shuō)，所有的API調(diào)用都可能失敗，在這種情況下，商家會(huì)在正文中獲得特定的HTTP狀態(tài)和錯(cuò)誤代碼和錯(cuò)誤消息。