收款异步通知

POST

商户需要提供一个用于接收订单成功通知的 webhook 地址，请在 Finix 商户后台的设置菜单中进行配置

我们的 Webhook 会实时通知商家交易事件。当付款处理完毕时，此 Webhook 会发送一个包含交易详情的有效负载，包括金额、交易参考号、类型和状态。
通知IP : 13.204.227.76

Request

Header Params

Body Params application/json

Example

{
    "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
    "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
    "currency": "INR",
    "method": "NATIVE",
    "amount": "100.01",
    "paidAmount": "100.01",
    "fee": "5.5",
    "status": "Success"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '商户需要提供一个用于接收订单成功通知的 webhook 地址，请在 Finix 商户后台的设置菜单中进行配置' \
--header 'Signature: 61MNVRXa9k3tNwWCtLXYDmXPlIMenBNuVtBGzrAXEt76uh9wgpYTOb4tIU1v0sN7qZaaUAbFvv2eXra1an1vu00B2E5uWwbublyz4bs6xw2sWks6auFGfYtL9cGI1oHnIxAjjQXwK4RV2ewsmNVfXABDyd2ns4ybIML4MUuwnUCV7o14NqFoMxUb2YMfRkkYJ11MNgs6aP6IbVRh48Wp6uVCY1LsMXGvMtsv3ts2GX5GnsC4KQutuvoJq0vUY5UU' \
--header 'Timestamp: 1750554890' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transactionRef": "e50f5496-1316-4fa6-a206-98be03550c4d",
    "merchantRef": "19e5b36d-c9d6-4cb4-8e4e-e6fe0e3a0cb5",
    "currency": "INR",
    "method": "NATIVE",
    "amount": "100.01",
    "paidAmount": "100.01",
    "fee": "5.5",
    "status": "Success"
}'

Responses

🟢200Success

text/plain

SUCCESS

Example

Finix会在收到 SUCCESS 响应之前每分钟通知您 连续10次

查询收款状态

创建代付