{"components":{"schemas":{"Capabilities":{"additionalProperties":false,"properties":{"channels":{"items":{"type":"string"},"type":"array"},"configuration_source":{"const":"billing_center"},"schema_version":{"const":1}},"required":["channels","configuration_source","schema_version"],"type":"object"},"Channel":{"additionalProperties":false,"properties":{"action_type":{"enum":["redirect","qr_code","wechat_jsapi","wechat_mini_program","alipay_mini_program"],"type":"string"},"asset_amount_source":{"type":"string"},"available":{"type":"boolean"},"currencies":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"network_source":{"type":"string"},"payment_asset":{"type":"string"},"payment_request_schema":{"description":"完整的单场景下单JSON Schema。包含公众号/小程序身份约束。","type":"object"},"protocol_id":{"type":"string"},"quote_currency":{"type":"string"},"unavailable_reason":{"type":["string","null"]}},"required":["id","name","protocol_id","currencies","action_type","payment_request_schema","available","unavailable_reason"],"type":"object"},"CreatePayment":{"examples":[{"account_id":"33333333-3333-4333-8333-333333333333","amount_decimal":"12.34","application_id":"22222222-2222-4222-8222-222222222222","callback_url":"https://billing.example.invalid/api/internal/payment-center/events","channel":"alipay_page","confirmation_mode":"manual","currency":"CNY","external_order_id":"order-001","recharge_order_id":"11111111-1111-4111-8111-111111111111"},{"amount_decimal":"12.34","application_id":"22222222-2222-4222-8222-222222222222","callback_url":"https://billing.example.invalid/api/internal/payment-center/events","channel":"alipay_page","confirmation_mode":"manual","currency":"CNY","external_id":"customer-001","external_order_id":"order-001","recharge_order_id":"11111111-1111-4111-8111-111111111111"}],"oneOf":[{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]},{"if":{"properties":{"payment_mode":{"const":"api"}},"required":["payment_mode"]},"then":{"properties":{"client_ip":{"minLength":2,"type":"string"}},"required":["client_ip"]}}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"alipay","type":"string"},"client_ip":{"description":"payment_mode=api时必填，付款用户IPv4/IPv6，由已鉴权应用服务提供，不作为认证或到账证据。","maxLength":45,"type":["string","null"]},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"payment_mode":{"description":"省略或form保留前台表单；api由网关调用mapi.php并返回上游HTTPS payurl。失败保留原单重试，不自动切回表单。","enum":["form","api",null],"type":["string","null"]},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]},{"if":{"properties":{"payment_mode":{"const":"api"}},"required":["payment_mode"]},"then":{"properties":{"client_ip":{"minLength":2,"type":"string"}},"required":["client_ip"]}}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"wechat","type":"string"},"client_ip":{"description":"payment_mode=api时必填，付款用户IPv4/IPv6，由已鉴权应用服务提供，不作为认证或到账证据。","maxLength":45,"type":["string","null"]},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"payment_mode":{"description":"省略或form保留前台表单；api由网关调用mapi.php并返回上游HTTPS payurl。失败保留原单重试，不自动切回表单。","enum":["form","api",null],"type":["string","null"]},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]},{"if":{"properties":{"payment_mode":{"const":"api"}},"required":["payment_mode"]},"then":{"properties":{"client_ip":{"minLength":2,"type":"string"}},"required":["client_ip"]}}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"epay_usdt","type":"string"},"client_ip":{"description":"payment_mode=api时必填，付款用户IPv4/IPv6，由已鉴权应用服务提供，不作为认证或到账证据。","maxLength":45,"type":["string","null"]},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"payment_mode":{"description":"省略或form保留前台表单；api由网关调用mapi.php并返回上游HTTPS payurl。失败保留原单重试，不自动切回表单。","enum":["form","api",null],"type":["string","null"]},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"wechat_native","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"wechat_jsapi","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode","payer_openid"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"wechat_mini_program","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode","payer_openid"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"alipay_page","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"alipay_wap","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"alipay_qr","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"oneOf":[{"properties":{"alipay_buyer_id":{"type":"string"},"alipay_buyer_open_id":{"type":"null"}},"required":["alipay_buyer_id"]},{"properties":{"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"string"}},"required":["alipay_buyer_open_id"]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"pattern":"^2088[0-9]{12}$","type":["string","null"]},"alipay_buyer_open_id":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":["string","null"]},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"alipay_mini_program","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"CNY","type":"string"},"exchange_snapshot":{"description":"可选金额快照；官方通道仅支持CNY且不能换汇。","type":["object","null"]},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"type":"null"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode"],"type":"object"},{"additionalProperties":false,"allOf":[{"oneOf":[{"properties":{"account_id":{"format":"uuid","type":"string"},"external_id":{"type":"null"}},"required":["account_id"]},{"properties":{"account_id":{"type":"null"},"external_id":{"maxLength":128,"minLength":1,"type":"string"}},"required":["external_id"]}]}],"properties":{"account_id":{"description":"与external_id二选一；计费中心内部账户UUID。","format":"uuid","type":["string","null"]},"alipay_buyer_id":{"type":"null"},"alipay_buyer_open_id":{"type":"null"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"callback_url":{"description":"必须等于网关预配置的计费回调地址，不能指定任意地址。","format":"uri","type":"string"},"channel":{"const":"usdt","type":"string"},"confirmation_mode":{"description":"支付确认策略；不代替计费中心资金审批。","enum":["manual","automatic"],"type":"string"},"currency":{"const":"USD","type":"string"},"customer_email":{"description":"付款用户邮箱，按原订单持久化；不发送虚构邮箱。","format":"email","maxLength":254,"minLength":3,"type":"string"},"exchange_snapshot":{"description":"计费中心持久化的USD到USDT/USDC付款报价快照，6位精度。","type":"object"},"external_id":{"description":"与account_id二选一；须属于application_id及已有充值单，1–128字节，无首尾空白或控制字符。","maxLength":128,"minLength":1,"type":["string","null"]},"external_order_id":{"maxLength":128,"minLength":1,"type":"string"},"network":{"enum":["ERC-20","TRC-20"],"type":"string"},"payer_openid":{"type":"null"},"recharge_order_id":{"format":"uuid","type":"string"}},"required":["recharge_order_id","application_id","external_order_id","currency","amount_decimal","channel","callback_url","confirmation_mode","network","customer_email","exchange_snapshot"],"type":"object"}]},"Evidence":{"additionalProperties":false,"properties":{"amount_decimal":{"pattern":"^[0-9]{1,12}(\\.[0-9]{1,6})?$","type":"string"},"currency":{"type":"string"},"receipt_id":{"type":"string"},"receiving_account":{"type":"string"},"source":{"enum":["epay_signed_notification","epay_authenticated_query","wechat_v3_notification","wechat_v3_query","alipay_rsa2_notification","alipay_rsa2_query","payram_signed_notification"],"type":"string"},"verified_at":{"format":"date-time","type":"string"}},"required":["receipt_id","currency","amount_decimal","receiving_account","verified_at","source"],"type":"object"},"Observation":{"additionalProperties":false,"properties":{"account_id":{"format":"uuid","type":"string"},"amount_decimal":{"description":"以元为单位的正十进制字符串，最多2位小数；业务还会校验正值与金额上限。","examples":["12.34"],"pattern":"^[0-9]{1,12}(\\.[0-9]{1,2})?$","type":"string"},"application_id":{"format":"uuid","type":"string"},"channel":{"enum":["alipay","wechat","epay_usdt","wechat_native","wechat_jsapi","wechat_mini_program","alipay_page","alipay_wap","alipay_qr","alipay_mini_program","usdt"],"type":"string"},"currency":{"type":"string"},"event_id":{"type":"string"},"network":{"type":["string","null"]},"payment":{"additionalProperties":false,"properties":{"expires_at":{"format":"date-time","type":["string","null"]},"kind":{"type":"string"},"next_action":{"oneOf":[{"additionalProperties":false,"properties":{"code_url":{"type":"string"},"type":{"const":"qr_code","type":"string"}},"required":["type","code_url"],"type":"object"},{"additionalProperties":false,"properties":{"app_id":{"type":"string"},"trade_no":{"type":"string"},"type":{"const":"alipay_mini_program","type":"string"}},"required":["type","app_id","trade_no"],"type":"object"},{"additionalProperties":false,"properties":{"parameters":{"additionalProperties":false,"properties":{"appId":{"type":"string"},"nonceStr":{"type":"string"},"package":{"type":"string"},"paySign":{"type":"string"},"signType":{"const":"RSA","type":"string"},"timeStamp":{"type":"string"}},"required":["appId","timeStamp","nonceStr","package","signType","paySign"],"type":"object"},"type":{"const":"wechat_jsapi","type":"string"}},"required":["type","parameters"],"type":"object"},{"additionalProperties":false,"properties":{"parameters":{"additionalProperties":false,"properties":{"appId":{"type":"string"},"nonceStr":{"type":"string"},"package":{"type":"string"},"paySign":{"type":"string"},"signType":{"const":"RSA","type":"string"},"timeStamp":{"type":"string"}},"required":["appId","timeStamp","nonceStr","package","signType","paySign"],"type":"object"},"type":{"const":"wechat_mini_program","type":"string"}},"required":["type","parameters"],"type":"object"}]},"payment_amount_decimal":{"type":["string","null"]},"payment_currency":{"type":"string"},"payment_url":{"type":["string","null"]},"receiving_account":{"type":["string","null"]},"reference":{"type":["string","null"]}},"required":["kind","payment_url","receiving_account","reference","payment_currency","payment_amount_decimal","expires_at"],"type":"object"},"payment_id":{"format":"uuid","type":"string"},"recharge_order_id":{"format":"uuid","type":"string"},"status":{"enum":["pending","succeeded"],"type":"string"},"verification":{"additionalProperties":false,"properties":{"amount_decimal":{"pattern":"^[0-9]{1,12}(\\.[0-9]{1,6})?$","type":"string"},"currency":{"type":"string"},"receipt_id":{"type":"string"},"receiving_account":{"type":"string"},"source":{"enum":["epay_signed_notification","epay_authenticated_query","wechat_v3_notification","wechat_v3_query","alipay_rsa2_notification","alipay_rsa2_query","payram_signed_notification"],"type":"string"},"verified_at":{"format":"date-time","type":"string"}},"required":["receipt_id","currency","amount_decimal","receiving_account","verified_at","source"],"type":"object"},"version":{"minimum":0,"type":"integer"}},"required":["event_id","recharge_order_id","application_id","account_id","payment_id","version","status","currency","amount_decimal","channel","network","payment"],"type":"object"},"PaymentAction":{"oneOf":[{"additionalProperties":false,"properties":{"code_url":{"type":"string"},"type":{"const":"qr_code","type":"string"}},"required":["type","code_url"],"type":"object"},{"additionalProperties":false,"properties":{"app_id":{"type":"string"},"trade_no":{"type":"string"},"type":{"const":"alipay_mini_program","type":"string"}},"required":["type","app_id","trade_no"],"type":"object"},{"additionalProperties":false,"properties":{"parameters":{"additionalProperties":false,"properties":{"appId":{"type":"string"},"nonceStr":{"type":"string"},"package":{"type":"string"},"paySign":{"type":"string"},"signType":{"const":"RSA","type":"string"},"timeStamp":{"type":"string"}},"required":["appId","timeStamp","nonceStr","package","signType","paySign"],"type":"object"},"type":{"const":"wechat_jsapi","type":"string"}},"required":["type","parameters"],"type":"object"},{"additionalProperties":false,"properties":{"parameters":{"additionalProperties":false,"properties":{"appId":{"type":"string"},"nonceStr":{"type":"string"},"package":{"type":"string"},"paySign":{"type":"string"},"signType":{"const":"RSA","type":"string"},"timeStamp":{"type":"string"}},"required":["appId","timeStamp","nonceStr","package","signType","paySign"],"type":"object"},"type":{"const":"wechat_mini_program","type":"string"}},"required":["type","parameters"],"type":"object"}]},"PaymentEvent":{"additionalProperties":false,"properties":{"aggregate_version":{"minimum":0,"type":"integer"},"correlation_id":{"format":"uuid","type":"string"},"data":{"$ref":"#/components/schemas/Observation"},"event_id":{"type":"string"},"event_type":{"type":"string"},"occurred_at":{"format":"date-time","type":"string"},"payment_id":{"format":"uuid","type":"string"},"schema_version":{"const":1}},"required":["event_id","event_type","schema_version","payment_id","aggregate_version","correlation_id","occurred_at","data"],"type":"object"},"Protocol":{"additionalProperties":false,"properties":{"available":{"type":"boolean"},"billing_protocol":{"type":"string"},"channels":{"items":{"type":"string"},"type":"array"},"configuration_mode":{"const":"billing_center"},"configuration_schema":{"description":"JSON Schema 2020-12对象。properties定义字段，required定义必填；writeOnly和x-storage标识加密凭证，x-storage定义计费配置保存位置。","type":"object"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","billing_protocol","configuration_mode","configuration_schema","channels","available"],"type":"object"},"ProtocolCatalog":{"additionalProperties":false,"properties":{"channels":{"items":{"$ref":"#/components/schemas/Channel"},"type":"array"},"configuration_mode":{"const":"billing_center"},"protocols":{"items":{"$ref":"#/components/schemas/Protocol"},"type":"array"},"schema_dialect":{"type":"string"},"schema_version":{"const":1}},"required":["schema_version","schema_dialect","configuration_mode","protocols","channels"],"type":"object"},"Timeline":{"additionalProperties":false,"properties":{"billing_events":{"items":{"type":"object"},"type":"array"},"events":{"items":{"additionalProperties":false,"properties":{"created_at":{"format":"date-time","type":"string"},"event_id":{"type":"string"},"event_type":{"type":"string"},"payload":{"$ref":"#/components/schemas/Observation"},"version":{"type":"integer"}},"required":["event_id","event_type","version","payload","created_at"],"type":"object"},"type":"array"},"payment_id":{"format":"uuid","type":"string"},"receipts":{"items":{"$ref":"#/components/schemas/Evidence"},"type":"array"},"upstream_exchanges":{"items":{"type":"object"},"type":"array"}},"required":["payment_id","events","receipts","billing_events"],"type":"object"},"UpstreamExchange":{"additionalProperties":false,"properties":{"cached":{"type":"boolean"},"observation":{"$ref":"#/components/schemas/Observation"},"upstream":{"additionalProperties":false,"properties":{"accepted":{"type":"boolean"},"body":{},"http_status":{"type":["integer","null"]},"occurred_at":{"format":"date-time","type":"string"},"operation":{"enum":["create","query"]},"request":{"type":"object"},"validation_error":{"type":["string","null"]}},"required":["operation","http_status","accepted","body","validation_error","request","occurred_at"],"type":"object"}},"required":["observation","upstream","cached"],"type":"object"}},"securitySchemes":{"ServiceBearer":{"scheme":"bearer","type":"http"}}},"info":{"description":"服务端集成接口。通过Bearer token鉴权；凭证不得置于浏览器。到账确认和计费审批入账分离。商户配置由计费中心管理；每次执行按订单读取绑定配置版本，网关不落地商户密钥。","title":"支付交易网关 OpenAPI","version":"1.0.0"},"openapi":"3.1.1","paths":{"/assets/checkout.js":{"get":{"operationId":"public__assets_checkout_js","responses":{"200":{"content":{"text/javascript":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /assets/checkout.js"}},"/callbacks/alipay_rsa2":{"post":{"description":"仅供上游通知。必须通过协议验签与业务核验；持久化成功后应答。浏览器/业务客户端不能调用此接口模拟成功。","operationId":"notifyalipay_rsa2","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"additionalProperties":true,"type":"object"}}},"required":true},"responses":{"200":{"description":"网关持久化成功后的协议应答"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"支付宝RSA2异步通知"}},"/callbacks/epay_legacy":{"get":{"description":"仅供上游通知。必须通过协议验签与业务核验；持久化成功后应答。浏览器/业务客户端不能调用此接口模拟成功。","operationId":"notifyepay_legacy","responses":{"200":{"description":"网关持久化成功后的协议应答"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"易支付签名异步通知"}},"/callbacks/payram":{"post":{"description":"仅供上游通知。必须通过协议验签与业务核验；持久化成功后应答。浏览器/业务客户端不能调用此接口模拟成功。","operationId":"notifypayram","parameters":[{"description":"以原单绑定项目API Key计算原始body的HMAC-SHA256；不接受裸API-KEY回调。","in":"header","name":"X-Payram-Signature","required":true,"schema":{"pattern":"^sha256=[0-9a-f]{64}$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"required":true},"responses":{"200":{"description":"网关持久化成功后的协议应答"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"PayRam HMAC-SHA256入金通知（仅验签后主动核对原单）"}},"/callbacks/wechat_v3/{reference}":{"post":{"description":"仅供上游通知。必须通过协议验签与业务核验；持久化成功后应答。浏览器/业务客户端不能调用此接口模拟成功。","operationId":"notify{reference}","parameters":[{"description":"订单UUID定位绑定配置，仍须通过签名和加密身份验证","in":"path","name":"reference","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"required":true},"responses":{"204":{"description":"微信通知成功持久化"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"微信v3签名头及AES-GCM通知"}},"/checkout/{token}":{"get":{"operationId":"public__checkout_token","parameters":[{"description":"收银台随机令牌，30分钟有效；按敏感访问凭据保护。","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /checkout/{token}"}},"/checkout/{token}/prepare":{"post":{"operationId":"public__checkout_token_prepare","parameters":[{"description":"收银台随机令牌，30分钟有效；按敏感访问凭据保护。","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /checkout/{token}/prepare"}},"/checkout/{token}/qr.svg":{"get":{"operationId":"public__checkout_token_qr_svg","parameters":[{"description":"收银台随机令牌，30分钟有效；按敏感访问凭据保护。","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/svg+xml":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /checkout/{token}/qr.svg"}},"/checkout/{token}/status":{"get":{"operationId":"public__checkout_token_status","parameters":[{"description":"收银台随机令牌，30分钟有效；按敏感访问凭据保护。","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /checkout/{token}/status"}},"/docs":{"get":{"operationId":"getDocs","responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"HTML文档"}},"security":[],"summary":"阅读接口说明"}},"/livez":{"get":{"operationId":"public__livez","responses":{"200":{"content":{"text/plain":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /livez"}},"/openapi.json":{"get":{"operationId":"getOpenApi","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"成功"}},"security":[],"summary":"下载OpenAPI规范"}},"/readyz":{"get":{"operationId":"public__readyz","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /readyz"}},"/returns/alipay_rsa2":{"get":{"operationId":"public__returns_alipay_rsa2","responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /returns/alipay_rsa2"}},"/returns/epay_legacy":{"get":{"operationId":"public__returns_epay_legacy","responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"公共页面/当前本地支付状态"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"security":[],"summary":"公共支付流程 /returns/epay_legacy"}},"/v1/capabilities":{"get":{"operationId":"getCapabilities","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"当前实例已配置的通道（兼容接口）"}},"/v1/channels":{"get":{"operationId":"listChannels","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"channels":{"items":{"$ref":"#/components/schemas/Channel"},"type":"array"},"schema_version":{"const":1}},"required":["schema_version","channels"],"type":"object"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"实现的通道及实例可用状态"}},"/v1/payments":{"post":{"callbacks":{"paymentObservation":{"{$request.body#/callback_url}":{"post":{"parameters":[{"description":"Unix秒；接收方校验300秒窗口","in":"header","name":"Payment-Timestamp","required":true,"schema":{"type":"string"}},{"description":"HMAC-SHA256(secret, timestamp + \".\" + 原始body)，v1=加小写hex","in":"header","name":"Payment-Signature","required":true,"schema":{"pattern":"^v1=[0-9a-f]{64}$","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}},"required":true},"responses":{"200":{"description":"接收并持久化成功；2xx均表示HTTP投递成功"},"default":{"description":"网关按原event_id/version退避重试；接收方须幂等"}},"security":[],"summary":"支付观察结果回调（预先注册的计费地址）"}}}},"description":"返回pending不代表已下单成功或到账；响应丢失后按原UUID查询/重试。checkout令牌30分钟过期不代表上游已关单。automatic不代替资金审批。","operationId":"createPayment","parameters":[{"description":"必须与请求体recharge_order_id相同。同键异参返回409。account_id/external_id解析为同一内部UUID时保持同一意图。","in":"header","name":"Idempotency-Key","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"account_id":"33333333-3333-4333-8333-333333333333","amount_decimal":"12.34","application_id":"22222222-2222-4222-8222-222222222222","callback_url":"https://billing.example.invalid/api/internal/payment-center/events","channel":"alipay_page","confirmation_mode":"manual","currency":"CNY","external_order_id":"order-001","recharge_order_id":"11111111-1111-4111-8111-111111111111"},"schema":{"$ref":"#/components/schemas/CreatePayment"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"幂等创建支付，返回收银台及可用的调起参数"}},"/v1/payments/by-reference/{reference}":{"get":{"operationId":"getReference","parameters":[{"in":"path","name":"reference","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"按业务充值UUID查询"}},"/v1/payments/{id}":{"get":{"operationId":"getPayment","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"查询本地支付状态"}},"/v1/payments/{id}/events":{"get":{"operationId":"getEvents","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Timeline"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"查询支付与计费结果时间线"}},"/v1/payments/{id}/evidence":{"get":{"operationId":"getEvidence","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Timeline"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"查询时间线和到账证据"}},"/v1/payments/{id}/prepare":{"post":{"operationId":"preparePayment","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Observation"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"原单恢复预支付参数，不创建新交易"}},"/v1/payments/{id}/upstream/create":{"post":{"description":"仅epay_legacy三通道。返回脱敏后的上游HTTP状态、正文及校验结果；不返回请求签名、商户密钥、含密钥查询URL或Cookie。HTTP 200只代表网关执行完成，请检查upstream.accepted、http_status和body。不得根据API下单成功或支付URL判断到账。","operationId":"epayUpstreamCreate","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"client_ip":{"description":"付款用户实际IP；不可用网关服务器IP或伪造地址代替。","type":"string"}},"required":["client_ip"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpstreamExchange"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"易支付API下单（不代表到账；同单成功结果复用）"}},"/v1/payments/{id}/upstream/query":{"post":{"description":"仅epay_legacy三通道。返回脱敏后的上游HTTP状态、正文及校验结果；不返回请求签名、商户密钥、含密钥查询URL或Cookie。HTTP 200只代表网关执行完成，请检查upstream.accepted、http_status和body。不得根据API下单成功或支付URL判断到账。","operationId":"epayUpstreamQuery","parameters":[{"in":"path","name":"id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpstreamExchange"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"易支付主动查询上游订单；验证到账后才更新本地状态"}},"/v1/protocols":{"get":{"operationId":"listProtocols","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProtocolCatalog"}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"协议、通道、配置与下单参数定义（包含未启用的实现）"}},"/v1/protocols/{protocol_id}":{"get":{"operationId":"getProtocol","parameters":[{"in":"path","name":"protocol_id","required":true,"schema":{"enum":["epay_legacy","wechat_v3","alipay_rsa2","payram"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"properties":{"available":{"type":"boolean"},"billing_protocol":{"type":"string"},"channels":{"items":{"type":"string"},"type":"array"},"configuration_mode":{"const":"billing_center"},"configuration_schema":{"description":"JSON Schema 2020-12对象。properties定义字段，required定义必填；writeOnly和x-storage标识加密凭证，x-storage定义计费配置保存位置。","type":"object"},"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name","billing_protocol","configuration_mode","configuration_schema","channels","available"],"type":"object"},{"properties":{"channel_definitions":{"items":{"$ref":"#/components/schemas/Channel"},"type":"array"},"schema_version":{"const":1}},"required":["channel_definitions","schema_version"],"type":"object"}]}}},"description":"成功"},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"}},"text/plain":{"schema":{"type":"string"}}},"description":"业务错误（error为稳定错误码）；框架产生的400/413/415/422错误可能为纯文本。"}},"summary":"获取单一协议及其通道定义"}}},"security":[{"ServiceBearer":[]}],"servers":[{"url":"https://pay.xmodels.ai"}]}