# Query and set up authorization pages and merchant information

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: invoicebizsetattr

This interface provides a series of functions for managing authorization pages and merchant information:

Authorized page field management:

• Set_auth_field: Used to set the information that the user needs to fill in on the type = 1 type authorization page, set to a one-time unless the field needs to be adjusted.
• Get_auth_field: Used to query the field settings of the authorization page.

Merchant-ticketing platform related management:

• Set_pay_mch: Used to associate the merchant number with the billing platform's identification number, set to be one-time, unless the identification number changes or the billing platform changes.
• Get_pay_mch: Used to check the binding of merchants and billing platforms. Merchant contact information management:
• Set_contact: Used to set the connection method of the merchant before obtaining the authorized link.
• Get_contact: Used to get the connection method of the merchant.

These interfaces use the get parameter to determine the specific usage, suitable for different scenarios and requirements, the specific parameters and applicable scenarios are as follows

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/card/invoice/setbizattr?access_token=ACCESS_TOKEN&action=ACTION

# Cloud Calls

• This interface does not support cloud calls

# Third party invocation

• This interface supports Third Party Platform generation business call.

• The permission set to which this interface belongs is: 26

• When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parametersQuery String parameters

# Request BodyRequest Payload

# Body.auth_fieldObject Payload

Authorization page field (used by set_auth_field)

# Body.paymch_infoObject Payload

WeChat Merchant Number and Billing Platform Relationship Information (set_pay_mch used)

# Body.contactObject Payload

Contact information (set_contact)

# Body.auth_field.user_fieldObject Payload

Personal Invoices Field on the Authorization Page

# Body.auth_field.user_field.custom_field(Array)Object Payload

Custom fields

# Body.auth_field.biz_fieldObject Payload

Authorization page unit invoice field

# Body.auth_field.biz_field.custom_field(Array)Object Payload

Custom fields

# 3. Return Parameters

# Response Payload

# Res.auth_fieldObject Payload

Authorization page field (set_auth_field, get_auth_field returns)

# Res.paymch_infoObject Payload

WeChat Merchant number and billing platform relationship information (get_pay_mch returns)

# Res.contactObject Payload

Contact information (get_contact returns)

# Res.auth_field.user_fieldObject Payload

Personal Invoices Field on the Authorization Page

# Res.auth_field.user_field.custom_field(Array)Object Payload

Custom fields

# Res.auth_field.biz_fieldObject Payload

Authorization page unit invoice field

# Res.auth_field.biz_field.custom_field(Array)Object Payload

Custom fields

# 4. Note

There are no special considerations for this interface

# 5. Code examples

# 5.1 Set authorization page field information

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=set_pay_mch&access_token={access_token}

{
    "auth_field" : {
        "user_field" : {
            "require_phone" : 1,
            "custom_field" : [
                {
                    "is_require" : 1,
                    "key" : "field1"
                }
            ],
            "show_email" : 1,
            "show_title" : 1,
            "show_phone" : 1,
            "require_email" : 1
        },
        "biz_field" : {
            "require_phone" : 0,
            "custom_field" : [
                {
                    "is_require" : 0,
                    "key" : "field2"
                }
            ],
            "require_bank_type" : 0,
            "require_tax_no" : 0,
            "show_addr" : 1,
            "require_addr" : 0,
            "show_title" : 1,
            "show_tax_no" : 1,
            "show_phone" : 1,
            "show_bank_type" : 1,
            "show_bank_no" : 1,
            "require_bank_no" : 0
        }
    }
}

Return an example

{
    "errcode": 0,
    "errmsg": "ok"
}

# 5.2 Query the authorization page field information

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=get_pay_mch&access_token={access_token}

{}

Return an example

{
    "errcode": 0,
    "errmsg": "ok",
    "auth_field": {
        "user_field": {
            "show_title": 1,
            "show_phone": 1,
            "show_email": 1,
            "custom_field": [{"key": "field1"}]
        },
        "biz_field": {
            "show_title": 1,
            "show_tax_no": 1,
            "show_addr": 1,
            "show_phone": 1,
            "show_bank_type": 1,
            "show_bank_no": 1,
            "custom_field": [{"key": "field2"}]
        }
    }
}

# 5.3 Affiliated merchant numbers and billing platforms

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=set_pay_mch&access_token={access_token}

{
  "paymch_info": {
    "mchid": "1234",
    "s_pappid": "wxabcd"
  }
}

Return an example

{
  "errcode": 0,
  "errmsg": "ok"
}

# 5.4 Find out how the merchant number is linked to the billing platform

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=get_pay_mch&access_token={access_token}

{}

Return an example

{
  "errcode": 0,
  "errmsg": "ok",
  "paymch_info":
  {
    "mchid": "1234",
    "s_pappid": "wxabcd"
  }
}

# 5.5 Set up a merchant contact details

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=set_contact&access_token={access_token}

{
  "contact" :
  {
    "phone" : "88888888",
    "time_out" : 12345
  }
}

Return an example

{
  "errcode": 0,
  "errmsg": "ok"
}

# 5.6 Find out merchant contact details

Example Requests

https://api.weixin.qq.com/card/invoice/setbizattr?action=get_contact&access_token={access_token}

{}

Return an example

{
  "contact" : {
    "phone" : "88888888",
    "time_out" : 12345
  },
  "errcode" : 0,
  "errmsg" : "ok"
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

# 7. Scope of application