쿠폰 배치


업데이트 로그

#🎜🎜 #2015-8-31ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


1 QR 코드 인터페이스 만들기

개발자 이 인터페이스를 호출하여 사용자가 카드와 쿠폰을 스캔하고 카드 패키지에 추가할 수 있는 카드와 쿠폰 QR 코드를 생성할 수 있습니다.


사용자 지정 코드 코드가 있는 카드 및 쿠폰에 대한 인터페이스를 호출할 때 POST 데이터에 코드를 지정해야 합니다. 사용자 지정 코드가 아닌 경우 openid를 지정하는 경우에도 동일하게 적용됩니다. 지정된 QR코드는 이용자가 1회만 스캔하여 수집할 수 있습니다.

QR 코드 티켓을 얻은 후 개발자는 티켓을 QR 코드 인터페이스로 교환할 수 있습니다.

인터페이스 호출 요청 설명

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

매개변수 설명

버전 번호업데이트 콘텐츠업데이트 시간
V1.1

1. 새 카드 및 쿠폰 선반을 만듭니다. 인터페이스는 개발자가 카드 및 쿠폰 배치를 위한 카드 및 쿠폰 선반을 생성하는 인터페이스를 호출할 수 있도록 지원합니다. 코드를 가져와서 다른 채널

2015-8-12
V1.2#🎜 🎜#QR 코드를 스캔하여 일괄 수집을 위한 새로운 인터페이스, 사용자는 QR 코드를 스캔하여 여러 개의 카드와 쿠폰을 동시에 받을 수 있습니다

매개변수 가 필수인가요? 설명
POST 데이터 입니다. JSON 데이터
access_tokenis 통화 인터페이스 자격 증명



# 🎜 🎜#


#🎜 🎜#


# 🎜 🎜#POST 데이터


개발자는 QR 코드를 스캔하여 단일 카드 쿠폰을 받도록 설정할 수 있습니다. 데이터는 다음과 같습니다: #🎜 🎜#

 {
"action_name": "QR_CARD", 
"expire_seconds": 1800,
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"is_unique_code": false ,
"outer_str":"12b"
  }
 }
}

개발자가 여러 쿠폰을 받기 위해 QR 코드를 스캔하도록 설정한 경우 POST 데이터는 다음과 같습니다.

{
"action_name": "QR_MULTIPLE_CARD", 
"action_info": {
"multiple_card": {
"card_list": [
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo88",
"code":"2392583481",
"outer_str":"12b"
}, 
{
"card_id": "p1Pj9jgj3BcomSgtuW8B1wl-wo98",
"code":"2392583482",
"outer_str":"12b"
}
]
}
}
}
# 🎜🎜##🎜 🎜#

매개변수 설명

입니다. string(32)#🎜 🎜## 🎜🎜## 🎜🎜# 카드ID. 아니요
매개변수 이름필수Type값 예설명
코드 string(20) 110201201245카드 및 쿠폰 코드, use_custom_code 필드가 true인 쿠폰은 반드시 입력해야 하며, 비맞춤 코드 및 가져온 코드 모드가 있는 쿠폰은 입력할 필요가 없습니다. 아니요 🎜#
pFS7Fjg8kV1IdDz01r4SQwMkuCKcstring(32)oXch-jkrxp42VQu8ldweCwDt97qo받는 사람의 openid를 지정하면 해당 사용자만 받을 수 있습니다. Bind_openid 필드가 true인 카드, 쿠폰은 반드시 입력해야 하며, 지정되지 않은 openid는 입력할 필요가 없습니다.
expire_secondsNounsigned int60범위는 60~18입니다. 00초. 입력하지 않으면 기본적으로 365일간 유효합니다
is_unique_codenoboolfalse 코드 및 생성된 QR코드는 랜덤으로 부여되며, 수령 후 다시 스캔할 수 없습니다. 참 또는 거짓을 입력하세요. 기본값은 false입니다. 이 필드를 작성할 때 카드는 검토를 통과해야 하며 인벤토리는 0이 아닙니다. 채널 데이터 통계를 수집하는 데 사용되는 재구성 시나리오 값, 기본값은 0, 필드 유형은 정수, 길이 제한 60자리까지.이 사용자 정의 장면 값은 사용자가 쿠폰을 받은 후 실행되는 이벤트 푸시에 포함됩니다.

