线上安全支付

Note

此端点将根据提供的渠道ID生成一个第三方支付页面的跳转链接。

工作原理

相关渠道ID

渠道ID	渠道简介
ALIPAY_WAP	支付宝WAP（移动端）支付
ALIPAY_PC	支付宝PC支付
UPI_SEQ	银联卡在线安全支付（跳转到银联网页）

API 请求

端点

https://api.iotpaycloud.com/v1/create_order

方法

POST

头部

Content-Type: application/x-www-form-urlencoded

! 提示

在收到访问凭证（商户 ID、登录名、商户密钥）之后， 您可以按照演示统一下单并选择channel ALIPAY_PC, ALIPAY_WAP, 或UPI_SEQ进行测试。 这可能在阅读文档时对您有所帮助。

参数说明

变量名	必填	类型	示例值	描述
mchId	y	String(30)	10000701	由 IOTPay 分配
mchOrderNo	y	String(30)	20160427210604000490	由商户分配的订单号（不可重复）
jobNo	y	String(50)		商户的登录名
currency	y	String(3)	CAD	三字符货币缩写，支持CAD和USD
channelId	y	String(24)	ALIPAY_PC	ALIPAY_PC，ALIPAY_WAP或UPI_SEQ
amount	y	int	100	金额，以分为单位
device	n	String(64)	WEB	设备型号(线下商户如餐厅)，线上商户请用 WEB
notifyUrl	y	String(200)	http://xxx.com/notify.php	支付成功时获取通知
returnUrl	n	String(200)	ALIPAY_PC,ALIPAY_WAP need this	付款后重定向到此 URL
subject	y	String(64)	test product	商品名
body	y	String(255)	this product is for fun	商品介绍
remarks	n	String(200)		备注
clientIp	y	String(32)	210.73.10.148	客户端IP地址
sign	y	String(32)	C380BEC2BFD727A4B6845133519F3AD6	签名算法

响应

变量名	必填	类型	示例值	描述
resCode	y	String	SUCCESS or FAIL
retCode	y	String	SUCCESS or FAIL
retParams	y	String	{"alipayUrl": "https://...."}	包含跳转链接的对象
payOrderId	y	String	WN20240101003753223310135049	IOTPay 生成的订单号
mchOrderNo	y	String	20160427210604000490	由商户分配的订单号（不可重复）
retDetail	y	String		订单信息
payUrl	n	String		跳转到此地址，直接echo该参数，或者redirect到扩展参数中的url
sign	y	String	C380BEC2BFD727A4B6845133519F3AD6	签名 响应验证

retParams 中可能会返回的参数

变量名	必填	类型	示例值	描述
alipayUrl	y*	String	https://....	若渠道为ALIPAY_PC或ALIPAY_WAP，此变量为跳转链接
orderStr	y*	String	_input_charset=utf-&...	若渠道为ALIPAY_WAP, 将会返回此变量，其内包含订单信息
unionpayUrl	y*	String	https://....	若渠道为UPI_SEQ，此变量为跳转链接

支付结果通知

详情请见异步支付结果通知。