忆海易支付 · 开发文档

一站式免签约支付接口 · 快速接入支付宝 / 微信 / QQ 钱包

01快速开始

接入只需三步:① 获取商户参数 → ② 构造支付链接 → ③ 处理异步通知。

商户参数在用户中心「接口信息」中查看,包含:

参数说明
pid商户 ID
key商户密钥(仅用于签名,请勿泄露)
接口地址https://pay.yihsea.com/

02发起支付

请求方式:GETPOST/submit.php

参数类型必填说明
pidint是商户 ID
typestring否支付方式:alipay / wxpay / qqpay,留空弹出收银台
out_trade_nostring是商户订单号(字母数字 _ - |)
notify_urlstring是异步通知地址
return_urlstring是支付完成跳转地址
namestring是商品名称
moneystring是支付金额(元)
signstring是签名(见下方规则)
paramstring否自定义参数,回调时原样返回
sitenamestring否网站名称(base64 编码)
https://pay.yihsea.com/submit.php?pid=1000&type=alipay&out_trade_no=20261018001¬ify_url=https://your.com/notify&return_url=https://your.com/return&name=测试商品&money=1.00&sign=xxxxx

03签名规则

1. 除 sign 外的所有请求参数,按参数名 ASCII 码升序排序;

2. 去除空值参数,拼接为 key1=value1&key2=value2 形式;

3. 计算 md5,得到 sign 参数值。

sign = md5( k1=v1&k2=v2&... )
密钥 key 仅参与签名计算,不随请求发送。请务必在服务端完成签名,避免泄露。

04查询接口

请求方式:GET/api.php?act=xxx&pid=xxx&key=xxx,鉴权参数 pid + key。

act说明附加参数
query商户信息查询—
order单笔订单查询trade_no 或 out_trade_no
orders订单列表limit / offset
settle结算记录limit / offset
返回 JSON:{"code":1,"msg":"成功", ...},code 为 1 表示成功,负数表示失败。

05退款接口

请求方式:GET/api.php?act=refund,需商户在后台开启「自助退款」及「订单退款 API」权限。

参数说明
trade_no平台订单号
money退款金额(不大于订单金额)

06异步通知

支付完成后,平台会向 notify_url 发送异步通知,携带原订单参数。请在收到通知后:

1. 校验 sign 签名;2. 校验订单金额与状态;3. 返回字符串 success 表示接收成功。

返回内容必须为纯文本 success,否则平台会视为失败并按策略重试通知。