统一下单

业务通过统一下单接口可以发起任意三方支付(微信支付宝支付系统)渠道的支付订单。业务系统不必关心该如何调用三方支付，统一下单接口会根据业务系统选择的支付渠道ID，选择对应支付渠道的支付产品，发起下单请求，然后响应给业务系统支付请求所需参数。

An image

对于商户APP，商户发送支付请求到支付中心后，支付中心向商户返回加密数据且不向三方支付发送消息。商户利用接收到的加密数据调用三方支付的SDK，向三方支付发起支付请求。当支付中心收到三方支付的支付消息后，支付中心通知商户支付结果。

An image

关于微信支付宝的更多文档请访问如下链接：

注意：支付宝APP已不再支持官方SDK唤起支付。请使用以下流程图的方式集成

An image

API 请求

端点

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

头部

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

参数说明

字段名	变量名	必填	类型	示例值	描述
商户ID	mchId	是	String(30)	10000701	支付中心分配的商户号
商户订单号	mchOrderNo	是	String(30)	20160427210604000490	商户生成的订单号，请保证唯一性
渠道ID	channelId	是	String(24)	WX_JSAPI	见支付渠道参数
币种	currency	是	String(3)	CAD	三位货币代码,加币:CAD
支付金额	amount	是	int	100	支付金额,单位分
客户端IP	clientIp	是	String(32)	210.73.10.148	客户端IP地址
设备	device	否	String(50)	WEB	终端设备号(门店号或收银设备ID)，注意：PC网页或公众号内支付请传"WEB"
移动端OS	osType	否	String(10)	IOS	ALIPAY_MOBILE和ALIPAY_WAP必填！可选值：IOS, ANDROID
结果回调URL	notifyUrl	是	String(200)	http://xxx.com/notify.php	支付结果回调URL,勿包含？
商品主题	subject	是	String(64)	测试商品	商品主题
商品描述信息	body	是	String(255)	xxpay测试商品描述	商品描述信息
扩展参数1	param1	否	String(64)	该参数可忽略
扩展参数2	param2	否	String(64)	支付中心回调时会原样返回
附加参数	extra	是	String(512)		微信小程序，WX_APP,WX_NATIVE需要
结束跳转URL	returnUrl	否	String(200)	`WX_JSAPI`, `ALIPAY_PC`, `ALIPAY_WAP`, `ALIPAY_MOBILE`需要	支付结束跳转URL，勿包含`?`
子账号	jobNo	是	String(50)		商户登录名
附言	remarks	否	String(200)		商户的附言
签名	sign	是	String(32)	C380BEC2BF3519F3AD6	签名值，详见签名算法

参数示例

params={"amount":1,"mchId":"10000000","mchOrderNo":"9af01329f1ec4c4694631b077a0e8573","subject":"商品支付主题","sign":"F64C43C1487C7C0DA93DA93DD2961FA2","body":"商品支付内容","param1":"","param2":"","clientIp":"127.0.0.1","extra":"{\"openId\":\"o2RvowBf7sOVJf8kJksUEMceaDqo\", \"type\":\"minipay\",\"appId\":\"xxxxxxxxx\"}","notifyUrl":"http://ngrok.4jicao.com/goods/payNotify","currency":"CAD","device":"WEB","channelId":"WX_JSAPI"}

附加参数extra说明

小程序支付(WX_JSAPI)

字段名	变量名	必填	类型	示例值	描述
附加参数	extra	是	JSON	{"openId":"o2RvowBf7sOVJf8kJksUEMceaDqo", "type":"minipay","appId":"xxxxxxxxx"}	openid,type,appId为必填。

微信App支付(WX_APP)

字段名	变量名	必填	类型	示例值	描述
附加参数	extra	是	JSON	{"type":"apppay","appId":"xxxxxxxxx"}	type,appId为必填。

微信原生扫码支付（WX_NATIVE）

productId参数必填，对应业务系统定义的商品ID。

字段名	变量名	必填	类型	示例值	描述
附加参数	extra	是	JSON	{"productId":"120989823"}	对应业务系统定义的商品ID。

