如何在 Rave Flutterwave 中结算托管付款和退还托管付款?

How does Settling an Escrow payment and Refunding an Escrow payment work in Rave Flutterwave?

我是 flutterwave 集成的新手。我正在开发一个网站并测试托管付款功能。我已经使用 api、密钥以及详细信息和 upoads 等创建了一个帐户和所有其他内容。使用来自 ravesandbox 的 api 密钥在我的开发环境中看起来一切都很好。我对结算托管付款和退还托管付款的方式感到非常困惑。它在文档中说 "When the funds are in escrow and you would like to settle the seller for the funds you would need to call our settlement endpoint."

测试端点:https://ravesandboxapi.flutterwave.com/v2/gpx/transactions/escrow/settle然后它给出了一个示例请求

{
    "id": "348813", // this is the txid value returned in the v2/verify response.
    "secret_key": "FLWSECK-*************************-X" // your merchant secret key.
}

退还托管付款也有类似之处。这究竟是如何工作的?它会出现在我网站的某个地方还是...?

我假设您正在构建一个市场平台,从描述中我可以收集到这些信息。 Rave 允许您使用两个功能 split paymentsEscrow(用于消费者保护)来处理您的市场中的付款。

当使用拆分付款时,假设您希望 Rave 处理您平台上卖家的自动结算,例如,当卖家通过您的平台收取 N10,000 并且将于明天结算时,Rave 会自动结算到您为卖家提供的帐户。您可以阅读有关拆分付款的更多信息 here

托管付款可让您为消费者提供保护,并且在使用我上面描述的拆分付款方案时效果最佳。假设来自上述商家的交易被标记为托管交易,这就是会发生的情况。

商户 x 已收取 4 笔价值 N10,000 的交易,因为您将它们设置为托管,它们不会按预期在到期日结算。当您调用结算 API.

时,每笔交易现在都会结算

让我们使用 4 笔交易中的示例交易对其进行分解。假设 1f 这 4 笔交易是由客户 A - N2000 在 2019 年 5 月 4 日完成的,这意味着该交易最初应于 2019 年 5 月 5 日(T+1 settlements)结算给卖家,但您放置托管交易,直到您假设的买方确认流程完成,并且卖方满足接收付款的所有条件。假设此确认发生的日期是 5 月 10 日,这意味着您在该日期调用结算 API,交易离开托管,Rave 会在第二天自动将资金结算到卖家账户。

这就是托管服务在 Rave 上的工作方式,如果这对您有帮助,请告诉我。

Flutterwave 文档没有很好地告诉我们这是一个 POST 方法,而不是 GET。

const options = {
    method: 'POST',
    headers: {
               'Content-Type': 'application/json',
    },
    body: JSON.stringify(data),
};
    
let data = {
    "id": txid,
    "secret_key": "your-secret-key"
};

fetch('https://api.ravepay.co/v2/gpx/transactions/escrow/settle', options)
   .then(response => response.json())
   .then(response => console.log(response))
   .catch(err => console.error(err))