outer_str

nostring(128)13b

outer_id 필드 업그레이드 버전 , 문자열 형식입니다. 사용자가 처음으로 카드를 받았을 때. , 그는 그것을 통해 받게 됩니다. 이벤트는 판매자에게 푸시됩니다.

멤버십 카드의 QR 코드의 경우 사용자가 코드를 스캔하여 멤버십 카드를 열고 URL을 클릭할 때마다 값이 입력됩니다. 개발자가 스캔한 코드의 소스를 쉽게 찾을 수 있는 URL

ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ






ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ






ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ










데이터 반환

{
 "errcode": 0,
 "errmsg": "ok",
 "ticket":      "gQHB8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0JIV3lhX3psZmlvSDZmWGVMMTZvAAIEsNnKVQMEIAMAAA==",//获取ticket后需调用换取二维码接口获取二维码图片,详情见字段说明。
 "expire_seconds": 1800,
 "url": "http://weixin.qq.com/q/BHWya_zlfioH6fXeL16o ",
 "show_qrcode_url": " https://mp.weixin.qq.com/cgi-bin/showqrcode?  ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0czVzRlSWpsamlyM2plWTNKVktvAAIE6SfgVQMEgDPhAQ%3D%3D"
 }

매개변수 설명

매개변수 이름설명
errcode오류 코드
errmsg 오류 메시지
ticketGet QR 코드 티켓, 이 티켓 통화로 티켓 교환 QR 코드 인터페이스를 통해 유효 시간 내에 QR 코드를 교환할 수 있습니다.
urlQR 코드 이미지를 파싱한 후의 주소입니다. 개발자는 주소
show_qrcode_urlQR 코드 표시 주소를 기반으로 필요한 QR 코드 이미지를 생성할 수 있습니다. QR 코드 페이지로 이동하려면
ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


Notes
:


1. 사용자 정의 코드 쿠폰, 생성된 QR 코드는 한 번에 한 번만 수집할 수 있습니다. 개발자가 자신의 일련 코드 시스템을 사용하고 WeChat의 QR 코드



를 사용하려면 먼저


사용자 정의 코드

;

를 가져와야 합니다.

2. 여러 개의 QR 코드를 받으려면 한 번에 최대 5개의 카드 ID를 입력하세요. 그렇지 않으면 오류가 보고됩니다.


2 HTML5 온라인 쿠폰 발행(JS-SDK 인터페이스)

WeChat JS-SDK는 WeChat 내장 브라우저에서만 사용을 지원하며, 다른 브라우저에서의 호출은 유효하지 않습니다.

WeChat은 판매자의 프런트엔드 웹페이지 호출을 위한 addCard 인터페이스를 제공합니다. 이는 사용자의 카드 패키지에 하나 이상의 카드와 쿠폰을 추가하는 데 사용됩니다. 자세한 내용은 카드 및 바우처 인터페이스 일괄 추가를 참조하세요.

1476408558333646.jpg


3 쿠폰 선반을 통해 쿠폰 넣기

쿠폰 선반 소개

쿠폰 선반은 개발자가 카드를 생성할 수 있도록 지원합니다. 인터페이스 바우처 호출 컬렉션 H5 페이지를 방문하고 카드 및 쿠폰 작업을 수행하기 위한 페이지 링크를 얻습니다. 현재 카드 및 쿠폰 선반은 맞춤 코드가 없는 카드와 쿠폰만 지원합니다. 맞춤 코드가 있는 카드와 쿠폰은 먼저 코드 가져오기 인터페이스를 호출하여 코드를 가져와야 정상적으로 사용할 수 있습니다.

