WeChat Mini Program

This endpoint requires the merchant to have a pre-existing WeChat Mini Program that is registered under a non-Chinese company.

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 number in merchant system, need to be unique
channelId	y	String(24)	`WX_JSAPI`	Fixed to `WX_JSAPI`
currency	y	String(3)	CAD	3 letters representation for currency
amount	y	int	100	payment amounts, in cents, e.g. $28.56 is 2856
clientIp	y	String(32)	210.73.10.148	Client IP
device	n	String(64)	WEB	device identifier
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	the description of the product
param1	n	String(64)	IOTPay will send back the original value
param2	n	String(64)	IOTPay will send back the original value
extra	y	String(512)	`{"openId":"o2R****eaDqo", "type":"minipay","appId":"xxxxxxxxx"}`
jobNo	y	String(50)		merchant login name
remarks	n	String(200)		remarks
sign	y	String(32)	C380BEC2BFD727A4B6845133519F3AD6	signature

When merchant get the response from IOTPay API, pass the returned parameters to mini program. Mini program will call wx.requestPayment with these parameters.

wx.requestPayment({
  appId: res.data.payParams.appId,
  timeStamp: res.data.payParams.timeStamp,
  nonceStr: res.data.payParams.nonceStr,
  package: res.data.payParams.package,
  signType: res.data.payParams.signType,
  paySign: res.data.payParams.paySign,
  success(res) {
    console.log(res)
    wx.navigateTo({
      url: '',
    })
  },
  fail(res) {
    console.log(res)
    wx.navigateTo({
      url: '',
    })
  },
})

After payment, merchant backend server still need notifyUrl to judge whether the transaction is successful

Return Fields

Name	Required	Type	Sample	Description
retCode	y	String(16)	SUCCESS	SUCCESS/FAIL this field indicate communication result, not transaction. Need to check `resCode` to see whether transaction succeed
retMsg	n	String(128)	signature error	error message

The following fields will return when `retCode` and `resCode` are both SUCCESS

Name	Required	Type	Description
payOrderId	y	String	payment order ID
payParams	y	Array	the parameters for mini program to call `wx.requestPayment`
sign	y	String	signature

Error Code

more error code

Sample Code

sample code download