支付FM

https://docs.zhifux.com
Admin
支付FM is an aggregate payment interface platform that provides unified API integration, multi-channel...
Tokens:353,927
Snippets:3,423
Trust Score:6.8
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /wxminjsapi

Source: https://docs.zhifux.com/read/zhifufm/getopenid

获取小程序调起支付所需的prepayid等数据。

```APIDOC
## GET /wxminjsapi

### Description
获取小程序调起支付所需的prepayid等数据。

### Method
GET

### Endpoint
/wxminjsapi

### Parameters
#### Query Parameters
- **openid** (string) - Optional - 微信用户openid
- **orderId** (string) - Optional - 支付FM平台订单号

### Response
#### Success Response (200)
- **success** (boolean) - 成功标识
- **msg** (string) - 提示信息
- **code** (integer) - 状态码
- **timestamp** (integer) - 时间戳
- **data** (object) - 包含paysign, timestamp, appid, prepayId, nonceStr, package的对象

#### Response Example
{
  "success": true,
  "msg": "success",
  "code": 200,
  "timestamp": 1761018451390,
  "data": {
    "paysign": "qgCoVmhOzwtMZRI0qIpE/4GvLvHwFrQ9yz5o2LAiPqDTEM5Uft8/eVtG7Pw5NrZitOHhgcIp+Om8DPs5b+6Jf1zdl7GRIkhtEAAOz0nEwuFKG5/cV2jGxNAZVDLBVcJIU03pGd65WR4vwEGEREHyP6PDK/ILF7K2xptO4kQor+naic90KV9JBOTY+NCptf7Mp87QglrKW1gxiOflhta1ECOMP9EsVN27ShLbPHCxw9UZKUyts3cxutptgEwA3j2tEP2XnUqFbZsKvrDq6guwwVDw07l7YXlHUyU7OrxA9TgFVKGSMo4JAeR+5qJ/r9qASFhO84nt/T/yXL/hw9UggA==",
    "timestamp": "1761012331",
    "appid": "wx71f1353f119d7663",
    "prepayId": "wx21114229521410bcf46603b3ed27460000",
    "nonceStr": "574623147236524032",
    "package": "prepay_id=wx21114229521410bcf46603b3ed27460000"
  }
}
```

--------------------------------

### GET /callback

Source: https://docs.zhifux.com/read/zhifufm/notify?wd=FM

支付结果通知回调接口，用于接收支付状态更新。

```APIDOC
## GET /callback

### Description
支付系统在顾客支付完成后，将支付结果推送到商户的业务系统。

### Method
GET (或 POST，若创建订单时指定 apiMode=post_form)

### Parameters
#### Query Parameters
- **merchantNum** (string) - Required - 商户号
- **orderNo** (string) - Required - 商户订单号
- **type** (string) - Required - 支付方式
- **amount** (number) - Required - 订单金额
- **platformOrderNo** (string) - Required - 平台订单号
- **actualPayAmount** (string) - Required - 实际支付金额
- **state** (string) - Required - 付款成功标志 (1: 成功)
- **payee** (string) - Required - 收款号标识
- **payTime** (string) - Required - 付款时间 (yyyy-MM-dd HH:mm:ss)
- **channelOrderNo** (string) - Optional - 支付机构平台订单号
- **attch** (string) - Optional - 附加信息
- **sign** (string) - Required - 签名 (md5(state+merchantNum+orderNo+amount+密钥))

### Response
#### Success Response (200)
- **success** (string) - 必须返回字符串 'success' 以表示收到回调
```

--------------------------------

### POST /startOrder

Source: https://docs.zhifux.com/read/zhifufm/startorder?wd=%E7%94%A8%E6%88%B7

创建支付订单接口，通过Query参数传递数据，并使用MD5签名进行身份验证。

```APIDOC
## POST /startOrder

### Description
创建支付订单，支持多种支付方式。请求参数通过Query传递，Content-Type为application/x-www-form-urlencoded。

### Method
POST

### Endpoint
/startOrder

### Parameters
#### Query Parameters
- **merchantNum** (string) - Required - 商户号，在商户后台API开发信息查看
- **orderNo** (string) - Required - 我方系统中的订单号
- **amount** (number) - Required - 支付金额
- **notifyUrl** (string) - Required - 异步通知地址
- **payType** (string) - Required - 支付方式传值
- **sign** (string) - Required - MD5签名，计算规则：商户号+商户订单号+支付金额+异步通知地址+接入密钥

### Response
#### Success Response (200)
- **success** (boolean) - 是否成功
- **msg** (string) - 提示信息
- **code** (number) - 状态码
- **timestamp** (number) - 时间戳
- **data** (object) - 包含 id 和 payUrl 的数据对象

#### Response Example
{
  "success": true,
  "msg": "success",
  "code": 200,
  "timestamp": 1624553174921,
  "data": {
    "id": "1408103748495998976",
    "payUrl": "http://XXXXX/pay?orderNo=1408103748495998976"
  }
}
```

--------------------------------

### GET 支付结果通知

Source: https://docs.zhifux.com/read/zhifufm/notifyv2?wd=%E7%94%A8%E6%88%B7

支付FM通过GET请求向商户配置的notify_url发送支付结果数据。商户需确保接口可直接访问，且处理逻辑包含签名验证与并发控制。