1476408583576222.png

3.1 선반 인터페이스 생성

인터페이스 설명

개발자는 카드 및 쿠폰 배치를 위한 선반 링크를 생성하려면 이 인터페이스를 호출해야 합니다. 선반 생성 시 배송 경로의 장면 필드를 채워야 합니다.


인터페이스 호출 요청 설명

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


요청 매개변수 설명

buffer
매개변수 가 필수인가요?
파일 데이터 흐름



# 🎜 🎜#


#🎜 🎜#


# 🎜 🎜#POST 데이터

{  
"banner":"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7h  icFN",
   "page_title": "惠城优惠大派送",
   "can_share": true,
   "scene": "SCENE_NEAR_BY",
   "card_list": [
       {
           "card_id": "pXch-jnOlGtbuWwIO2NDftZeynRE",
           "thumb_url": "www.qq.com/a.jpg"
       },
       {
           "card_id": "pXch-jnAN-ZBoRbiwgqBZ1RV60fI",
           "thumb_url": "www.qq.com/b.jpg"
       }
   ]
}


매개변수 초 설명

# 🎜🎜 #scene배달 페이지의 Scene 값 입니다.
FieldDescription필수인가요?
banner페이지의 배너 이미지 링크는 64사이즈를 권장합니다. 0*300.
title 페이지 제목입니다.
can_share#🎜🎜 # 페이지 공유 가능 여부, true/false 입력
SCENE_NEAR_BY 근처 SCENE_ME 뉴 맞춤 메뉴 SCENE_QRCODE QR 코드 SCENE_ARTICLE 공개 계정 글 SCENE_H5 h5 페이지 SCENE_IVR 자동 답장 SCENE_CARD_CUSTOM_CELL 카드 맞춤 셀

card_list카드 쿠폰 목록이며, 각 항목에는 두 개의 필드가 있습니다.
card_id페이지에 배치될 카드 ID is
thumb_urlthumbnail urlis
ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ






ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


반환 데이터 설명

{
     "errcode":0,
     "errmsg":"ok",
     "url":"www.test.url",
     "page_id":1
 }

필드 설명

Field 설명
errcode오류 코드, 0은 정상입니다.
errmsg오류 메시지.
url 서가 링크.
page_id서가 ID. 선반의 고유 식별자입니다.








4 그룹 이슈 카드

개발자 여러분께서는 현재 단체발급 카드 및 쿠폰 인터페이스에 각별히 주의해 주시기 바랍니다. 맞춤 코드 코드가 있는 비카드 발급만 지원합니다. 사용자 정의 코드가 있는 판매자가 이 기능을 사용하려면 먼저 가져오기 코드 인터페이스를 호출하여 사용자 정의 코드를 WeChat 서버로 가져와야 합니다.

4.1 사용자 정의 코드 가져오기(사용자 정의 코드 판매자에게만 해당)

인터페이스 소개

이 모듈은 사용자 정의 코드 판매자만을 위한 것이므로 사용자 정의 코드가 아닌 개발자는 자동으로 무시해야 합니다. 개발자는 맞춤형 코드를 위챗 서버로 미리 가져와서 단체 배포, 고객 서비스 메시지를 통한 카드 및 쿠폰 발급 등 비맞춤형 코드 가맹점과 동일한 배송 기능을 얻을 수 있습니다.

코드를 가져온 후의 쿠폰은 출시된 비맞춤 코드 쿠폰과 동일합니다.

새로 생성된 쿠폰

개발자가 가져온 코드를 지원하는 새 쿠폰을 만들 계획인 경우 모드 쿠폰은 기존 생성 방식과 다릅니다. 개발자는 미리 저장된 코드 모드 쿠폰을 생성하려면 다음 프로세스를 사용하는 것이 좋습니다. 그렇지 않으면 오류가 보고됩니다.

