顾客扫描二维码

提示

此端点会生成一个一次性付款二维码,供商家收款。顾客可以使用支付宝、微信或银联支付提供的扫码功能,扫描该端点生成的商家二维码以发起支付。

工作原理

端点

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

方法

POST

头部

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

! 提示

在收到访问凭证(商户 ID、登录名、商户密钥)之后, 您可以按照演示统一下单在新窗口打开并选择channel WX_NATIVEALIPAY_QRUPI_QR进行测试。 这可能在阅读文档时对您有所帮助。

请求
变量名必填类型示例值描述
mchIdyString(30)10000701由 IOTPay 分配
mchOrderNoyString(30)20160427210604000490由商户分配的订单号(不可重复)
jobNoyString(50)商户的登录名
currencyyString(3)CAD三字符货币缩写,仅支持CADUSDWX_NATIVE额外支持CNY
channelIdyString(24)WX_NATIVEWX_NATIVE, ALIPAY_QR, UPI_QR 此三种频道支持客户扫描二维码
amountyint100金额,以分为单位
devicenString(64)WEB设备型号(线下商户如餐厅),线上商户请用 WEB
notifyUrlyString(200)http://xxx.com/notify.php支付成功时获取通知
returnUrlnString(200)ALIPAY_PC,ALIPAY_WAP need this付款后重定向到此 URL
subjectyString(64)test product商品名
bodyyString(255)this product is for fun商品介绍
extray*String(512){"productId":"120989823"}WX_NATIVE 频道需要由商家分配的商品ID
remarksnString(200)备注
clientIpyString(32)210.73.10.148客户端IP地址
signyString(32)C380BEC2BFD727A4B6845133519F3AD6签名算法

提示

由于兼容性要求,我们要求参数被包装如下:

params={"amount":1,"mchId":"10000000","mchOrderNo":"9af01329f1ec4c4694631b077a0e8573","subject":"product title","sign":"F64C43C1487C7C0DA93DA93DD2961FA2","body":"product desc","clientIp":"127.0.0.1","extra":"{\"productId\":\"productTest001\"}","notifyUrl":"http://ngrok.4jicao.com/goods/payNotify","currency":"CAD","device":"WEB","channelId":"WX_NATIVE"}
响应
变量名必填类型示例值描述
resCodeyStringSUCCESS or FAIL
retCodeyStringSUCCESS or FAIL
retParamsyStringweixin://wxpay/bizpayurl?pr=nk******zz支付宝、微信或银联支付的支付链接
payOrderIdyStringWN20240101003753223310135049IOTPay 生成的订单号
mchOrderNoyString20160427210604000490由商户分配的订单号
retDetailyStringweixin://wxpay/bizpayurl?pr=nk******zz支付宝、微信或银联支付的支付链接
codeUrlnStringweixin://wxpay/bizpayurl?pr=nk******zz微信的支付链接
qr_codenStringhttps://qr.alipayplus.com/28******1j0Zc支付宝或银联支付的支付链接
signyStringC380BEC2BFD727A4B6845133519F3AD6签名 响应验证

支付结果通知

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

上次更新: