本文件用于说明 FuturePay 平台接口返回的标准错误码及其含义。
JSON
{
"code": "错误码",
"message": "错误信息",
"data": {}
}
code ：错误码（字符串类型）message ：错误描述（英文或中文）data ：响应数据（失败时为空或省略）
分类 范围 描述 成功响应 0请求成功 系统错误 500, 10000 等系统或远程调用异常 参数错误 400、1010~1012、40000请求参数错误 鉴权错误 401403、20062009登录、权限、Token 问题 商户/资源错误 4008~4023商户或资源信息错误 账户/注册错误 1511~1551用户注册、登录、手机号等问题 支付相关错误 40008~40041、900xx 系列支付、退款、卡片错误 KYC 风控错误 70001~70007身份验证与风控相关 业务限制错误 25112524、30113014提现、充值、活动等限制 订阅 AutoDebit 错误 40037~40039订阅相关异常 卡 Token 错误 51001~51004卡片 Token 管理错误
以下为系统内常用错误码清单（已分组整理）👇
错误码 描述 0succeeded 10000remote error 400参数不正确 / 参数检验失败 500系统异常 20000Service Currently Unavailable 40025Remote error 40026Not configured
错误码 描述 401未登录或token过期，请登录！ 403没有相关权限 2006Please login first 2007Request Header Error 2008Password Error 2009Too many failed attempt when inputing password 90029Authentication error 90001Invalid authorization.
错误码 描述 1010Missing parameter 1011Parameter error 1012Access speed is too fast! 40000Parameter error. 40001Missing Required Arguments 40002MediaType not supported 40003Signature configuration missing 40040Parameter exceeds character length
错误码 描述 4008商户基本信息已存在 4009商户信息为空 4010商户不存在 4011商户信息不完整 4012证件的国家信息为空 4015保存资源失败 4023保存数据失败 40004Merchant is now invalid 40005App is invalid 40006App not match
错误码 描述 1511Phone number format error 1513Password cannot be empty 1514Password must be 6-20 alphanumeric 1523Account banned 1534User ID does not exist 1540OTP is wrong or invalid 1551Please bind your mobile number 1538Password reset failed 1539Registration parameter failed
错误码 描述 40008Payment method not supported 40009Currency not supported 40010Reference should be unique 40013Payment method invalid 40016Payment order not exist / status error 40017Refunds not supported 40018Refund not allowed for unsuccessful orders 40020Refund amount incorrect 40022Refund currency mismatch 40023Refund requested 40030Failed to obtain the token 40033Unsupported currency
错误码 描述 70001Verify Failed - User document id not exist 70002Document Fail - User's KYC failed 70003Legal risks 70004Fraud Suspect 70005Exceed total Transaction Limit 70006Exceed Total Frequency Limit 70007Invalid ID Number
错误码 描述 90002Invalid card number 90003Invalid cvv 90004Invalid amount 90006Expired card 90007Credit exceeded 90016Insufficient funds 90017Do not honor 90018Contact issuer 90024Duplicate request 90025Card brand not supported 90027Provider internal error 90028Connection error
错误码 描述 40037The subscription product is not valid 40038Consumer already subscribed 40039Payment method not available for regular payment
错误码 描述 51001The card Token does not exist or has been cancelled 51002The information on the bound card has expired 51003The card Token failed to be saved 51004The order has been captured
JSON
{
"code": "0",
"message": "succeeded",
"data": {
........
}
}JSON
{
"code": "40010",
"message": "Reference should be unique for each transaction.",
"data": null
}
返回码统一由服务端定义，调用方不应根据 message 判断结果；
请开发人员在接入 API 时，仅根据 code 进行逻辑判断；
如需扩展新错误码，须提前在公共枚举 CodeEunm 中注册，避免重复。