1단계: 사전 저장된 모드 쿠폰을 생성하고, 재고 수량의 초기 값을 0으로 설정하고, get_custom_code_mode 필드를 입력합니다.

2단계: 쿠폰이 검토를 통과한 후 호출합니다. 가져오기 코드 인터페이스 및 코드 확인

3단계: 수정 인벤토리 인터페이스를 호출하여 카드 인벤토리를 가져온 코드 수 이하로 만듭니다. (혼란을 피하기 위해 동일하게 설정하는 것이 좋습니다)


1476408598664187.png

새로 생성되지 않은 카드# 🎜🎜#

개발자가 이미 카드와 쿠폰을 보유하고 있으며 이를 사전 저장된 코드 모드로 변경하려는 경우 개발자는 다음 프로세스를 따르는 것이 좋습니다. 카드와 쿠폰을 업데이트하려면

1단계: 가져오기 코드 인터페이스를 호출하여 일정량의 맞춤 코드를 가져와 코드를 확인합니다.

2단계: 카드 정보 변경 인터페이스 호출 get_custom_code_mode 필드를 입력합니다.

3단계: 인벤토리 수정 인터페이스를 호출하여 카드 인벤토리 수량을 가져온 코드 수와 동일한 숫자로 설정합니다.

1476408610235204.png


4. 1. 1 가져오기 코드 필수 필드를 입력/업데이트합니다

인터페이스 설명#🎜🎜 #

맞춤 코드가 포함된 카드 및 쿠폰은 API 생성만 지원합니다. 생성 시 반드시 base_info에 다음 필드를 추가해야 합니다(자세한 내용은 인터페이스 문서 CreateCard 참조). 다음 두 개의 지정된 필드를 추가한 후에만 코드 가져오기 인터페이스를 호출할 수 있습니다. 코드 가져오기

FieldDescription
base_info
get_custom_code_modeGET_CUSTOM_CODE_MODE_DEPOSIT이 필드를 작성한 후 이후 코드 쿠폰을 정의한 후에만 코드를 가져와서 배치할 수 있습니다.
use_custom_codetrue쿠폰을 맞춤 코드로 설정하세요





# 🎜 🎜#



카드 생성 시 JSON 예시

{
 "card": {
     "card_type": "GROUPON",
     "groupon": {
     "base_info": {
     ··········
     "use_custom_code":true,
     "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
         },
          "advanced_info": {
      ··········
          },
         "deal_detail": "示例"
     }
   }
}

카드 업데이트 시 JSON 예시#🎜🎜 #
 {
      "card_id":"ph_gmt7cUVrlRk8swPwx7aDyF-pg",
      "groupon": { 
      "base_info": {
      ·········		            
        "get_custom_code_mode":"GET_CUSTOM_CODE_MODE_DEPOSIT",
      ·········
              }
        }
 }

참고:

을 생성/업데이트할 때 다음을 확인해야 합니다. 재고 번호와 가져온 코드 수 사이의 관계. 가져온 코드 수가 재고 번호보다 적으면 오류가 보고됩니다.

4.1.2 가져오기 코드 인터페이스

맞춤 코드 쿠폰

이 성공적으로 생성되고 검토를 통과한 후, 합의된 지침에 따라 가져오기 코드 인터페이스를 호출하여 맞춤 코드를 WeChat 백엔드로 가져와야 합니다. 쿠폰 발급자 번호입니다.

인터페이스 설명

개발자는 이 인터페이스를 호출하여 사용자 정의 코드를 WeChat 카드 및 쿠폰 백엔드로 가져올 수 있으며, WeChat 에이전트는 코드를 저장하고 발급합니다.

참고: 1) 인터페이스에 대한 단일 호출에 대한 최대 수신 코드 수는 100입니다.

2) 각 코드는 빈 문자열일 수 없습니다.

3) 가져오기가 완료된 후 공급자가 설정한 재고가 실제 금액과 일치하는지 시스템에서 자동으로 확인합니다. 가져온 코드.

