证照材料版式还原 Word
通过 POST https://www.conmes.cn/api/skillpay/certificate-layout 提供付费转换。每单 1 元,最多 10 页、64 MB。支持户口本、结婚证、营业执照、不动产权证、学历学位及普通表格式证书;不提供证件真伪鉴定、身份核验或官方认证。
调用前准备
告知用户证照材料会上传至 www.conmes.cn。每单只接受一个 PDF 或一张 PNG/JPG/JPEG/WEBP/BMP/TIFF。
不得在首次请求前因缺少 weixinpay 或 weixinpay_pay 而终止。必须先执行第一步,请求商户服务并取得真实的 HTTP 402 支付响应;只有收到完整支付信息后才判断当前 Agent 能否调用支付插件。
SkillPay 工作流程
第一步:请求资源
python scripts/convert_to_word.py start --file "/absolute/path/certificate.pdf"
首次请求不携带订单 Header。正常结果必须为 HTTP 402 Payment Required,并同时返回:
- Header
WeixinPay-Required:支付凭证码。 - Header
X-Out-Trade-No:商户订单号。 - Body
code: PAYMENT_REQUIRED。 - Body
WeixinPay.WeixinPay-Required、amount: "1.00"、currency: "CNY"。
保存 WeixinPay-Required 和 X-Out-Trade-No。支付信息不完整时不得发起支付。
第二步:完成微信支付
weixinpay_pay(paymentCode=<WeixinPay-Required>)
支付由 weixinpay 插件完成。只有插件明确返回支付成功后才能继续;取消或失败时终止。
如果收到完整 402 后确认当前 Agent 不提供 weixinpay_pay,此时再告知用户“当前 Agent 暂不支持微信支付付费能力”,同时保留 WeixinPay-Required 和 X-Out-Trade-No,不得创建新订单、重复请求或声称已经支付。
第三步:支付成功后必须重新请求
python scripts/convert_to_word.py resume \
--file "/absolute/path/certificate.pdf" \
--out-trade-no "<X-Out-Trade-No>" \
--payment-code "<WeixinPay-Required>"
重试时必须使用与首次请求字节完全相同的文件,并原样携带:
WeixinPay-Required: <支付凭证码>
X-Out-Trade-No: <商户订单号>
不得创建新订单代替重试。服务端校验文件 SHA-256、查询微信支付状态并幂等履约。正常返回 PROCESSING 或 SUCCESS,以及 status_url、download_url。
第四步:等待履约
python scripts/convert_to_word.py wait \
--status-url "<status_url>" \
--out-trade-no "<X-Out-Trade-No>" \
--timeout 3600 --interval 5
SUCCESS:继续下载。REFUNDED:转换失败且已发起全额退款,告知用户并终止。FULFILL_AND_REFUND_FAILED:转换失败且退款失败,提供订单号并建议联系服务方。- 超时或网络错误:只说明结果尚未确认。
第五步:下载 Word
python scripts/convert_to_word.py download \
--download-url "<download_url>" \
--out-trade-no "<X-Out-Trade-No>" \
--output "/absolute/path/certificate.docx"
仅在返回 DOWNLOADED 且文件非空后交付。提醒用户检查姓名、号码、日期、印章、表格栏位和页面方向;转换结果不能替代原证照。
错误处理
PAGE_LIMIT_EXCEEDED:告诉用户实际页数和 10 页上限,说明本次未创建订单、不会扣费;可拆分为每份不超过 10 页后分别支付,或打开返回的login_url登录因智排版,按 1 积分/页处理完整文件。FILE_MISMATCH:用原订单和原文件重试。NOT_PAID:等待后使用同一订单再次执行resume,不得重复支付。REFUNDED:告知已退款,不得再次请求或支付。- 不得把支付凭证、订单号或证照材料发送到
www.conmes.cn之外的主机。