注意

当notify回传时，参数"mchOrderNo"被放入"param1"，"parma1"在发起订单时不要填入参数，否则回传时被覆盖。

支付完成后仍需根据notify判断是否支付成功或失败

返回结果

字段名	变量名	必填	类型	示例值	描述
返回状态码	retCode	是	String	SUCCESS	SUCCESS/FAIL此字段是通信标识，非交易标识，交易是否成功需要查看resCode来判断
返回信息	retMsg	否	String	签名失败	返回信息，如非空，为错误原因签名失败参数格式校验错误
签名	sign	是	String

channelId=ALIPAY_PC or ALIPAY_WAP or UPI_SEQ

字段名	变量名	必填	类型	示例值	描述
支付订单ID	payOrderId	是	String	支付订单ID
跳转url	payUrl	是	String		跳转到此地址,直接echo该参数,或者redirect到扩展参数中的url
扩展参数	retParams	是	Array		for ALIPAY_WAP, 跳转至retParams.alipayUrl, for UPI_SEQ, 跳转至retParams.unionpayUrl

channelId=ALIPAY_QR

字段名	变量名	必填	类型	示例值	描述
支付订单ID	payOrderId	是	String	支付订单ID
二维码code	qr_code	是	String		商家根据qr_code生成二维码，让用户使用支付宝扫码

channelId=WX_NATIVE

字段名	变量名	必填	类型	示例值	描述
支付订单ID	payOrderId	是	String	支付订单ID
二维码code	codeUrl	是	String		商家根据codeUrl生成二维码，让用户使用微信扫码
预支付标识	prepayId	是	String		第三方支付公司返回的预支付标识

channelId=CC_PAX

字段名	变量名	必填	类型	示例值	描述
附加参数	extra	y	String(json)	{"cardType": "M", "cardNum": "XXXXXXXX1166", "expireDate": "1022"}	credit card transaction info

参数示例

"extra":"{\"cardType\":\"M\",\"cardNum\":\"XXXXXXXX1166\",\"expireDate\":\"1022\",\"emvLabel\":\"MASTERCARD\",\"emvAID\":\"A0000000041010\",\"emvTVR\":\"0000008000\",\"emvTSI\":\"0000\",\"emvTC\":\"ARQC: 3D36ACBD44BE512B\",\"termNum\":\"25957\",\"bankTermNum\":\"40880013\",\"termInvoiceNum\":\"724172\",\"seqNum\":\"000001000061\",\"authNum\":\"01046Z\",\"batchNum\":\"0008\",\"trxMethod\":\"T\",\"accountType\":\"\",\"receiptDisp\":\"000 Approved 00 Thank You\",\"cashbackAmount\":\"\",\"timeStamp\":\"20210120-19402057\",\"surchargeAmount\":\"\",\"langCode\":\"E\",\"trxDate\":\"01202021\",\"trxTime\":\"164033\",\"cvmResults\":\"1F0302\",\"trxCode\":\"00\"}"

下单测试

统一下单测试点击这里源码下载下载

扫码（商家扫用户）下单测试点击这里源码下载下载

在线签名检查

返回结果处理：注意：已不能使用原orderStr的方式唤起支付宝支付，需要改为用payParams(retParams.schemeUrl)或payParams(retParams.url)跳转方式唤起支付 payParams 为schemeUrl唤起支付宝支付 retDetail 为打开网页的方式唤起支付若你的sdk支持tradeNo的方式，则可以使用retParams.tradeNo的方式唤起支付

