회원카드 영역 (2)


8 멤버십 카드 관리

8.1 회원 정보 가져오기(포인트 쿼리) 인터페이스

인터페이스 설명

개발자가 활성화 정보, 포인트 정보, 잔액 및 기타 정보를 포함하여 카드 ID 및 코드를 기반으로 회원 정보를 쿼리하도록 지원합니다. .

인터페이스 호출 요청 설명

HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/membercard/userinfo/get?access_token=TOKEN

매개변수 설명

POST 데이터매개변수 이름            
매개변수                      필수입니다                         이 전화 인터페이스 자격 증명
{   "card_id": "pbLatjtZ7v1BG_ZnTjbW85GYc_E8",   "code": "916679873278"}
필수인가요?                   설명                    ~ >

반환 데이터

{
    "errcode": 0,
    "errmsg": "ok",
    "openid": "obLatjjwDolFjRRd3doGIdwNqRXw",
    "nickname": "Fourier",
    "membership_number": "316510891298",
    "bonus": 460,
    "sex": "MALE",
    "user_info": {
        "common_field_list": [
            {
                "name": "USER_FORM_INFO_FLAG_MOBILE",
                "value": "15521328888"
            },
            {
                "name": "USER_FORM_INFO_FLAG_NAME",
                "value": "微信"
            }
        ],
        "custom_field_list": []
    },
    "user_card_status": "NORMAL"
}
errm sg                                                                                         > 잔액 정보 User Gender_info custom_field_list 8.2 멤버십 카드 정보 변경 인터페이스 인터페이스 설명 멤버십 카드 표면 정보 및 쿠폰 속성 정보 변경을 지원합니다. 인터페이스 호출 요청 설명
HTTP请求方式: POSTURL:https://api.weixin.qq.com/card/update?access_token=TOKEN
매개변수 설명매개변수                       is ​ ​ 통화 인터페이스 자격 증명

POST 데이터

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "background_pic_url": "https://mmbiz.qlogo.cn/mmbiz/0?wx_fmt=jpeg",
        "base_info": {
            "logo_url": "http:\/\/www.supadmin.cn\/uploads\/allimg\/120216\/1_120216214725_1.jpg",
            "color": "Color010",
            "notice": "使用时向服务员出示此券",
            "service_phone": "020-88888888",
            "description": "不可与其他优惠同享\n如需团购券发票,请在消费时向商户提出\n店内均可使用,仅限堂食\n餐前不可打包,餐后未吃完,可打包\n本团购券不限人数,建议2人使用,超过建议人数须另收酱料费5元/位\n本单谢绝自带酒水饮料",
            "location_id_list": [
                123,
                12321,
                345345
            ]
        },
        "bonus_cleared": "aaaaaaaaaaaaaa",
        "bonus_rules": "aaaaaaaaaaaaaa",
        "prerogative": "",
        "auto_activate": true,
        //也可以填写wx_activate"activate_url":""
    }
}

지원 수정 필드:

base_info 필드:

매개변수 이름         설명                                                     to
잔액
Sex
회원정보
회원카드 회원정보 등급 등 개발자가 설정한 회원정보 항목입니다. Name 信息 회원 정보 카테고리 이름
Value 레벨 값 등 회원 카드 정보 카테고리 값
User_card_status 현재 사용자 멤버십 카드 상태, 정상 정상 만료 GIFT_SUCC 성공적으로 전송됨 GIFT_TIMEOUT 전송 timeout DELETE 삭제됨, UNAVAILABLE이 만료되었습니다.
필수입니다                       이
Description       > ~ .cn/                                                                                                                                                            카드 취소 시 QR코드 알림 사용, 최대 문자 수는 한자 16자입니다. 고객센터 전화번호입니다. color                                   Color010            #🎜🎜 #쿠폰 색상. 1234 ,2314              # 🎜🎜#점프 입구의 이름을 맞춤설정하세요. ~     입구는 외부 링크의 주소 링크로 이동합니다. ~_TEXT. 1          아니요           bool                                ~ 🎜##🎜 확장 없음 #🎜 🎜#type                                               #1          
매개변수 이름                                                                                     권장 픽셀 카드와 쿠폰의 가맹점 로고는 300*300 입니다. 주의사항 🎜#
를 제시해주세요.                   

description                                   

다른 할인 공유 불가
과 함께사용 지침.
service_phone                                      40012234          #🎜🎜 #
location_id_list                                            #해당 매장 목록 업데이트를 지원합니다. 아니요 🎜 🎜#모든 매장을 지원합니다. 작성 후 카드 및 쿠폰 매장은 가맹점 업데이트에 따라 업데이트됩니다center_title                                                 🎜 🎜#string(18) ​🎜🎜#, 사용 권장
center_sub_title                                                                                       ~ ~                                                                              ‐ 으로 --
리디렉션된 URL을 맞춤설정하세요.                                                                                    입구 오른쪽에 안내 메시지가 표시됩니다. ~        ​ ​ ​ ​ 마케팅 시나리오를 위한 맞춤형 입구 이름입니다.                                                                                      No string (18) 매장에서 대폭 할인됩니다. ​ ​ ​ 마케팅 입구 오른쪽에 표시되는 프롬프트입니다. ~                                
코드 코드 표시 유형, "CODE_TYPE_TEXT" 텍스트 "CODE_TYPE_BARCODE" 1차원 코드 "CODE_TYPE_QRCODE QR 코드

"CODE_TYPE_ ONLY_QRCODE"

QR 코드만 표시              
"CODE_TYPE_ONLY_BARCODE"

표시 전용 하나의 QR 코드

"CODE_TYPE_NONE"

코드 유형을 표시하지 않습니다

get_limit                                          🎜🎜##🎜 🎜#1인당 받을 수 있는 쿠폰 개수 제한                                                        ~ 🎜## 🎜🎜#true 🎜🎜# date_info             #🎜🎜 #
유효성 유형은 유형의 타임스탬프 변경만 지원합니다. 1, 2 입력은 지원하지 않습니다. ~                         ​(단위는 초)                                 🎜#unsigned int               15300000 특정 날짜 범위, 종료 시간을 나타냅니다. 종료 시간은 나중에만 연장할 수 있습니다.           

회원카드 전용 필드 수정:

특별히 업데이트를 지원하는 다음 필드는 기본 정보 base_info의 구조에 없습니다.

회원 카드 맞춤 카드 배경 이미지                                                                          #string(307 2)             특권 설명. wx_activate                               열릴지 여부 원클릭 카드 열기 원클릭 카드 열기auto_activate                                    🎜🎜 #자동 활성화 활성화 여부, 설정 시 true이면 사용자가 자동으로 멤버십 카드를 활성화로 설정합니다. 자세한 내용은 를 참조하세요.             맞춤 회원정보 카테고리, 회원카드가 표시됩니다.                                                                                                                            ~ ~ FIELD_NAME_TYPE_MILEAGE 마일리지 이동하려면 카테고리를 클릭하세요. 외부 링크 전송 url             > 🎜🎜#맞춤형 회원 정보 카테고리 표시 멤버십 카드가 활성화된 후                          🎜#JSON 구조 #🎜🎜 ## 🎜🎜 ## 🎜🎜#Cost_ 돈_단위#🎜🎜 ## 🎜🎜#🎜#🎜##🎜 ​​​​​🎜🎜#int                               # 🎜🎜##🎜🎜 #int                                                                                                         |                                                                🎜🎜#deduct xx 센트 s)                                                                                                                아니요​ errmsg​​​​​​
매개변수 이름                        ​ Description Background_pic_url               ​
포인트 클리어 규칙. + 규칙. | # 🎜🎜#
이 다음으로 설정되었습니다. 사실, 해당 카드는 원클릭 카드 열기를 지원합니다. 자세한 내용은 를 참조하세요. 이 옵션은 activate_url과 상호 배타적입니다.
자동 활성화
activate_urlNo string(128)
Activate link
custom_field1​ ​ ​ 멤버십 카드 활성화 후 표시되는 멤버십 정보 카테고리를 맞춤 설정하세요. ICustom_Field2 No Json 구조
FIELD_NAME_TYPE_LEVEL 레벨 FIELD_NAME_TYPE_COUPON 쿠폰 FIELD_NAME_TYPE_STAMP 우표 FIELD_NAME_TYPE_DISCOUNT 할인 FIELD_NAME_TYPE_ACHIEVEMEN 업적
url                                    # #分#위챗 구매 기능에 사용되는 통합 규칙 구조아니요             #🎜 🎜#아니요             #🎜 5포인트씩 사용하세요.
reduce_money                                      🎜🎜#int ​ ​ ​ 1건의 거래에 최대 xx포인트 사용 가능​​​​​​​할인 > | ​​​​​​​
오류 메시지. E Send_Check 이번에 이 업데이트를 검토해야 하는지 여부는 True가 필요하고 false는 필요하지 않습니다.          

개발자 노트

1. 카드 및 쿠폰의 일부 필드를 변경한 후 검토를 위해 다시 제출됩니다. 자세한 내용은 업데이트가 성공한 후 뷰 카드를 호출하여 업데이트 결과를 확인할 수 있습니다.

2. 업데이트가 필요한 필드만 입력하세요. 많은 개발자가 이 인터페이스를 호출할 때 수정을 지원하지 않는 필드를 입력하여 업데이트가 실패하게 됩니다.

3. 카드 및 쿠폰 정보를 변경하기 위해 이 인터페이스를 호출한 후, 반드시 카드 및 쿠폰 세부정보 보기 인터페이스를 호출하여 변경이 성공했는지 확인하세요.

8.3 팔로우 추천 설정

기능 소개

개발자가 쿠폰을 구성하거나 포인트 변경 메시지 하단에 점프 외부 링크 URL을 설정할 수 있도록 지원합니다. 구체적인 형식은 아래와 같으며, URL 또는 URL일 수 있습니다. 쿠폰 .

领券页面

개발자 노트

1. 두 가지 유형의 팔로우 추천 구성 지원

1. 광고 슬로건 + URL, 판매자가 한자 16자 길이의 카피라이팅 구성 지원 및 클릭 투 점프 링크 .

2. 추천 카드와 쿠폰을 사용하면 판매자가 이 공식 계정에서 카드와 쿠폰을 구성할 수 있습니다.

2. 추천 포지션 유효기간 관리

1. 광고 슬로건 + URL 형태로 가맹점이 활동 기간에 따라 노출 시간을 맞춤 설정할 수 있도록 지원합니다.

2. 카드 및 쿠폰 유형은 WeChat 백엔드에 의해 결정됩니다. 카드 및 쿠폰이 만료되거나 수집되거나 유효하지 않은 것으로 설정되면 자동으로 제거됩니다. 전시용 선반에서.

8.3.1 팔로우 추천 인터페이스 설정

인터페이스 설명

업데이트 카드 및 쿠폰 정보 인터페이스를 호출하여 추천 필드를 리뷰를 성공적으로 통과한 카드 및 쿠폰으로 업데이트합니다. 또한 카드 및 쿠폰 생성 시 해당 필드 입력을 지원합니다.


인터페이스 세부정보

인터페이스 호출 요청 설명

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

매개변수 설명

매개변수             필요한가요           설명            ㅋㅋ ​​예 아들 데이터

메시지를 사용하여 카드 쿠폰 구성

http请求方式: POSThttps://api.weixin.qq.com/card/update?access_token=TOKEN


메시지를 사용하여 URL 구성

{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "card_cell": {
                "end_time": 1452724561,
                "card_id": "p1Pj9jr90_SQRaVqYI239Ka1erkI"
            }
        }
    }
}

필드 설명

#🎜🎜 ## 🎜🎜#필드 이름                                                                                                 🎜🎜#쿠폰ID. modify_msg_eration > Json 구조 참조 예. ~ ~ Json 구조 참조 예. card_id 🎜#
{
    "card_id": "ph_gmt7cUVrlRk8swPwx7aDyF-pg",
    "member_card": {
        "modify_msg_operation": {
            "url_cell": {
                "end_time": 1452724561,
                "text": "更多优惠",
                "url": "www.qq.com"
            }
        }
    }
}
필드 설명# 🎜🎜# 오류 코드, 0은 정상을 의미합니다. 43008은 판매자에게 WeChat 결제 권한이 없음을 의미합니다. 🎜🎜## 🎜🎜#

8.4 회원 결제 설정

8.4.1 회원 결제 추가 규칙 인터페이스

위챗 결제를 개설한 가맹점에서는 사용자가 자동으로 카드 수집 메시지를 사용자에게 보내도록 설정할 수 있습니다. WeChat에서 결제한 후 사용자는 회원 카드 받기 메시지를 클릭할 수 있습니다.

201610130915202689.jpg

인터페이스 설명

판매자가 멤버십 결제 규칙을 설정할 수 있도록 지원하고 기간 및 금액 범위에 따라 멤버십 카드를 발급할 수 있습니다.

인터페이스 호출 요청 설명

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

매개변수 설명

END_TIME#🎜🎜 ## 🎜🎜#추천 비트 표시 마감입니다. ~            ~                    .
반환 데이터
필드 이름                                                                    🎜#
is ​ ​ 통화 인터페이스 자격 증명 ​​​​카드 쿠폰 ID는 비맞춤형 코드 모드에서는 카드_ID, 사전 저장된 코드 모드에서는 카드_ID만 지원합니다. Rjump_url 템플릿 메시지 URL은 판매자의 맞춤형 카드 웹 링크일 수 있습니다. mchid_list 바우처 규칙에 대한 판매자 번호 지원 목록 Begin_time 규칙 유효 시간 EEnd_time _ 규칙 종료 시간
매개변수                       필수입니다                       이

min_cost

이 규칙은 결제 금액의 하한이며, 단위로 구분됩니다. is_locked

데이터 설명을 반환합니다. 데이터 예:

HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/add?access_token=TOKEN

max_cost 이 규칙은 유효합니다.
다른 앱에서 판매자 설정을 허용할지 여부 이 규칙에 설정된 계정의 기본값은 true입니다
매개변수 이름 설명 Errcode 오류 코드, 0은 정상입니다. ​​​​​​​errmsg​​​​​​오류 메시지. ISUCC_LIST 성공한 MCHID 목록 설정 Fail_List 실패한 MCHID 목록 설정 MCHID 판매자 번호 Occupy_appid 장애가 해결되면 다시 설정을 하게 되는데, mchid는 현재 appid가 점유하고 있습니다. 판매자는 이 appid를 사용하여 바인딩을 해제한 다음 재설정해야 합니다.          

개발자 주의사항

1. 멤버십 카드 수집 메시지는 신규 사용자 한 명에게 한 번만 전송됩니다. 이미 멤버십 카드를 받았거나 받은 경우에는 반복해서 전송되지 않습니다. 이 규칙은 설정된 카드 ID의 쿠폰 appid가 현재 mch_id의 기본 appid와 일치해야 합니다. 그렇지 않으면 72001 오류가 보고됩니다.

3. 멤버십 카드 유형의 카드와 쿠폰만 지원됩니다. 그렇지 않으면 오류가 발생합니다. 보고됨: 72003;

4. 회원으로 결제 설정 호출 시 호출 인터페이스의 appid가 현재 카드 ID 본문과 일치하는지, appid가 mchid와 바인딩 관계가 있는지 확인해야 합니다. 오류가 보고됩니다:

