General Order API

General Order

Merchants can call General Order API to launch payment without diving into the details of how to integrate third party payment systems. IOTPay will handle third party API calls and respond to merchant according to the different channel.

An image

For in-App integration, Merchant App send payment request to IOTPay API server, then IOTPay API return the encrypted data to the Merchant App. With the encrypted dat, Merchant App can send them to Alipay/WeChat pay server via their corresponding SDK. Finally, IOTPay API server will notify merchant backend server when the transaction is successful.

An image

For detail of how to integrate in merchant app, please refer to app integration

After 2026-March-10, ALIPAY channelId = ALIPAY_MOBILE is not supported SDK integration. Please use diagram below for integration.

An image

API Request

Endpoint

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

Method

POST

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

Parameters

Name	Required	Type	Sample	Description
mchId	y	String(30)	10000701	merchant id assigned by IOTPay
mchOrderNo	y	String(30)	20160427210604000490	order id assigned by merchant need to be unique
channelId	y	String(24)	WX_NATIVE	see more channel id
currency	y	String(3)	CAD	3 letter representation for currency,eg:CAD
amount	y	int	100	payment amount in cents,eg. $28.65 is 2865
clientIp	y	String(32)	210.73.10.148	client ip
device	n	String(64)	WEB	device type(offline shop),use "WEB" when integrated on web
osType	n	String(10)	IOS	ALIPAY_MOBILE and ALIPAY_WAP are required! Possible values: IOS, ANDROID
notifyUrl	y	String(200)	http://xxx.com/notify.php	get notify when succeeded
subject	y	String(64)	test product	product title
body	y	String(255)	this product is for fun	product description
param1	n	String(64)	can be ignored
param2	n	String(64)	will return original value in notify
extra	y	String(512)		WeChat mini program，WX_APP,WX_NATIVE need this
returnUrl	n	String(200)	ALIPAY_PC,ALIPAY_WAP,ALIPAY_MOBILE need this	redirect to this url after payment
jobNo	y	String(50)		merchant login name
remarks	n	String(200)		remarks
sign	y	String(32)	C380BEC2BFD727A4B6845133519F3AD6	signature

Parameter Sample

params={"amount":1,"mchId":"10000000","mchOrderNo":"9af01329f1ec4c4694631b077a0e8573","subject":"product title","sign":"F64C43C1487C7C0DA93DA93DD2961FA2","body":"product desc","param1":"","param2":"","clientIp":"127.0.0.1","extra":"{\"openId\":\"osirq1MMdgrCw7ohNNV6JhwvDFO8\"}","notifyUrl":"http://ngrok.4jicao.com/goods/payNotify","currency":"CAD","device":"WEB","channelId":"WX_JSAPI"}

Extra Parameter

WeChat App Pay(WX_APP)

Name	Required	Type	Sample	Description
extra	required	JSON	{"type":"apppay","appId":"xxxxxxxxx"}

Mini Program(WX_JSAPI)

Name	Required	Type	Sample	Description
extra	required	JSON	{"openId":"o2RvowBf7sOVJf8kJksUEMceaDqo", "type":"minipay","appId":"xxxxxxxxx"}

Users use WeChat to scan Merchant's QR Code（WX_NATIVE）

Name	Required	Type	Sample	Description
extra	required	JSON	{"productId":"120989823"}	productId is required

Extra Sample Data

"extra":"{\"cardType\":\"M\",\"cardNum\":\"XXXXXXXXXXXX1166\",\"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\"}"

Notice

Parameter mchOrderNo will be put into param1 when IOT Pay sends notify to the merchant's notifyUrl provided, please don't fill param1 when creating order.

After payment, Merchant's backend server still need notifyUrl to decide whether the transaction is successful

Return Result

Name	Required	Type	Sample	Description
retCode	y	String	SUCCESS	SUCCESS/FAIL retCode indicate communication status, need to check resCode for transaction
retMsg	n	String	signature fail	if not empty, it is error message
sign	y	String	C380BEC2BFD727A4B6845133519F3AD6	signature

channelId=ALIPAY_PC or ALIPAY_WAP or UPI_SEQ

Name	Required	Type	Sample	Description
payOrderId	y	String	payment order id	order id assigned by third party payment system
payUrl	y	String		merchant need to redirect to this url, just echo payUrl to client or redirect to url in retParams
retParams	y	Array		for ALIPAY_WAP, merchant need to redirect to retParams.alipayUrl,for UPI_SEQ,redirect to retParams.unionpayUrl

channelId=ALIPAY_QR

Name	Required	Type	Sample	Description
payOrderId	y	String	payment order id	order id assigned by third party payment system
qr_code	y	String		merchant use this value to generate qr code for alipay scan

channelId=WX_NATIVE