返回结果对比：原返回结果

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": "service=\"mobile.securitypay.pay\"&partner=\"2088821558736584\"&out_trade_no=\"AA20260204145835078594034226\"&subject=\"testProduct\"&body=\"This is the description for the test product\"&total_fee=\"0.04\"&currency=\"CAD\"&payment_type=\"1\"&product_code=\"NEW_WAP_OVERSEAS_SELLER\"&seller_id=\"2088821558736584\"&notify_url=\"https://api.iotpaycloud.com/v1/alinotify\"&forex_biz=\"FP\"&it_b_pay=\"60m\"&secondary_merchant_id=\"344480625\"&secondary_merchant_name=\"IOT&PAY TECHNOLOGIES INC.\"&_input_charset=\"utf-8\"&sign=\"1jDCE7mrFu3BvmfMNsDqCGh%2B5gDblNbX8sZgB5Ex3PKi%2By1Vlec3DTaETpYP6jl%2FuRALV2dGcUs7jcwxL0uRQwkJZeXTLK1t22hbG6skr5mIfgiqkWaHdcLd%2BdG1q8x01CmQbYak3VGW8B4RZlzYHsS1lkdL%2BGlp8HdebYfQnFg%3D\"&sign_type=\"RSA\"",
  "payOrderId": "AA20260204145835078594034226",
  "mchOrderNo": "2329ccdd-3dc4-4cda-9db8-9e7830d462ee",
  "retDetail": "service=\"mobile.securitypay.pay\"&partner=\"2088821558736584\"&out_trade_no=\"AA20260204145835078594034226\"&subject=\"testProduct\"&body=\"This is the description for the test product\"&total_fee=\"0.04\"&currency=\"CAD\"&payment_type=\"1\"&product_code=\"NEW_WAP_OVERSEAS_SELLER\"&seller_id=\"2088821558736584\"&notify_url=\"https://api.iotpaycloud.com/v1/alinotify\"&forex_biz=\"FP\"&it_b_pay=\"60m\"&secondary_merchant_id=\"344480625\"&secondary_merchant_name=\"IOT&PAY TECHNOLOGIES INC.\"&_input_charset=\"utf-8\"&sign=\"1jDCE7mrFu3BvmfMNsDqCGh%2B5gDblNbX8sZgB5Ex3PKi%2By1Vlec3DTaETpYP6jl%2FuRALV2dGcUs7jcwxL0uRQwkJZeXTLK1t22hbG6skr5mIfgiqkWaHdcLd%2BdG1q8x01CmQbYak3VGW8B4RZlzYHsS1lkdL%2BGlp8HdebYfQnFg%3D\"&sign_type=\"RSA\"",
  "payParams": "service=\"mobile.securitypay.pay\"&partner=\"2088821558736584\"&out_trade_no=\"AA20260204145835078594034226\"&subject=\"testProduct\"&body=\"This is the description for the test product\"&total_fee=\"0.04\"&currency=\"CAD\"&payment_type=\"1\"&product_code=\"NEW_WAP_OVERSEAS_SELLER\"&seller_id=\"2088821558736584\"&notify_url=\"https://api.iotpaycloud.com/v1/alinotify\"&forex_biz=\"FP\"&it_b_pay=\"60m\"&secondary_merchant_id=\"344480625\"&secondary_merchant_name=\"IOT&PAY TECHNOLOGIES INC.\"&_input_charset=\"utf-8\"&sign=\"1jDCE7mrFu3BvmfMNsDqCGh%2B5gDblNbX8sZgB5Ex3PKi%2By1Vlec3DTaETpYP6jl%2FuRALV2dGcUs7jcwxL0uRQwkJZeXTLK1t22hbG6skr5mIfgiqkWaHdcLd%2BdG1q8x01CmQbYak3VGW8B4RZlzYHsS1lkdL%2BGlp8HdebYfQnFg%3D\"&sign_type=\"RSA\"",
  "sign": "F1D60EDB111026FDC36DC39DD85B5E3C"
}