4) 가져오기에 실패하면 프롬프트가 성공할 때까지 반복 가져오기가 지원됩니다.

인터페이스 호출 요청 설명

HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/deposit?access_token=ACCESS_TOKEN

# 🎜🎜#요청 매개변수 설명

buffer
매개변수 가 필수인가요?
파일 데이터 흐름



# 🎜 🎜#


#🎜 🎜#


# 🎜 🎜#POST 데이터

{
   "card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",
   "code": [
       "11111",
       "22222",
       "33333",
       "44444",
       "55555"
   ]
}

필드 설명

FieldDescription필수인가요?
card_id가져와야 하는 카드 ID입니다.
code이며, WeChat 카드 및 쿠폰 백엔드로 가져와야 합니다. 상한은 100입니다.
입니다



# 🎜 🎜#


#🎜 🎜# #### ## ## ## ## ## ## ## ## ## ## ####반품 데이터 설명#🎜🎜 ## ##### #

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

필드 설명

FieldDescription
errcode오류 코드, 0은 정상입니다. 40109: 코드 수가 100을 초과합니다
errmsg 오류 메시지 .
succ_code성공 횟수
duplicate_code중복된 가져온 코드는 자동으로 필터링됩니다.
fail_code실패 횟수.





# 🎜 🎜#





#🎜 🎜#

4.1.3 가져온 코드 수 쿼리 인터페이스

인터페이스 설명

개발자가 이 인터페이스를 호출하여 WeChat 백엔드로 가져온 성공적인 코드 수를 쿼리할 수 있도록 지원합니다.

인터페이스 호출 요청 설명

HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/getdepositcount?access_token=ACCESS_TOKEN

Request 매개변수 설명

매개변수 인증서가 필요합니까?



# 🎜 🎜 ## ## ## ## ## ## ## ## ## ## ####게시물### #####rreee#🎜🎜 ## 🎜🎜#
필드 설명


#🎜 🎜# 입니다



# 🎜 🎜 ## ## ## ## ## ## ## ## ## ######반품 데이터 설명#🎜🎜 ## ####rreee

필드 설명

Field설명 필수인가요?
card_id import 코드의 쿠폰 ID입니다.
Field 설명
errcode오류 코드, 0은 정상입니다.
errmsg오류 메시지.
count성공적으로 입금된 코드 수입니다.







4.1.4 인증 코드 인터페이스

가져오기 오류를 방지하려면 개발자가 번호를 확인하는 것이 좋습니다. 코드 인터페이스를 확인할 때 확인 코드를 WeChat 백엔드로 가져온 후의 코드입니다.

인터페이스 설명

개발자가 이 인터페이스를 호출하여 WeChat 백엔드로 코드 가져오기 상태를 쿼리할 수 있도록 지원합니다.

인터페이스 호출 요청 설명

{
   "card_id" : " pDF3iY0_dVjb_Pua96MMewA96qvA "
}

请求参数说明

매개변수 인증서가 필요합니까?



# 🎜 🎜 ## ## ## ## ## ## ## ## ## ## ####게시물### #####rreee#🎜🎜 ## 🎜🎜#
필드 설명


FieldDescription필수인가요?
card_id코드를 가져오기 위한 카드 ID입니다.
code이며 WeChat 카드 및 쿠폰 백엔드에서 사용자 정의된 코드이며 상한은 100입니다.
입니다



# 🎜 🎜#


#🎜 🎜#


# 🎜 🎜#반환 데이터 설명

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

필드 설명

#🎜 🎜# errmsg 오류 메시지. exist_code성공적으로 입금된 코드입니다. 입금된 코드가 없습니다.





# 🎜 🎜#




#🎜 🎜# 4.2 그래픽 메시지를 통한 카드 및 쿠폰의 그룹 발행

