# Wechat JSAPI integration(mobile web)

This document is for adding wechat pay on web page, only when the page is in wechat browser.

# Request URL

Endpoint: https://api.iotpaycloud.com/v1/payForSubmit

Request method:

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

# parameters

name required type sample description
mchId y String(30) 20001222 merchant id assigned by IOTPay
mchOrderNo y String(30) 20160427210604000490 order number in merchant system,need to be unique
currency y String(3) CAD 3 letters representation for currency
qrcode_pay n int 1 set this param only in qrcode mode
channelId y String(24) WX_JSAPI see more channel id
amount y int 100 payment amount,in cents,eg. $28.56 is 2856
clientIp y String(32) client ip
returnUrl y String(200) http://xxx.com/success.php redirect url after payment
notifyUrl y String(200) http://xxx.com/notify.php IOTPay will notify this url when payment success
subject y String(64) product id or title product id or title
body y String(255) product description product description
param1 n String(64) don't pass value in this field,
will return mchOrderNo in notify
param2 n String(64) will return original value in notify
extra n String(512)
jobNo y String(50) merchant login name
remarks n String(200) remarks
sign y String(32) C380BEC2BFD727A4B6845133519F3AD6 signature


When get notify, parameter "mchOrderNo" will be put into "param1",let "param1" empty when sending request.

After payment,merchant backend server still need notifyUrl to judge 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
url y String if success=true, redirect to url
code_url n String return only when qrcode_pay=1 in request

When code_url returned, merchant side should generate QR Code image based on code_url

# parameters passed to returnUrl and notifyUrl

name type sample description
payOrderId String order id of IOTPay
mchOrderNo String order id of merchant
channelOrderNo String order id of Alipay/Wechat Pay
status Int success code: 2 or 3
amount Int in cents
param1 String
param2 String

# error code

more error code

# JSAPI web demo and source code

test page(please use wechat to open this page)click here

source code download

Last Updated: 4/12/2021, 11:49:33 AM