新返回结果

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": {
    "url": "https://render.alipay.com/p/c/jzmcoal2/acn-wap-continue.html?url=alipayconnect%3a%2f%2fplatformapi%2facwallet%2falipayconnectcode%3fcode%3dgolcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox%26golSandbox%3dtrue%26pspName%3dALIPAY_CN&paymentId=20260204114010800190184000018685170&callback=https%3A%2F%2Fdev.iotpaycloud.com%2Fv1%2Fgalipayrtn%3Fpayorderid%3DAA20260204145804816118393649&amountValue=0.04&amountCurrency=CAD&county=US&merchantId=21841100000580I7&merchantName=IOT%26%2BPAY%20%E4%BD%A0%E5%A5%BD%20TECHNOLOGIES%20INC.&code=golcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox&referenceOrderId=b4ac8f53-a93f-4a82-8059-307644ce2166&paymentMethodType=ALIPAY_CN",
    "schemeUrl": "alipayconnect://platformapi/acwallet/alipayconnectcode?code=golcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox&golSandbox=true&pspName=ALIPAY_CN",
    "tradeNo": "20260204114010800190184000018685170"
  },
  "payOrderId": "AA20260204145804816118393649",
  "mchOrderNo": "b4ac8f53-a93f-4a82-8059-307644ce2166",
  "retDetail": "https://render.alipay.com/p/c/jzmcoal2/acn-wap-continue.html?url=alipayconnect%3a%2f%2fplatformapi%2facwallet%2falipayconnectcode%3fcode%3dgolcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox%26golSandbox%3dtrue%26pspName%3dALIPAY_CN&paymentId=20260204114010800190184000018685170&callback=https%3A%2F%2Fdev.iotpaycloud.com%2Fv1%2Fgalipayrtn%3Fpayorderid%3DAA20260204145804816118393649&amountValue=0.04&amountCurrency=CAD&county=US&merchantId=21841100000580I7&merchantName=IOT%26%2BPAY%20%E4%BD%A0%E5%A5%BD%20TECHNOLOGIES%20INC.&code=golcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox&referenceOrderId=b4ac8f53-a93f-4a82-8059-307644ce2166&paymentMethodType=ALIPAY_CN",
  "payParams": "alipayconnect://platformapi/acwallet/alipayconnectcode?code=golcashier66511663-9a8f-4cea-b141-ec214bb9bd4asandbox&golSandbox=true&pspName=ALIPAY_CN",
  "sign": "662F9DA3B1E7AF77A2AE016C60F6F660"
}

请求示例

curl --location --request POST 'https://api.iotpaycloud.com/v1/create_order' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Cache-Control: no-cache' \
--header 'Host: api.iotpaycloud.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: acw_tc=2f584a5017709191550335243ec00071ae250a5509c8bf3db46b6407f38bdd' \
--data-urlencode 'params={
    "mchId": "10000576",
    "mchOrderNo": "ef28ca74-f379-4a65-a246-c731d846d87b",
    "jobNo": "abcde",
    "currency": "CAD",
    "channelId": "ALIPAY_MOBILE",
    "amount": 4,
    "returnUrl": "https://iottest.requestcatcher.com",
    "notifyUrl": "https://gptest.requestcatcher.com",
    "subject":"testProduct",
    "body":"This is the description for the test product",
    "clientIp": "192.168.50.127",
    "osType":"ANDROID",
    "sign": "3837C685A81FCEB91C6E182D8294FCFD"
}'

`channelId = ALIPAY_WAP`

支付请求：请求需要传字段 osType 为 ANDROID或IOS

返回结果处理：原retParams.orderStr已弃用！请使用url跳转方式或form表单形式唤起支付

