SuperAPI AI 工具集

add-attachment-to-processing-account

设计与创作

查看项目

更新于 10-16 03:17

技能介绍

用途:该技能指导开发者把支持性文档(合规、入驻、验证类材料,如银行证明、对账单、身份证明、MPA 副本等)上传到 Payroc boarding 系统中的 processing account(商户账户)。核心接口为 POST https://api.payroc.com/v1/processing-accounts/{processingAccountId}/attachments;上传后可用 GET https://api.payroc.com/v1/attachments/{attachmentId} 查询状态。

主要能力:完成版本自检(对比 frontmatter 的 metadata.version 与已发布 SKILL.md 版本);扫描代码库确认语言、HTTP 客户端与凭据配置;采集文档类型与 processingAccountId;获取 Bearer token(令牌 3600 秒过期);生成附件元数据(type 为必填枚举,需查阅 references/api-schema.md,可选 description 与字符串 metadata);执行 multipart 上传并处理 201 响应;按需轮询 uploadStatus(pending/accepted/rejected)。

使用方式:请求为 multipart/form-data,含 attachment(JSON 元数据部分,部分名用单数 attachment)与 file(二进制内容)两部分,不可设置 Content-Type: application/json。每次 POST 必须带 UUID v4 的 Idempotency-Key 头,新增上传或修正后重传需换新 UUID。文档上限 50 MB 未压缩,允许 .bmp、.csv、.doc、.docx、.gif、.htm、.html、.jpg、.jpeg、.msg、.pdf、.png、.ppt、.pptx、.tif、.tiff、.txt、.xls、.xlsx,不接受压缩文件。取 token 命令示例:curl -X POST https://identity.uat.payroc.com/authorize -H "x-api-key: $PAYROC_API_KEY"。

适用场景:为商户账户提交入驻与合规文档,并确认后台是否接受。

限制:必须先持有 processingAccountId,否则需先通过 add-processing-account、create-merchant-platform 或 Retrieve Merchant Platform 获取;上传前须遵守隐私法规并取得商户同意;凭据不可硬编码,应从环境变量或密钥管理器读取;枚举值只能取自 references/api-schema.md;检索接口在 /v1/attachments/{attachmentId},不返回文件字节。UAT 环境无自助注册,需 Payroc Integrations 团队开通。具体错误码与字段以资料所列错误分类为准。