授权

测试环境基础地址

https://api.futurepay-develop.com/api/v1/issuing/authorization

生产环境基础地址

https://api.futurepay.global/api/v1/issuing/authorization

接口目录

功能	请求方式	接口路径	请求体
查询授权详情	POST	`/{id}/detail`	`{}`
查询授权分页列表	POST	`/paging`	分页及筛选参数，或 `{}`

通用响应

字段	类型	说明
code	string	成功为0，失败返回错误码
msg	string	结果说明
serverTime	string	服务端毫秒时间戳
success	boolean	是否成功
data	object	业务数据

查询授权详情

接口

POST /{id}/detail

请求参数

参数	位置	类型	必填	说明
id	路径	string	是	授权ID

请求示例

请求体：

{}

响应示例

{
  "code": "0",
  "msg": "succeeded",
  "serverTime": "1794451375285",
  "success": true,
  "data": {
    "id": "AUTH_example",
    "cardId": "ic_example",
    "cardholderId": "ich_example",
    "cardLast4": "4242",
    "merchantAmount": "4.00",
    "merchantCurrency": "EUR",
    "approvedAmount": "4.42",
    "approvedCurrency": "USD",
    "status": "PENDING",
    "declineReasonCode": null,
    "declineReason": null,
    "merchantData": {
      "networkId": "merchant_network_example",
      "name": "Example Store",
      "categoryCode": "0742",
      "category": "veterinary_services",
      "country": "US",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94111"
    },
    "authorizedAt": "2026-11-06 10:00:00",
    "expiresAt": "2026-11-13 10:00:00",
    "settledAt": null,
    "updatedAt": "2026-11-06 10:00:00"
  }
}

响应字段

字段	类型	说明
id	string	授权ID
cardId	string	卡片ID
cardholderId	string	持卡人ID
cardLast4	string	卡号末四位
merchantAmount	string	消费金额
merchantCurrency	string	消费币种
approvedAmount	string	批准金额
approvedCurrency	string	批准币种，固定USD
status	string	授权状态，见状态表
declineReasonCode	string	拒绝原因码
declineReason	string	拒绝原因
merchantData	object	消费商家信息
authorizedAt	string	授权时间
expiresAt	string	预计到期时间
settledAt	string	结算时间
updatedAt	string	更新时间

授权状态说明

状态	中文说明
`PENDING`	待处理或待扣款
`APPROVED`	已批准，待扣款
`PARTIALLY_SETTLED`	部分结算
`COMPLETED`	已完结
`EXPIRED`	已过期
`REVERSED`	已撤销
`FAILED`	失败或被拒

查询授权分页列表

接口

POST /paging

请求参数

参数	类型	必填	说明
id	string	否	授权ID，最多128字符
cardId	string	否	卡片ID，最多128字符
cardholderId	string	否	持卡人ID，最多128字符
keyword	string	否	关键词，最多256字符
startDate	string	否	开始时间，yyyy-MM-dd HH:mm:ss
endDate	string	否	结束时间，yyyy-MM-dd HH:mm:ss，不早于startDate
pageNum	integer	否	页码，默认1，最小1
pageSize	integer	否	每页条数，默认20，范围1–100
status	string	否	授权状态，见状态表

请求示例

{
  "cardId": "ic_example",
  "status": "PENDING",
  "startDate": "2026-11-01 00:00:00",
  "endDate": "2026-11-12 23:59:59",
  "pageNum": 1,
  "pageSize": 20
}

响应示例

{
  "code": "0",
  "msg": "succeeded",
  "serverTime": "1794451375285",
  "success": true,
  "data": {
    "pageNum": "1",
    "pageSize": "20",
    "total": "1",
    "totalPage": "1",
    "list": [
      {
        "id": "AUTH_example",
        "cardId": "ic_example",
        "cardholderId": "ich_example",
        "cardLast4": "4242",
        "merchantAmount": "4.00",
        "merchantCurrency": "EUR",
        "approvedAmount": "4.42",
        "approvedCurrency": "USD",
        "status": "PENDING",
        "declineReasonCode": null,
        "declineReason": null,
        "merchantData": {
          "networkId": "merchant_network_example",
          "name": "Example Store",
          "categoryCode": "0742",
          "category": "veterinary_services",
          "country": "US",
          "city": "San Francisco",
          "state": "CA",
          "postalCode": "94111"
        },
        "authorizedAt": "2026-11-06 10:00:00",
        "expiresAt": "2026-11-13 10:00:00",
        "settledAt": null,
        "updatedAt": "2026-11-06 10:00:00"
      }
    ]
  }
}

分页响应字段

字段	类型	说明
data.pageNum	string	当前页码
data.pageSize	string	每页条数
data.total	string	总条数
data.totalPage	string	总页数
data.list	array	记录列表

消费商家字段说明

字段	类型	说明
merchantData.networkId	string	商家网络编号
merchantData.name	string	商家名称
merchantData.categoryCode	string	商家行业代码（MCC）
merchantData.category	string	商家行业类别
merchantData.country	string	国家或地区代码
merchantData.city	string	城市
merchantData.state	string	州或省
merchantData.postalCode	string	邮政编码

常见错误码

错误码	中文说明
400	请求参数错误
API_QUERY_PARAMETER_INVALID	查询参数错误
AUTHORIZATION_NOT_FOUND	授权记录不存在或无权访问
REQUEST_HEADER_MERCHANT_ID_INVALID	商户身份无效
VCC_PRODUCT_NOT_ENABLED	未开通或未启用发卡服务

错误响应示例

{
  "code": "AUTHORIZATION_NOT_FOUND",
  "msg": "Authorization not found",
  "serverTime": "1794451375285",
  "success": false
}

Updated about 5 hours ago

Did this page help you?