{"info":{"description":"FluxPay 国际支付商户接口。所有商户业务接口统一使用 POST application/json，认证字段与业务字段一起放入 JSON 请求体，使用参数排序 + HMAC-SHA256 签名；金额使用最小货币单位整数。","title":"FluxPay Merchant API","version":"2.0.0"},"openapi":"3.0.3","paths":{"/v1/balances":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"currency":{"description":"可选，按三位大写货币码过滤，例如 VND","maxLength":3,"minLength":3,"type":"string"},"mch_id":{"description":"平台分配的商户号","type":"string"},"nonce_str":{"description":"每次请求唯一随机字符串","type":"string"},"req_time":{"description":"请求时间，Unix 秒或 yyyyMMddHHmmss，有效期 5 分钟","type":"string"},"sign":{"description":"按参数排序后的 HMAC-SHA256 签名","type":"string"}},"required":["mch_id","req_time","nonce_str","sign"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"items":{"items":{"properties":{"available_minor":{"description":"可用余额，最小货币单位整数","type":"integer"},"currency":{"example":"VND","type":"string"},"reserved_minor":{"description":"冻结/处理中余额，最小货币单位整数","type":"integer"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"当前商户余额列表"},"400":{"description":"币种参数无效"},"401":{"description":"签名、时间戳或 nonce 无效"}},"summary":"查询商户余额"}},"/v1/payins":{"post":{"requestBody":{"content":{"application/json":{"schema":{"properties":{"amount":{"description":"最小货币单位整数，建议字符串传输","example":"100000","type":"string"},"amount_minor":{"deprecated":true,"description":"旧字段，兼容使用；新接入请使用 amount","type":"integer"},"collection_card_number":{"description":"可选指定收款卡号，默认不需要；平台日志只记录是否配置","type":"string"},"customer_reference":{"description":"可选客户标识，对应部分三方的 visitor_id，用于风控或客户跟踪","type":"string"},"kyc_reference":{"description":"可选实名或风控校验引用","type":"string"},"mch_id":{"description":"平台分配的商户号","type":"string"},"mch_order_no":{"description":"商户侧唯一订单号","type":"string"},"nonce_str":{"description":"每次请求唯一随机字符串","type":"string"},"notify_url":{"description":"商户 HTTP 或 HTTPS 公网异步通知地址","format":"uri","type":"string"},"original_merchant_order_no":{"description":"可选原商户订单号，用于补单或关联旧订单","type":"string"},"payment_method_code":{"default":"ALL","description":"支付方式编码，从支付产品目录的 payment_methods 选择；省略时仅匹配显式 ALL 通用能力","pattern":"^[A-Z0-9_-]{1,32}$","type":"string"},"product_code":{"description":"平台支付产品编码","minimum":1000,"type":"integer"},"req_time":{"description":"请求时间，Unix 秒或 yyyyMMddHHmmss，有效期 5 分钟","type":"string"},"return_url":{"description":"付款完成后的浏览器跳转地址，必须是 HTTPS 公网地址","format":"uri","type":"string"},"sign":{"description":"按参数排序后的 HMAC-SHA256 签名","type":"string"}},"required":["mch_id","mch_order_no","product_code","amount","req_time","nonce_str","sign"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"amount_minor":{"type":"integer"},"checkout_url":{"description":"平台统一收银台地址","format":"uri","type":"string"},"currency":{"type":"string"},"idempotent_replay":{"type":"boolean"},"mch_order_no":{"type":"string"},"notify_status":{"type":"string"},"payment_data":{"description":"标准化收款信息；上游未返回的字段为 null","nullable":true,"type":"object"},"payment_method_code":{"description":"订单实际支付方式编码","type":"string"},"platform_order_no":{"type":"string"},"status":{"enum":["UNPAID","PAID"],"type":"string"}},"type":"object"}}},"description":"订单已创建或幂等重放"},"400":{"description":"参数或业务校验失败"},"401":{"description":"签名、时间戳或 nonce 无效"},"409":{"description":"mch_order_no 已存在但核心订单参数不一致"}},"summary":"创建代收订单"}},"/v1/payins/query":{"post":{"description":"按商户自己的代收订单号 mch_order_no 查询代收订单","requestBody":{"content":{"application/json":{"schema":{"properties":{"mch_id":{"description":"平台分配的商户号","type":"string"},"mch_order_no":{"description":"商户自己的订单号，同一商户下唯一，不能重复","maxLength":128,"type":"string"},"nonce_str":{"description":"每次请求唯一随机字符串","type":"string"},"req_time":{"description":"请求时间，Unix 秒或 yyyyMMddHHmmss，有效期 5 分钟","type":"string"},"sign":{"description":"按参数排序后的 HMAC-SHA256 签名","type":"string"}},"required":["mch_id","mch_order_no","req_time","nonce_str","sign"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"amount_minor":{"description":"订单金额，最小货币单位整数","type":"integer"},"checkout_url":{"format":"uri","type":"string"},"created_at":{"format":"date-time","type":"string"},"currency":{"type":"string"},"mch_order_no":{"description":"商户提交的唯一订单号","type":"string"},"notify_status":{"enum":["NOT_CONFIGURED","NOT_NOTIFIED","NOTIFIED_UNACKNOWLEDGED","NOTIFIED_ACKNOWLEDGED"],"type":"string"},"payment_data":{"nullable":true,"type":"object"},"payment_method_code":{"description":"订单实际支付方式编码","type":"string"},"platform_order_no":{"description":"平台内部订单号，商户无需依赖","type":"string"},"status":{"enum":["UNPAID","PAID"],"type":"string"}},"type":"object"}}},"description":"订单状态"},"400":{"description":"订单号无效"},"401":{"description":"签名、时间戳或 nonce 无效"},"404":{"description":"订单不存在"}},"summary":"查询代收订单"}},"/v1/payouts":{"post":{"requestBody":{"content":{"application/json":{"schema":{"description":"代付不提交产品、国家或币种；平台由 bank_id 确定。银行目标传银行卡号，钱包目标传绑定手机号；银行卡号字段和二维码文本严格二选一。","properties":{"amount":{"description":"最小货币单位整数，建议字符串传输","example":"100000","type":"string"},"amount_minor":{"deprecated":true,"description":"旧字段，兼容使用；新接入请使用 amount","type":"integer"},"bank_id":{"description":"平台银行或钱包 ID","type":"integer"},"beneficiary_bank_name":{"description":"收款银行名称，可选","type":"string"},"beneficiary_card_number":{"description":"银行目标传收款银行卡号；钱包目标传钱包绑定手机号；与 beneficiary_qr_text 严格二选一","type":"string"},"beneficiary_name":{"description":"收款人姓名","type":"string"},"beneficiary_qr_text":{"description":"二维码原始文本，不是 Base64；与 beneficiary_card_number 严格二选一","type":"string"},"beneficiary_subbranch":{"description":"收款支行（可选）","type":"string"},"mch_id":{"description":"平台分配的商户号","type":"string"},"mch_order_no":{"description":"商户侧唯一订单号","type":"string"},"nonce_str":{"description":"每次请求唯一随机字符串","type":"string"},"notify_url":{"description":"商户 HTTP 或 HTTPS 公网异步通知地址","format":"uri","type":"string"},"payment_method_code":{"default":"ALL","description":"支付方式编码，从支付产品目录的 payment_methods 选择；省略时仅匹配显式 ALL 通用能力","pattern":"^[A-Z0-9_-]{1,32}$","type":"string"},"req_time":{"description":"请求时间，Unix 秒或 yyyyMMddHHmmss，有效期 5 分钟","type":"string"},"sign":{"description":"按参数排序后的 HMAC-SHA256 签名","type":"string"}},"required":["mch_id","mch_order_no","amount","bank_id","beneficiary_name","req_time","nonce_str","sign"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"amount_minor":{"type":"integer"},"bank_id":{"type":"integer"},"currency":{"type":"string"},"idempotent_replay":{"type":"boolean"},"mch_order_no":{"type":"string"},"notify_status":{"type":"string"},"payment_method_code":{"description":"订单实际支付方式编码","type":"string"},"platform_order_no":{"type":"string"},"reject_code":{"nullable":true,"type":"string"},"reject_reason":{"nullable":true,"type":"string"},"status":{"enum":["PAYING","SUCCESS","REJECTED"],"type":"string"}},"type":"object"}}},"description":"订单已创建或幂等重放"},"400":{"description":"参数或业务校验失败"},"401":{"description":"签名、时间戳或 nonce 无效"},"409":{"description":"mch_order_no 已存在但核心订单参数不一致"}},"summary":"创建代付订单"}},"/v1/payouts/query":{"post":{"description":"按商户自己的代付订单号 mch_order_no 查询代付订单","requestBody":{"content":{"application/json":{"schema":{"properties":{"mch_id":{"description":"平台分配的商户号","type":"string"},"mch_order_no":{"description":"商户自己的订单号，同一商户下唯一，不能重复","maxLength":128,"type":"string"},"nonce_str":{"description":"每次请求唯一随机字符串","type":"string"},"req_time":{"description":"请求时间，Unix 秒或 yyyyMMddHHmmss，有效期 5 分钟","type":"string"},"sign":{"description":"按参数排序后的 HMAC-SHA256 签名","type":"string"}},"required":["mch_id","mch_order_no","req_time","nonce_str","sign"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"amount_minor":{"description":"订单金额，最小货币单位整数","type":"integer"},"bank_id":{"type":"integer"},"created_at":{"format":"date-time","type":"string"},"currency":{"type":"string"},"mch_order_no":{"description":"商户提交的唯一订单号","type":"string"},"notify_status":{"enum":["NOT_CONFIGURED","NOT_NOTIFIED","NOTIFIED_UNACKNOWLEDGED","NOTIFIED_ACKNOWLEDGED"],"type":"string"},"payment_method_code":{"description":"订单实际支付方式编码","type":"string"},"platform_order_no":{"description":"平台内部订单号，商户无需依赖","type":"string"},"reject_code":{"nullable":true,"type":"string"},"reject_reason":{"nullable":true,"type":"string"},"status":{"enum":["PAYING","SUCCESS","REJECTED"],"type":"string"}},"type":"object"}}},"description":"订单状态"},"400":{"description":"订单号无效"},"401":{"description":"签名、时间戳或 nonce 无效"},"404":{"description":"订单不存在"}},"summary":"查询代付订单"}}}}