Name	Required	Type	Sample	Description
payOrderId	y	String	payment order id	order id assigned by third party payment system
codeUrl	y	String		merchant use this value to generate qr code for WeChat scan
prepayId	y	String		prepayId is return from WeChat pay

channelId=CC_PAX

Name	Required	Type	Sample	Description
extra	y	String(json)	{"cardType":"M","cardNum":"XXXXXXXXXXXX1166","expireDate":"1022"}	credit card transaction info

Demo and source code

general order demo source code download

merchant scan demo source code download

online signature checker demo

Changelog

2026-03-10

Add required field osType when channelId=ALIPAY_MOBILE , channelId=ALIPAY_WAP and the value should be ANDROID or IOS
Change response parameter for channelId=ALIPAY_PC, ALIPAY_WAP, ALIPAY_MOBILE

Response parameter change description

channelId = ALIPAY_PC

New response parameter retParams.url and retParams.tradeNoretParams.url can be used for redirect retParams.tradeNo is the order number for alipay, can be used for alipay jssdk or alipay mini program to pay

Response parameter comparison: Original response

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": {
    "alipayUrl": "https://invoice.iotpay.ca/wap?payId=AP20260204145125919667231095&payUrl=H4sIAAAAAAAAA5WU3Y7aMBCFX8XKRdVelPyQQNgFKsRGLVoKaEGtqqqyHHsgrhI7chzavH0dUoK2XSWtlAtrPOeb-Hg806NUGeJsZpGU56Qqyjjj2kKCZPBnjFDNpZhZidZ5cWfbp1TGJM1IzgdN4oDKzD4RDT_Mmsl3mIu81JgmRBWgZ6U-vg0tlIFOpCl4Am3Np5cUpKvclEs4YyCuxZ-rLXQmaWnCDcXuUsaSVW3-IeEFMp9OADEoqOJ5fQxkDn6JaSg0ypVkJdXdWFoqBYLe0MvFQ7dCSM2PFS5V2mpq84x3tWlcamMaTWXJLs6dXdv42Gi6udL4ohVhgIVsyYud53gjx3N81w9cL5i4k9Fo7A1dZxJ043KitADVkjwnDEPPDYJwPBwFod-jbrzDVDJoEZvoM95-ip720WKP99F6HT11UxQcQb3kVH0_GSjTBkLXNvVhdKnE_zluDt8NLYBKwYiq8PVHMGctf-j7fuiMvB6TX4DUGy1mtT282i2-oEO0_LDZrrfvV9EerTbLQR9WnTm9YagC8wCx6W742fRIj76MvwO9Pa_a7t2_vAYtNUnxEW6lnYHT0yoFP4k23SdeMI7DgLiU-GwYEEomQRATb8xYPAHaj8L1Rsv7-PDXDVwn1zVl-2ihQlepWTJe5Cmp7oQUcG_mkF0Pwvm0mQ9zJmmZgWm4Olp8fT4Ivw2axes391P7t-AXfNSA7EgFAAA="
  },
  "payOrderId": "AP20260204145125919667231095",
  "mchOrderNo": "2cd16747-e779-4871-8059-5723de46b477",
  "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=\"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=\"AP20260204145125919667231095\"/><input type=\"hidden\" name=\"partner\" value=\"2088821558736584\"/><input type=\"hidden\" name=\"product_code\" value=\"NEW_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\"/><input type=\"hidden\" name=\"subject\" value=\"testProduct\"/><input type=\"hidden\" name=\"total_fee\" value=\"0.04\"/><input type=\"hidden\" name=\"sign\" value=\"4a257b85a1ca4d35aca955ba27ddb9ec\"/><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=\"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=\"AP20260204145125919667231095\"/><input type=\"hidden\" name=\"partner\" value=\"2088821558736584\"/><input type=\"hidden\" name=\"product_code\" value=\"NEW_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\"/><input type=\"hidden\" name=\"subject\" value=\"testProduct\"/><input type=\"hidden\" name=\"total_fee\" value=\"0.04\"/><input type=\"hidden\" name=\"sign\" value=\"4a257b85a1ca4d35aca955ba27ddb9ec\"/><input type=\"hidden\" name=\"sign_type\" value=\"MD5\"/><input type=\"submit\"  value=\"OK\" style=\"display:none;\"></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "sign": "AC0F46954BC50C12C0A3F3259E205854"
}

new response

