接入概述

申请商户信息

接入 Codrimpay 前，需提交以下信息完成商户注册：

字段	说明
webSite	网址
webHookUrl	回调地址
Phone	电话
Email	邮箱
Name	申请人
companyName	公司名称

WARNING

所有参数不能包含中文字符

申请成功后，系统下发以下凭证：

凭证	说明
merchantId	商户唯一标识，所有请求必传
apiKey	接口调用公钥，用于 URL 路径参数
secretId	签名密钥，严禁泄露，不可传给前端

接口基础信息

项目	说明
请求协议	HTTPS
请求格式	JSON（Content-Type: application/json）
响应格式	JSON
字符编码	UTF-8

通用响应结构

所有接口返回统一的响应结构：

{
  "rtn_code": "0000",
  "rtn_msg": "",
  "success": true,
  "data": { ... }
}

字段	类型	说明
rtn_code	String	"0000" 表示成功，其余为失败
rtn_msg	String	失败时的描述信息
success	Boolean	是否成功
data	Object/Array	业务数据

接入流程

1. 申请商户凭证（merchantId / apiKey / secretId）
         ↓
2. 阅读签名规范，实现签名算法
         ↓
3. 选择支付模式：
   ├─ PAY        → 直连信用卡支付（需传 cardInfo）
   ├─ CHECKOUT   → 收银台模式（无需传 cardInfo）
   └─ SUBSCRIPTION → 订阅扣费（需创建订阅计划）
         ↓
4. 调用创建交易接口，处理响应
   ├─ status=100000 → 支付成功（等待 Webhook 回调确认）
   ├─ status=100040 → 跳转 url 完成 3DS 验证
   └─ 其他 → 见状态码说明
         ↓
5. 接收 Webhook 回调，验签后更新订单状态

下一步

• 签名规范 — 了解如何计算请求签名
• 创建交易 — 发起第一笔支付
• Webhook 规范 — 处理支付回调通知