개발자가 이 인터페이스를 호출하여 쿠폰을 삽입하기 위한 표준 형식 코드를 얻을 수 있도록 지원합니다. 그래픽 메시지,

그래픽 자료 인터페이스 업로드 의 콘텐츠 필드에 반환 코드를 입력하여 카드에 포함된 그래픽 및 텍스트 메시지 자료를 가져옵니다.

특별 참고 사항: 현재 이 인터페이스는 맞춤 코드가 아닌 카드와 쿠폰만 지원합니다. 맞춤 코드가 있는 카드와 쿠폰은 먼저 가져온 다음 호출해야 합니다.

인터페이스 호출 요청 설명

HTTP请求方式: POST
URL:http://api.weixin.qq.com/card/code/checkcode?access_token=ACCESS_TOKEN

Parameters 설명

Field설명
errcode오류 코드, 0은 정상입니다. 40109: 코드 수가 100을 초과합니다.#🎜 🎜 #
매개변수 가 필수인가요? 설명
POST 데이터 입니다. JSON 데이터
access_tokenis 통화 인터페이스 자격 증명





POST 데이터

{
   "card_id": "pDF3iY0_dVjb_Pua96MMewA96qvA",
   "code": [
       "11111",
       "22222",
       "33333",
       "44444",
       "55555"
   ]
}
매개변수 이름필수TypeExampleDescription
카드_idnostring(32) pFS7Fjg8kV1IdDz01r4SQwMkuCKc쿠폰ID.
ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ

반품 데이터

{
  "errcode":0,
  "errmsg":"ok"
  "exist_code":["11111","22222","33333"],
  "not_exist_code":["44444","55555"]
}
매개변수 이름Description
errcode오류 코드
errmsg 오류 메시지
content 그래픽 메시지 본문에 직접 삽입할 수 있는 HTML 코드 조각을 반환합니다. 즉, 이미지 및 문자 메시지 자료 업로드 인터페이스의 콘텐츠 필드에 이 코드를 삽입할 수 있습니다.





# 🎜 🎜#



4.3 그룹별로 그룹 쿠폰 메시지 보내기 # 🎜🎜#

은 이 인터페이스를 호출하여 지정된 그룹의 사용자에게 쿠폰 메시지를 보내는 것을 지원합니다. 자세한 내용은

그룹 전송 인터페이스

현재 이 인터페이스는 맞춤 코드가 아닌 코드가 입력된 카드 및 쿠폰만 지원하며, 맞춤 코드 카드와 쿠폰을 먼저 가져온 다음 호출해야 합니다.

4.4 OpenID 목록 기반 카드 및 쿠폰 메시지 그룹 전송

OpenID 기반 기본 카드 및 쿠폰 그룹 전송을 지원합니다. 구독 계정을 사용할 수 없습니다. 서비스 계정은 인증 후 인터페이스 권한을 갖습니다. 자세한 내용은 OpenID 목록 기반 대량 전송 인터페이스

를 참조하세요. 현재 이 인터페이스는 맞춤 코드가 아닌 카드와 쿠폰만 지원합니다. 맞춤 코드가 있는 카드와 쿠폰은 먼저 가져온 후 호출해야 합니다.

4.5 고객 서비스 메시지를 통한 카드 및 쿠폰 발행

개발자가 이 인터페이스를 호출하여 카드 및 쿠폰을 발행할 수 있도록 지원합니다. 구독 계정은 사용할 수 없으며 서비스 계정이 인증된 후에 사용할 수 있습니다. 자세한 내용은 고객 서비스 인터페이스-메시지 보내기

를 참조하세요.

현재 이 인터페이스는 맞춤 코드가 아닌 카드와 쿠폰 입력만 지원합니다. 맞춤 코드가 있는 카드와 쿠폰은 먼저 가져온 다음 호출해야 합니다.

4.6 미리보기 인터페이스

