IOTPay DocumentationIOTPay Documentation
  • Introduction
  • Signing
  • General Order API
  • Customer Scan QR Code
  • Merchant Scan Barcode
  • Payment in WeChat Web Browser
  • WeChat Mini Program
  • Online Secure Payment
  • App integrate IOTPay
  • Order Query
  • Asynchronous Notify
  • Get Client IP
  • Refund interface
  • Query Refund
  • POS Semi-Integration
  • Wordpress WooCommerce plugin
  • V3

    • Introduction
    • Redirected Integration
    • Redirected Integration With 3DS and AVS
    • Embedded Integration
    • Direct Method
    • Query Card
    • Purchase With Token
    • Purchase with Wallet
    • Void Transaction
    • Refund Transaction
    • Query Transaction
    • UnionPay ExpressPay API
  • V2

    • Credit Card API V2(Deprecated)
  • Introduction
  • Contract Signing
  • Payment
  • Query Order API
  • Callback
  • English
  • 简体中文
  • Introduction
  • Signing
  • General Order API
  • Customer Scan QR Code
  • Merchant Scan Barcode
  • Payment in WeChat Web Browser
  • WeChat Mini Program
  • Online Secure Payment
  • App integrate IOTPay
  • Order Query
  • Asynchronous Notify
  • Get Client IP
  • Refund interface
  • Query Refund
  • POS Semi-Integration
  • Wordpress WooCommerce plugin
  • V3

    • Introduction
    • Redirected Integration
    • Redirected Integration With 3DS and AVS
    • Embedded Integration
    • Direct Method
    • Query Card
    • Purchase With Token
    • Purchase with Wallet
    • Void Transaction
    • Refund Transaction
    • Query Transaction
    • UnionPay ExpressPay API
  • V2

    • Credit Card API V2(Deprecated)
  • Introduction
  • Contract Signing
  • Payment
  • Query Order API
  • Callback
  • English
  • 简体中文
  • General Order

    • Introduction
    • Signing
    • General Order API
    • Customer Scan QR Code
    • Merchant Scan Barcode
    • Payment in WeChat Web Browser
    • WeChat Mini Program
    • Online Secure Payment
    • App integrate IOTPay
    • Order Query
    • Asynchronous Notify
    • Get Client IP
    • Refund interface
    • Query Refund
    • POS Semi-Integration
    • Wordpress WooCommerce plugin
  • CreditCard

    • V3

      • Introduction
      • Redirected Integration
      • Redirected Integration With 3DS and AVS
      • Embedded Integration
      • Direct Method
      • Query Card
      • Purchase With Token
      • Purchase with Wallet
      • Void Transaction
      • Refund Transaction
      • Query Transaction
      • UnionPay ExpressPay API
    • Credit Card API V2(Deprecated)
  • Autodebit

    • Introduction
    • Contract Signing
    • Payment
    • Query Order API
    • Callback

Introduction

Preparation before integration

Before starting the technical integration, merchants need to sign a contract with IOTPay for the related products and obtain the merchant ID, merchant key, and merchant login name.
For assistance, please contact the IOTPay business team.

Withholding (Auto-Debit) Function Description

After completing the signing process with the user, the merchant can directly debit from the user’s signed wallet.

Withholding Rules

  1. The same contract and the same user can only be signed once. Repeated signing will result in signing failure.
  2. After signing, both the merchant and the user can terminate the contract.
  3. After a debit, a full refund will not restore the remaining debit count within the billing cycle.
  4. Withholding is currently supported only for WeChat Pay.
  5. Current WeChat withholding restrictions (subject to the contract terms):
  • Single transaction limit: CAD 30
  • Daily limit: CAD 30
  • Monthly limit: CAD 30
  • Maximum transactions per day: 1
  • Maximum transactions per month: 3

API Request

Method

POST

Header

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

List of All Channels

Channel IDChannel Description
WX_JSAPIWeChat Mini Program / H5 / In-App (WeChat Official Account)
WX_MWEBPC-side QR Code Payment
WX_APPWeChat Payment in Merchant’s App

Refund

Use the Refund API to process refunds for auto-debit orders.

Last Updated: 8/20/25, 3:05 PM
Next
Contract Signing