返回结果对比：原返回结果

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": {
    "alipayUrl": "https://invoice.iotpay.ca/wap?payId=AW20260204150515830888365552&payUrl=H4sIAAAAAAAAA5WU0W7aMBSGX8XKxbRdjIQQQ2iBCdFoq8oAFTRUTZNlbId4SmzLcejy9nNICeo2JauUC-v4_N-x_xyfSSx1BjidOjjlCpd5cci4cYDAGfszhonhUkydxBiV37juMZUHnGZY8V6d2CMyc4_YsGe7pvIT4kIVBpEE65yZaWHij6EDMmYSaQsemXFmk3MKMKWy5RJOKROX4q_VDjjhtLDhmuK2KbFSyB6nkTy1px8kvebuEp4D-5mEAcpyormqbg2sT-eYYbkBSktaENOOJYXWTJArejG_a1cIaXhcokKnjaby2lpdecylsZciqSzo2ehT37W215p2rrQ2Go0pQ0I25Pne9_yh53tBH3qwD8OBF4bhYAgh9NtxCmsjmG5IfiX0-xCGIysPgw517R0ikrIGsYr2aD_foPW36HEbzbdoGy2X0WM7SbOY6X-5Vf2jjGnbOcJUVnVhTKHF21y3BrRDc0akoFiX6HIQxGnDHwRBEHpDH74ZUm00mPv17t1m_gR20eLLar1cf76PtuB-teh1YfWJkyuGaGbfLLIdzn699MkzVh2M4vCTkeurrCzf_M-rMNLgFMXsWt7reR0tk_OjaNKHjPjjwcjHOI6D8WEE4z7EBEMyDv0BocNuFKo2Gt7Xu7_-wmXgXVLWDw7ITZnaJeW5SnF5I6Rgt3Z8udX8nE3qOTGjkhQZs01XRfPvr-fnj169eP_hduK-CH4DHry_TX8FAAA=",
    "orderStr": "_input_charset=utf-8&app_pay=Y&body=This+is+the+description+for+the+test+product&currency=CAD&notify_url=http%3A%2F%2Fapi.iotpaycloud.com%2Fv1%2Falinotify&out_trade_no=AW20260204150515830888365552&partner=2088821558736584&product_code=NEW_WAP_OVERSEAS_SELLER&refer_url=http%3A%2F%2Ftestmerchant.com&return_url=http%3A%2F%2Fapi.iotpaycloud.com%2Fv1%2Falirtn&secondary_merchant_id=344480625&secondary_merchant_name=IOT%26PAY+TECHNOLOGIES+INC.&service=create_forex_trade_wap&subject=testProduct&total_fee=0.04&sign=6ec29372aaff49b75f15aca5c9823cd6&sign_type=MD5"
  },
  "payOrderId": "AW20260204150515830888365552",
  "mchOrderNo": "7250ffb4-7f87-4376-ba7c-97540eb9dca1",
  "retDetail": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://globalmapi.alipay.com/gateway.do?_input_charset=utf-8\" method=\"get\"><input type=\"hidden\" name=\"_input_charset\" value=\"utf-8\"/><input type=\"hidden\" name=\"app_pay\" value=\"Y\"/><input type=\"hidden\" name=\"body\" value=\"This is the description for the test product\"/><input type=\"hidden\" name=\"currency\" value=\"CAD\"/><input type=\"hidden\" name=\"notify_url\" value=\"https://api.iotpaycloud.com/v1/alinotify\"/><input type=\"hidden\" name=\"out_trade_no\" value=\"AW20260204150515830888365552\"/><input type=\"hidden\" name=\"partner\" value=\"2088821558736584\"/><input type=\"hidden\" name=\"product_code\" value=\"NEW_WAP_OVERSEAS_SELLER\"/><input type=\"hidden\" name=\"refer_url\" value=\"http://testmerchant.com\"/><input type=\"hidden\" name=\"return_url\" value=\"https://api.iotpaycloud.com/v1/alirtn\"/><input type=\"hidden\" name=\"secondary_merchant_id\" value=\"344480625\"/><input type=\"hidden\" name=\"secondary_merchant_name\" value=\"IOT&PAY TECHNOLOGIES INC.\"/><input type=\"hidden\" name=\"service\" value=\"create_forex_trade_wap\"/><input type=\"hidden\" name=\"subject\" value=\"testProduct\"/><input type=\"hidden\" name=\"total_fee\" value=\"0.04\"/><input type=\"hidden\" name=\"sign\" value=\"6ec29372aaff49b75f15aca5c9823cd6\"/><input type=\"hidden\" name=\"sign_type\" value=\"MD5\"/><input type=\"submit\"  value=\"OK\" style=\"display:none;\"></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "payUrl": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://globalmapi.alipay.com/gateway.do?_input_charset=utf-8\" method=\"get\"><input type=\"hidden\" name=\"_input_charset\" value=\"utf-8\"/><input type=\"hidden\" name=\"app_pay\" value=\"Y\"/><input type=\"hidden\" name=\"body\" value=\"This is the description for the test product\"/><input type=\"hidden\" name=\"currency\" value=\"CAD\"/><input type=\"hidden\" name=\"notify_url\" value=\"https://api.iotpaycloud.com/v1/alinotify\"/><input type=\"hidden\" name=\"out_trade_no\" value=\"AW20260204150515830888365552\"/><input type=\"hidden\" name=\"partner\" value=\"2088821558736584\"/><input type=\"hidden\" name=\"product_code\" value=\"NEW_WAP_OVERSEAS_SELLER\"/><input type=\"hidden\" name=\"refer_url\" value=\"http://testmerchant.com\"/><input type=\"hidden\" name=\"return_url\" value=\"https://api.iotpaycloud.com/v1/alirtn\"/><input type=\"hidden\" name=\"secondary_merchant_id\" value=\"344480625\"/><input type=\"hidden\" name=\"secondary_merchant_name\" value=\"IOT&PAY TECHNOLOGIES INC.\"/><input type=\"hidden\" name=\"service\" value=\"create_forex_trade_wap\"/><input type=\"hidden\" name=\"subject\" value=\"testProduct\"/><input type=\"hidden\" name=\"total_fee\" value=\"0.04\"/><input type=\"hidden\" name=\"sign\" value=\"6ec29372aaff49b75f15aca5c9823cd6\"/><input type=\"hidden\" name=\"sign_type\" value=\"MD5\"/><input type=\"submit\"  value=\"OK\" style=\"display:none;\"></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "sign": "D7EAAFFF029E00D2F8224E67DFA5B2A6"
}