5. 이전에 다른 appid에 의해 mchid가 설정되지 않았는지 확인해야 합니다. 그렇지 않으면 오류 72004가 보고됩니다.

6. 한 번에 100개의 mchid만 설정할 수 있습니다. 100개 이상이면 이 인터페이스를 여러 번 호출하세요.

8.4.2 멤버십 규칙에 따른 결제 삭제 인터페이스

이전에 설정한 멤버십 규칙에 따른 결제를 삭제합니다. 인터페이스 설명

가맹점이 회원 결제 규칙을 설정할 수 있도록 지원하고 기간 및 금액 범위에 따라 회원 카드를 발급할 수 있습니다.

인터페이스 호출 요청 설명

{
    "card_id": "xxxxxxxxa",
    "jump_url": "mp.weixin.qq.com/wiki",
    "mchid_list": [
        "123",
        "1234",
        "12345"
    ],
    "begin_time": 146324567,
    "end_time": 147234567,
    "min_cost": 1000,
    "max_cost": 10000000,
    "is_locked": true
}

매개변수 설명

매개변수                     
필수입니다                         이
전화 인터페이스 자격 증명 ​​​​쿠폰 ID. ~

데이터 설명을 반환합니다. 데이터 예:

{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list":[
    "134xxxxxx"
    ],
    "fail_list":[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}

매개변수 이름 설명 Errcode 오류 코드, 0은 정상입니다. ​​​​​​​errmsg​​​​​​오류 메시지. ISUCC_LIST 성공한 MCHID 목록 설정 Fail_List 실패한 MCHID 목록 설정 MCHID 판매자 번호 Occupy_appid 장애가 해결되면 다시 설정을 하게 되는데, mchid는 현재 appid가 점유하고 있습니다. 판매자는 이 appid를 사용하여 바인딩을 해제한 다음 재설정해야 합니다. 3. 8.4.3 가맹점 결제 조회는 회원 규칙 인터페이스 인터페이스 설명 가맹점 번호가 결제를 지원하는지, 즉 멤버십 기능인지 조회할 수 있습니다 매개변수 설명

인터페이스 호출 요청
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/delete?access_token=TOKEN
매개변수

明Post 데이터

json 데이터

Access_token

필드 이름인지 여부                             ~                                                         필드 이름          

반환 데이터 설명

데이터 예:

{
    "card_id": "xxxxxxxxa",
    "mchid_list": [
        123,
        1234,
        12345
    ]
}

8.5 WeChat 멤버십 카드 설정 결제 카드 스와이프 인터페이스

는 인터페이스를 통해 스와이프 유형을 지원하는 멤버십 카드를 생성합니다. 사용자가 빠르게 결제를 클릭한 후 카드 스와이프 인터페이스를 꺼내 결제할 수 있습니다. 다음은 다이어그램입니다.

201610130915204982.png


8.5.1 만들기 멤버십 카드 WeChat 결제 스와이프 지원

판매자는 WeChat 결제 스와이프를 지원하기 위해 멤버십 카드를 생성할 수 있습니다. 멤버십 카드 생성 인터페이스의 JSON에 다음 필드를 추가해야 합니다.

{
    "errcode": 0,
    "errmsg": "ok",
    "succ_list":[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ],
    "fail_list":[
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        },
        {
            "mchid": "xxxxx",
            "errcode": 0,
            "errmsg": "ok",
            "occupy_appid": "wxxxxxxxxxxx"
        }
    ]
}
#🎜 🎜#

8.5.2 WeChat 결제 스와이프를 지원하도록 멤버십 카드 업데이트

판매자는 WeChat 결제 스와이프를 지원하기 위해 기존 멤버십 카드를 업데이트할 수 있습니다. 다음 필드를 JSON에 추가해야 합니다. 멤버십 카드 업데이트 인터페이스: #🎜🎜 #
HTTP请求方式: POST
URL:https://api.weixin.qq.com/card/paygiftmembercard/get?access_token=TOKEN