```APIDOC
## GET [notify_url]

### Description
支付FM服务器异步通知接口，用于将支付结果推送至商户系统。

### Method
GET

### Parameters
#### Query Parameters
- **pid** (String) - Required - 商户ID，在支付FM商户后台用户中心查看
- **trade_no** (String) - Required - 支付FM平台订单号
- **out_trade_no** (String) - Required - 商户系统内部的订单号
- **channel_order_no** (String) - Optional - 支付机构平台订单号
- **type** (String) - Required - 支付方式，如 alipay, wxpay
- **name** (String) - Required - 商品名称
- **money** (String) - Required - 商品金额
- **trade_status** (String) - Required - 支付状态，如 TRADE_SUCCESS
- **sign** (String) - Required - 签名字符串
- **sign_type** (String) - Required - 签名类型，默认为MD5

### Response
#### Success Response (200)
- **success** (String) - 业务系统处理成功后必须返回字符串 "success"
```

--------------------------------

### POST /startOrder

Source: https://docs.zhifux.com/read/zhifufm/startorder?wd=%E5%90%8E%E5%8F%B0

创建支付订单接口，支持多种支付方式，通过Query参数传递数据。

```APIDOC
## POST /startOrder

### Description
创建支付订单，支持免签和签约支付方式。请求参数通过Query方式传递，Content-Type为application/x-www-form-urlencoded。

### Method
POST

### Endpoint
/startOrder

### Parameters
#### Query Parameters
- **merchantNum** (string) - Required - 商户号
- **orderNo** (string) - Required - 我方系统订单号
- **amount** (number) - Required - 支付金额
- **notifyUrl** (string) - Required - 异步通知地址
- **payType** (string) - Required - 支付方式
- **sign** (string) - Required - MD5签名结果 (商户号+商户订单号+支付金额+异步通知地址+接入密钥)

### Response
#### Success Response (200)
- **success** (boolean) - 是否成功
- **msg** (string) - 提示信息
- **code** (number) - 状态码
- **data** (object) - 包含id和payUrl的订单数据

#### Response Example
{
  "success": true,
  "msg": "success",
  "code": 200,
  "timestamp": 1624553174921,
  "data": {
    "id": "1408103748495998976",
    "payUrl": "http://XXXXX/pay?orderNo=1408103748495998976"
  }
}
```

--------------------------------

### POST /startOrder

Source: https://docs.zhifux.com/read/zhifufm/startorder?wd=FM

Initiates a new payment order. Parameters are passed via query string.

```APIDOC
## POST /startOrder

### Description
Initiates a payment order. The request must be sent as a POST request with parameters passed in the query string.

### Method
POST

### Endpoint
{接口根地址}/startOrder

### Parameters
#### Query Parameters
- **merchantNum** (string) - Required - Merchant ID from the user center.
- **orderNo** (string) - Required - Merchant order number (alphanumeric, max 32 chars).
- **amount** (number) - Required - Order amount in Yuan (max 2 decimal places).
- **notifyUrl** (string) - Required - Publicly accessible URL for payment success callback.
- **returnUrl** (string) - Optional - URL for user redirection after payment.
- **payType** (string) - Required - Payment method identifier.
- **sign** (string) - Required - MD5 signature (merchantNum + orderNo + amount + notifyUrl + secretKey).
- **returnType** (string) - Optional - Response format (json or page).
- **payee** (string) - Optional - Specific payee identifier.
- **attch** (string) - Optional - Custom attachment data.
- **subject** (string) - Optional - Product title.
- **body** (string) - Optional - Product description.
- **payDuration** (integer) - Optional - Order validity in minutes (default 5, max 15).
- **apiMode** (string) - Optional - Callback request method (GET or post_form).
```

--------------------------------

### GET /jscode2session

Source: https://docs.zhifux.com/read/zhifufm/getopenid

获取微信小程序用户的openid，用于后续支付流程。

```APIDOC
## GET /jscode2session

### Description
获取微信小程序用户的openid，用于后续支付流程。

### Method
GET

### Endpoint
/jscode2session

### Parameters
#### Query Parameters
- **orderId** (string) - Optional - 支付FM订单号，H5拉起小程序时候会传入
- **code** (string) - Optional - wx.login获取的凭证

### Response
#### Success Response (200)
- **success** (boolean) - 成功标识
- **msg** (string) - 提示信息
- **code** (integer) - 状态码
- **timestamp** (integer) - 时间戳
- **data** (object) - 包含session_key和openid的对象

#### Response Example
{
  "success": true,
  "msg": "success",
  "code": 200,
  "timestamp": 1761012918283,
  "data": {
    "session_key": "kB1uyZyG5k7k8d3G1BfWcQ==",
    "openid": "oFyk-16rQLFkjFqU90pFZBB4Wu9I"
  }
}
```

--------------------------------

### ASP版本DEMO贡献说明

Source: https://docs.zhifux.com/read/zhifufm/downdemo

记录ASP版本DEMO的贡献者信息。

```text
 （感谢热心网友【久久QQ 765387761 】2020年5月提供）
```

--------------------------------

### GET 微信小程序获取openid

Source: https://docs.zhifux.com/search/result?page=8&tab=doc&wd=%E6%94%AF%E4%BB%98

该接口用于在微信小程序中获取用户的openid，是进行支付流程的前提。

```APIDOC
## GET 【接口根地址】/jscode2session

### Description
获取微信小程序用户的openid。

### Method
GET

### Endpoint
【接口根地址】/jscode2session
```
Tokens:
Raw