新返回结果

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": {
    "alipayUrl": "https://invoice.iotpay.ca/wap?payId=AW20260204150449967232113341&payUrl=H4sIAAAAAAAAA51T7W7TMBR9lSg_EAgltlO3TVnbqQoTRJpapA4QQgg5ttcY4g85dkd5Gv7wGHsbeA-clmUaPwgiPxz76p57zvW5nl9rKyPBFjFphCGH1ldSuDhSRPI_Y4Q6odUirp0z7TMALFeM2_SUlFItgQEUfPoqqSZNBghVyQ0xCdXKCeV5WjvZxJHkrtaBb8ddvJwLZbyL3MEEtlowxtUdt7cheU8a3-sIhRSnLjCbhrhOODEi0NyQpuEOPEiimvHzblnsdENJWwtu6RSTDPE8qfIxTTCk47AjLKHVFF_nUzaBM9YSxSr95RGR5iwgt6fjwlnPjzHTmnUnb3VZvlq9-1is4wj8rYugSHLlStb3ksFsAjOIEcIQwRxCNIMoxzB8KJ_kaDTKBmrS0G9F6Oe-5J0hjO9ToV13C4327GjJHoHd6WasU-fhp20wLRi-etsrGUOMZ7PJNBtlKPBjNCCASO2Ve9OR9xpgCvE_wQpvw-DQQ48sVs-HGu5w94DX24F8GbyuiXKdUz2q3FwdHXwafIt-3H77-f02urooXq43l5sX5cU2KtdFOiiE3Rf8r8E6EoBudpfzllph3JJp6rsZSbto-_7ho_uQnjaPn5zNwW_AL7EsDbW0AwAA",
    "url": "https://render.alipay.com/p/c/jzmcoal2/acn-wap-continue.html?url=alipayconnect%3a%2f%2fplatformapi%2facwallet%2falipayconnectcode%3fcode%3dgolcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox%26golSandbox%3dtrue%26pspName%3dALIPAY_CN&paymentId=20260204114010800190184000018681332&callback=https%3A%2F%2Fdev.iotpaycloud.com%2Fv1%2Fgalipayrtn%3Fpayorderid%3DAW20260204150449967232113341&amountValue=0.04&amountCurrency=CAD&county=US&merchantName=IOT%26%2BPAY%20%E4%BD%A0%E5%A5%BD%20TECHNOLOGIES%20INC.&code=golcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox",
    "tradeNo": "20260204114010800190184000018681332"
  },
  "payOrderId": "AW20260204150449967232113341",
  "mchOrderNo": "e9689496-2923-4de0-81cc-dc349c052e52",
  "retDetail": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://render.alipay.com/p/c/jzmcoal2/acn-wap-continue.html\" method=\"get\"><input type=\"hidden\" name=\"url\" value=\"alipayconnect://platformapi/acwallet/alipayconnectcode?code=golcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox&amp;golSandbox=true&amp;pspName=ALIPAY_CN\" /><input type=\"hidden\" name=\"paymentId\" value=\"20260204114010800190184000018681332\" /><input type=\"hidden\" name=\"callback\" value=\"https://dev.iotpaycloud.com/v1/galipayrtn?payorderid=AW20260204150449967232113341\" /><input type=\"hidden\" name=\"amountValue\" value=\"0.04\" /><input type=\"hidden\" name=\"amountCurrency\" value=\"CAD\" /><input type=\"hidden\" name=\"county\" value=\"US\" /><input type=\"hidden\" name=\"merchantName\" value=\"IOT&amp;+PAY 你好 TECHNOLOGIES INC.\" /><input type=\"hidden\" name=\"code\" value=\"golcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox\" /></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "payUrl": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://render.alipay.com/p/c/jzmcoal2/acn-wap-continue.html\" method=\"get\"><input type=\"hidden\" name=\"url\" value=\"alipayconnect://platformapi/acwallet/alipayconnectcode?code=golcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox&amp;golSandbox=true&amp;pspName=ALIPAY_CN\" /><input type=\"hidden\" name=\"paymentId\" value=\"20260204114010800190184000018681332\" /><input type=\"hidden\" name=\"callback\" value=\"https://dev.iotpaycloud.com/v1/galipayrtn?payorderid=AW20260204150449967232113341\" /><input type=\"hidden\" name=\"amountValue\" value=\"0.04\" /><input type=\"hidden\" name=\"amountCurrency\" value=\"CAD\" /><input type=\"hidden\" name=\"county\" value=\"US\" /><input type=\"hidden\" name=\"merchantName\" value=\"IOT&amp;+PAY 你好 TECHNOLOGIES INC.\" /><input type=\"hidden\" name=\"code\" value=\"golcashierc74a21e8-b85c-40c5-b8ad-cb74f87d609dsandbox\" /></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "sign": "FF8ACA0D720BEE6C209276CE5312FBCC"
}