{
  "resCode": "SUCCESS",
  "retCode": "SUCCESS",
  "retParams": {
    "alipayUrl": "https://invoice.iotpay.ca/wap?payId=AP20260204144737045984948022&payUrl=H4sIAAAAAAAAA41S0W7TMBT9FSsPCISS2K7XJKwrqsIEkUY7qQUJIYRuba-JiO3Icar1b3jhM_Y38B84bZcJXjK_2L6555zrkzO7M1ahSlwFUFcNHNpuqyoXIA1K_l8D7iqjr4LSuaZ9E8fAo1NDxI2KG9jJuAUttuY-PtWbumtDDm1ZSRs2aw46Kp2qA6SkK43X3EkXzGeVbjqH3KHximUlhNSP-p5DSe0-Hts3viFAe6g7_2VxU9wuvnzPlwGKn8FQiAFJMZ1iihkhDBOcYkwyTFKG_SLpNCWTCR7h5FDXW-A_BspHQ4TcR5VxXpPXphNHW_Yk3p3csE6_9ZuxQlpv-OJ2mISxZJJgdpGlLGMppnRkAFCm0-5zLz7MgCPMngXLO2ul5ocBmS_ejT24xz0BPq1H-pW0vATtlv42oIrV5gWo5vK1_2_o98PPP78e0OY6_7Bc3azeF9drVCzzaHQQ8US4M_U5WxOYbgkXOMwoxiGjFEJISBLKu4SSDOgFAzgn8ygQ96Gfz1puq8bNheFdn5Gor7Zf_w39t-h0ePnqchafAX8BjtSJ4zQDAAA=",
    "url": "https://ac.alipay.com/page/sandbox/alipayplus-cashier-pScan.html?paymentMethodType=ALIPAY_CN&paymentId=20260204114010800190184000018681330&callback=https%3A%2F%2Fdev.iotpaycloud.com%2Fv1%2Fgalipayrtn%3Fpayorderid%3DAP20260204144737045984948022&amountValue=0.04&amountCurrency=CAD&county=US&merchantName=IOT%26%2BPAY%20%E4%BD%A0%E5%A5%BD%20TECHNOLOGIES%20INC.&code=golcashier3a6b1cd0-9200-422a-a717-ef7219a254aasandbox",
    "tradeNo": "20260204114010800190184000018681330"
  },
  "payOrderId": "AP20260204144737045984948022",
  "mchOrderNo": "0f8f9f38-6eca-4c26-8879-ee63929d2747",
  "retDetail": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://ac.alipay.com/page/sandbox/alipayplus-cashier-pScan.html\" method=\"get\"><input type=\"hidden\" name=\"paymentMethodType\" value=\"ALIPAY_CN\" /><input type=\"hidden\" name=\"paymentId\" value=\"20260204114010800190184000018681330\" /><input type=\"hidden\" name=\"callback\" value=\"https://dev.iotpaycloud.com/v1/galipayrtn?payorderid=AP20260204144737045984948022\" /><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=\"golcashier3a6b1cd0-9200-422a-a717-ef7219a254aasandbox\" /></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "payUrl": "<form id=\"alipaysubmit\" name=\"alipaysubmit\" action=\"https://ac.alipay.com/page/sandbox/alipayplus-cashier-pScan.html\" method=\"get\"><input type=\"hidden\" name=\"paymentMethodType\" value=\"ALIPAY_CN\" /><input type=\"hidden\" name=\"paymentId\" value=\"20260204114010800190184000018681330\" /><input type=\"hidden\" name=\"callback\" value=\"https://dev.iotpaycloud.com/v1/galipayrtn?payorderid=AP20260204144737045984948022\" /><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=\"golcashier3a6b1cd0-9200-422a-a717-ef7219a254aasandbox\" /></form><script>document.forms[\"alipaysubmit\"].submit();</script>",
  "sign": "44426F201A638ED868D21FF1238AD808"
}

request example

curl --location --request POST 'https://api.iotpaycloud.com/v1/create_order' \
--header 'Accept: */*' \
--header 'Cache-Control: no-cache' \
--header 'Host: api.iotpaycloud.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'params={
    "mchId": "10000576",
    "mchOrderNo": "ae5750cf-d387-4130-8aa2-523d91c4c382",
    "jobNo": "abcde",
    "currency": "CAD",
    "channelId": "ALIPAY_PC",
    "amount": 14,
    "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",
    "sign": "2E7E5F2FE5678B03CCBB441082C37A52"}'

`channelId = ALIPAY_MOBILE`

Request params changed: osType is required and should be ANDROID or IOS

Response changed: The original retParams, retDetail and payParams are format of orderStr which is deprecated. payParams is the scheme url to open Alipay app retDetail is the html form to open Alipay page retParams.tradeNo is the order id of Alipay, which can be used to pay with Alipay's jssdk or Alipay's mini program

Response comparison: original response:

{
  "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"
}

New response:

{
  "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"
}

Request sample:

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`

Request parameters changed: osType is required and should be ANDROID or IOS

Response changed: orderStr is deprecated. Please use retParams.url or retParams.alipayUrl to redirect or use retDetail to submit.

Response comparison: original response:

{
  "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"
}

New response:

{
  "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"
}

Request example:

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"
}'