FuturePay 系统错误码响应文档

📖 一、文档说明

本文件用于说明 FuturePay 平台接口返回的标准错误码及其含义。所有 API 响应遵循以下结构：

{
  "code": "错误码",
  "message": "错误信息",
  "data": {}
}

以下为系统内常用错误码清单（已分组整理）👇

错误码	描述
`0`	succeeded
`10000`	remote error
`400`	参数不正确 / 参数检验失败
`500`	系统异常
`20000`	Service Currently Unavailable
`40025`	Remote error
`40026`	Not configured

错误码	描述
`401`	未登录或token过期，请登录！
`403`	没有相关权限
`2006`	Please login first
`2007`	Request Header Error
`2008`	Password Error
`2009`	Too many failed attempt when inputing password
`90029`	Authentication error
`90001`	Invalid authorization.

错误码	描述
`1010`	Missing parameter
`1011`	Parameter error
`1012`	Access speed is too fast!
`40000`	Parameter error.
`40001`	Missing Required Arguments
`40002`	MediaType not supported
`40003`	Signature configuration missing
`40040`	Parameter exceeds character length

错误码	描述
`1511`	Phone number format error
`1513`	Password cannot be empty
`1514`	Password must be 6-20 alphanumeric
`1523`	Account banned
`1534`	User ID does not exist
`1540`	OTP is wrong or invalid
`1551`	Please bind your mobile number
`1538`	Password reset failed
`1539`	Registration parameter failed

错误码	描述
`40008`	Payment method not supported
`40009`	Currency not supported
`40010`	Reference should be unique
`40013`	Payment method invalid
`40016`	Payment order not exist / status error
`40017`	Refunds not supported
`40018`	Refund not allowed for unsuccessful orders
`40020`	Refund amount incorrect
`40022`	Refund currency mismatch
`40023`	Refund requested
`40030`	Failed to obtain the token
`40033`	Unsupported currency

错误码	描述
`70001`	Verify Failed - User document id not exist
`70002`	Document Fail - User's KYC failed
`70003`	Legal risks
`70004`	Fraud Suspect
`70005`	Exceed total Transaction Limit
`70006`	Exceed Total Frequency Limit
`70007`	Invalid ID Number

错误码	描述
`40037`	The subscription product is not valid
`40038`	Consumer already subscribed
`40039`	Payment method not available for regular payment

错误码	描述
`51001`	The card Token does not exist or has been cancelled
`51002`	The information on the bound card has expired
`51003`	The card Token failed to be saved
`51004`	The order has been captured

{
  "code": "0",
  "message": "succeeded",
  "data": {
    ........
  }
}

{
  "code": "40010",
  "message": "Reference should be unique for each transaction.",
  "data": null
}