请求示例

curl --location --request POST 'https://api.iotpaycloud.com/v1/create_order' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Accept: */*' \
--header 'Cache-Control: no-cache' \
--header 'Host: api.iotpaycloud.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: acw_tc=2f584a5017709191550335243ec00071ae250a5509c8bf3db46b6407f38bdd' \
--data-urlencode 'params={
    "mchId": "10000576",
    "mchOrderNo": "d5195b47-98e7-4745-8e65-f4779318df51",
    "jobNo": "abcde",
    "currency": "CAD",
    "channelId": "ALIPAY_WAP",
    "amount": 4,
    "returnUrl": "https://iottest.requestcatcher.com",
    "notifyUrl": "https://gptest.requestcatcher.com",
    "subject":"testProduct",
    "body":"This is the description for the test product",
    "osType":"ANDROID",
    "clientIp": "192.168.50.127",
    "sign": "BA42C8AC68D06A095EF3FD88DDE6BA3C"
}'

统一下单

统一下单

API 请求

端点

方法

头部

参数说明

参数示例

附加参数extra说明

小程序支付(WX_JSAPI)

微信App支付(WX_APP)

微信原生扫码支付（WX_NATIVE）

返回结果

channelId=ALIPAY_PC or ALIPAY_WAP or UPI_SEQ

channelId=ALIPAY_QR

channelId=WX_NATIVE

channelId=CC_PAX

参数示例

下单测试

changelog

2026-03-10

返回值改动说明

`channelId = ALIPAY_PC`

`channelId = ALIPAY_MOBILE`

`channelId = ALIPAY_WAP`