---
agentTools:
  projectIndex: https://pass2pay-zh-hk.readme.io/llms.txt
---

# 轉帳回調

當轉帳完成（成功或失敗）時，支付網關會向商家系統發起回呼通知。若商家系統未正確返回，支付網關將再次延遲通知。

商家系統處理完畢後應同步返回支付網關。傳回字串**success**表示成功。返回**fail**表示處理失敗。

**注意:** 只有因爲網絡問題問題才會重發回調通知請求，如果請求被正常返回，則不會重試。

（通知頻率為**0/30/60/90/120/150**，單位：秒）

請求URL：此連結由透過轉帳API提交的參數notifyUrl設定。如果無法存取該鏈接，商家系統將無法接收來自支付網關的通知。

請求方式： `POST`

### 請求類型： `application/x-www-form-urlencoded`

[block:parameters]
{
  "data": {
    "h-0": "參數 ",
    "h-1": "描述",
    "h-2": "範例",
    "0-0": "mchNo",
    "0-1": "**必填**。商家號碼",
    "0-2": "M1621873433953",
    "1-0": "appId",
    "1-1": "**必填**。應用程式 ID",
    "1-2": "60cc09bce4b0f1c0b83761c9",
    "2-0": "mchOrderNo",
    "2-1": "**必填**。商家產生的轉帳訂單編號",
    "2-2": "20160427210604000490",
    "3-0": "transferId",
    "3-1": "**必填**。支付中心產生的轉帳單號",
    "3-2": "T20160427210604000490",
    "4-0": "amount",
    "4-1": "**必填**。轉帳金額，單位分",
    "4-2": "100",
    "5-0": "currency",
    "5-1": "**必填**。三位數貨幣代碼，人民幣：cny",
    "5-2": "cny",
    "6-0": "ifCode",
    "6-1": "**必填**  \nalipay：支付寶官方接口",
    "6-2": "alipay",
    "7-0": "entryType",
    "7-1": "**必填**。入帳方式：  \nBANK_CARD：銀行卡",
    "7-2": "20160427210604000490",
    "8-0": "state",
    "8-1": "**必填**。傳輸狀態  \n0：訂單生成  \n1：轉帳正在進行中  \n2：轉帳成功  \n3：轉帳失敗  \n4：轉帳關閉",
    "8-2": "2",
    "9-0": "accountNo",
    "9-1": "**必填**  \nwxpay：openID  \nalipay：登入帳號",
    "9-2": "o6BcIwvTvIqf1zXZohc61biryWik",
    "10-0": "accountName",
    "10-1": "如果填寫，姓名就會被驗證，否則不會被驗證。",
    "10-2": "張三",
    "11-0": "bankName",
    "11-1": "目前僅供記錄",
    "11-2": "中國工商銀行",
    "12-0": "transferDesc",
    "12-1": "轉帳備註資訊",
    "12-2": "測試",
    "13-0": "channelOrderNo",
    "13-1": "對應通道的轉帳單號，比如支付宝的订单号",
    "13-2": "20160427210604000490",
    "14-0": "errCode",
    "14-1": "通道返回錯誤碼",
    "14-2": "1002",
    "15-0": "errMsg",
    "15-1": "通道回傳錯誤描述",
    "15-2": "134586944573118714",
    "16-0": "extraParam",
    "16-1": "商家擴充參數，回呼時原樣返回",
    "16-2": "134586944573118714",
    "17-0": "createdAt",
    "17-1": "**必填**。訂單建立時間，13位時間戳",
    "17-2": "1622016572190",
    "18-0": "successTime",
    "18-1": "轉帳成功時間，13位時間戳",
    "18-2": "1622016572190",
    "19-0": "reqTime",
    "19-1": "**必填**。请求发送時間，13位時間戳",
    "19-2": "1622016572133",
    "20-0": "sign",
    "20-1": "**必填**。回调消息签名",
    "20-2": "C380BEC2BFD727A4B6845133519F3AD6"
  },
  "cols": 3,
  "rows": 21,
  "align": [
    null,
    null,
    null
  ]
}
[/block]

**範例：**

```json
 {
        "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
        "amount": 1,
        "appId": "6113805e42020495c62bd4cb",
        "createdAt": 1628818820011,
        "currency": "CNY",
        "entryType": "WX_CASH",
        "errCode": "OPENID_ERROR",
        "errMsg": "openid mismatch with appid",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "mchOrderNo": "1628818820",
        "state": 3,
        "transferDesc": "test",
        "transferId": "T202108130940200100001",
        "reqTime": 1628818820011,
   			"sign": "C380BEC2BFD727A4B6845133519F3AD6"
    }
```