는 개발자가 이 인터페이스를 호출하여 카드와 쿠폰을 발행할 수 있도록 지원합니다. 구독 계정은 사용할 수 없으며 서비스 계정이 인증된 후에 사용할 수 있습니다. 자세한 내용은 미리보기 인터페이스

5 배송 채널 데이터 통계

를 참조하세요. 개발자가 각 채널의 카드 및 쿠폰 배송 데이터를 쉽게 계산할 수 있도록 새 필드인 inner_str(이전의 external_id)은 다음과 같습니다. 추가되었습니다. 사용자가 카드를 받으면 해당 external_id가 receipt 이벤트로 가져와 개발자 서버로 푸시됩니다.

예: QR 코드 전달 방법에서 external_str을 12b로 설정

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

이벤트 XML 파일 수신

{
  "card_id":"p1Pj9jr90_SQRaVqYI239Ka1erkI"
}

6 테스트 화이트리스트 설정

인터페이스 설명

카드와 쿠폰에는 감사 요구 사항이 있으므로 공식 계정 디버깅을 용이하게 하기 위해 일부 테스트 계정을 설정할 수 있습니다. 이러한 계정은 검토를 통과하지 못한 카드와 쿠폰을 받을 수 있으며 전체 프로세스를 경험할 수 있습니다.

개발자 참고 사항

1 "openid" 및 "username" 필드 모두에 대한 허용 목록 설정을 지원하며 총 상한은 10입니다.

2. 테스트 화이트리스트 인터페이스를 전체 설정으로 설정합니다. 즉, 테스트 목록이 변경되면 모든 테스터의 ID를 다시 입력하기 위해 이 인터페이스를 호출해야 합니다.

3. 사용자가 카드를 받았으니 카드의 유효하지 않은 상태를 무시하십시오. 개발자는 주의하시기 바랍니다.

인터페이스 호출 요청 설명

 {
"errcode":0,
"errmsg":"ok",
"content":"<iframeclass=\"res_iframecard_iframejs_editor_card\"data-src=\"http: \/\/mp.weixin.qq.com\/bizmall\/appmsgcard?action=show&biz=MjM5OTAwODk4MA%3D%3D&cardid=p1Pj9jnXTLf2nF7lccYScFUYqJ0&wechat_card_js=1#wechat_redirect\">"
}

매개변수 설명

#🎜 🎜 ####설명### ## ## ## ## ## ## ####accep_token#🎜🎜 ## ## ## 🎜🎜##is# 🎜 🎜 ## ## ## ########### ## ## ## #####게시물#🎜🎜 ## 🎜 🎜 #Json 데이터
Parameters필요합니까





POST 데이터

{
"action_name": "QR_CARD", 
"action_info": {
"card": {
"card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc", 
"code": "198374613512",
"openid": "oFS7Fjl0WsZ9AMZqrI80nbIq8xrA",
"expire_seconds": "1800",
"is_unique_code": false ,
"outer_str" : "12b"
  }
 }
}

매개변수 설명

#🎜 🎜 #
매개변수 이름필수유형값 예설명 아니요 문자열(20)
o1Pj9jmZvwSyyyyyyBa4aULW2mA 테스트된 openid 목록입니다.
usernamenostring (32)eddy 테스트된 WeChat ID 목록입니다.






지침으로 돌아가기

<xml> <ToUserName><![CDATA[toUser]]></ToUserName> 
<FromUserName><![CDATA[FromUser]]></FromUserName> 
<FriendUserName><![CDATA[FriendUser]]></FriendUserName> 
<CreateTime>123456789</CreateTime> 
<MsgType><![CDATA[event]]></MsgType> 
<Event><![CDATA[user_get_card]]></Event> 
<CardId><![CDATA[cardid]]></CardId> 
<IsGiveByFriend>1</IsGiveByFriend>
<UserCardCode><![CDATA[12312312]]></UserCardCode>
<OuterStr>12b</OuterStr>
</xml>
매개변수 이름Description
errcode오류 코드, 0은 정상입니다.
errmsg오류 메시지.