---
title: "回调/WEBHOOK"
method: POST
path: "/payin/WEBHOOK"
tags: ["payin-controller"]
---

# 回调/WEBHOOK

`POST /payin/WEBHOOK`

## Request body

- NotificationResponse — 通知响应对象，包含应用ID、实时状态、商户ID和通知项列表
  - `appId` string — 应用ID
  - `live` string — 实时状态
  - `merchantId` string — 商户ID
  - `notificationItems` NotificationRequestItem[] — 通知项列表
    - `additionalData` object — 附加数据
    - `amount` Amount — 金额信息。
      - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。
      - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。
    - `eventCode` 'TRANSACTION' | 'REFUND' — 事件代码。允许值：TRANSACTION - 交易，REFUND - 退款。
    - `eventDate` string, date-time — 事件日期
    - `merchantAccountCode` string — 商户账户代码
    - `merchantReference` string — 商户订单号
    - `operations` string[] — 操作
    - `originalReference` string — 原始订单号
    - `paymentMethod` string — 支付方式
    - `pspReference` string — 支付服务提供商订单号
    - `reason` string — 原因
    - `resultCode` string — 结果代码

## Response `200`

success

---

[API](https://skmtc.dev/futurepay/apis/futurepay-api.md) · [All operations](https://skmtc.dev/futurepay/apis/futurepay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/futurepay/futurepay-api/revisions/a031b4bbeaa0/schema)