Developer Center · 技术文档中心
Cropay开发者中心
为开发团队整理支付下单、签名、跳转、回调、状态查询、退款、测试与版本管理的接入路径。
Scope & readiness
业务与能力核验说明
具体服务地区、支付方式、结算周期与技术接入方案,均结合商户主体、业务场景与通道准入结果逐项确认。
开发者中心仅限一次性主动交易评估
开发者中心目前用于预上线审核。真实接口字段、地址、测试卡和错误码在完成资料脱敏与版本核对前不会公开,避免开发者依据过期或不完整文档实施。
文档信息架构
快速开始
说明申请测试商户、环境配置、签名准备和首笔测试交易。
支付接口
覆盖请求字段、金额币种、订单标识、支付页面和结果校验。
Webhook
说明签名验证、幂等、重试、响应要求和异常补偿。
退款与查询
记录退款申请、状态查询、错误处理和业务订单同步。
上线前技术检查
01 凭证安全
证书只保存在服务端,限制访问权限,不写入前端、日志或代码仓库。
02 订单一致性
金额、币种和订单号由服务端生成并签名,避免客户端篡改。
03 回调幂等
重复通知只能更新一次业务结果,未知状态使用查询接口核对。
04 全分支验收
覆盖成功、待处理、失败、异常、超时、重复通知与退款流程。
能力、证据与合规边界
接口正文待资料
在真实接口手册完成脱敏、版本核验和业务审核前,不展示伪造代码示例。
MD5 不替代传输安全
签名必须与 HTTPS、证书保护、访问控制和日志脱敏共同使用。
版本需可追溯
应按 gw_version 等字段记录版本,并维护兼容性和变更日志。
FAQ
常见问题
如何申请测试环境?
联系技术支持申请测试商户号、测试地址和测试证书。
收到 T 状态可以发货吗?
不应。T 表示待处理,应等待签名有效的回调或主动查询获得最终结果。
回调最多会重试多少次?
现有业务资料写明最多重试 3 次,商户端仍需实现幂等和主动查询。