WeChat 카드 및 쿠폰 인터페이스
1 Instructions
카드 및 쿠폰에 대한 일부 인터페이스 문서를 읽으려면 WeChat 공개 플랫폼 개발자 일반 지침 문서 "WeChat 개발자 사양" 및 "WeChat 공식 계정 인터페이스"를 읽어보세요. 권한 안내 》WeChat 공개 플랫폼 인터페이스의 기본 호출 방법, 개발자 사양, 호출 과정 중 비정상적인 문제 처리에 대해 알아보는 두 장입니다.
2 샌드박스 테스트 계정 신청
사용 가능한 카드 및 쿠폰 테스트 계정이 없는 경우, 쿠폰 임시 테스트 번호를 통해 신청하실 수 있습니다. WeChat 인터페이스 테스트 계정 신청 도구 테스트. 인터페이스 테스트 계정 애플리케이션에 로그인하고 WeChat을 통해 스캔하여 새로운 앱 ID를 얻을 수 있습니다(이미 친구의 쿠폰을 포함하여 카드 및 쿠폰을 생성할 수 있는 권한이 있습니다)앱 비밀은 카드를 호출하는 데 사용됩니다. 쿠폰 인터페이스.
참고: 이 앱에서 생성된 쿠폰은 검토 및 승인되지 않으며 소규모 테스트로 제한되며 개발자가 다른 목적으로 사용할 수 없습니다.
3 카드 및 쿠폰 HelloWorld
개발자는 카드 생성, 배치 및 취소 프로세스를 빠르게 완료하기 위해 디버그 도구를 사용할 수 있습니다. 및 쿠폰 인터페이스를 사용하려면 문서의 해당 부분을 자세히 읽어야 합니다.
1단계 access_token 받기
페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 기본 지원
인터페이스 목록: access_token 인터페이스 가져오기
참고: 매개변수 채우기 개발 사용자의 appid 및 secret
클릭하여 문제를 확인하고 access_token으로 돌아갈 수 있습니다. access_token은 2시간 동안 유효하며 2시간 후에 다시 받아야 합니다.
2단계 카드를 업로드하고 쿠폰 로고
페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 기본 지원
인터페이스 목록: 사진 자료 업로드 인터페이스
access_token: 에서 획득 이전 단계 access_token
버퍼: 선택한 사진
클릭하여 질문을 확인하면 사진 URL을 얻을 수 있습니다. 다음 단계에서는 매개변수
에서 쿠폰을 만들어야 합니다. 3단계 쿠폰 만들기
페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 카드 인터페이스
인터페이스 목록: 카드 인터페이스 생성
access_token: 첫 번째 access_token
첫 번째 단계에서 얻은 JSON 예:
{
"card": {
"card_type": "GROUPON",
"groupon": {
"base_info": {
"logo_url":
"http://mmbiz.qpic.cn/mmbiz/iaL1LJM1mF9aRKPZJkmG8xXhiaHqkKSVMMWeN3hLut7X7hicFNjakmx ibMLGWpXrEXB33367o7zHN0CwngnQY7zb7g/0",
"brand_name":"微信餐厅",
"code_type":"CODE_TYPE_TEXT",
"title": "132元双人火锅套餐",
"sub_title": "周末狂欢必备",
"color": "Color010",
"notice": "使用时向服务员出示此券",
"service_phone": "020-88888888",
"description": "不可与其他优惠同享\n如需团购券发票，请在消费时向商户提出\n店内均可使用，仅限堂食",
"date_info": {
"type": "DATE_TYPE_FIX_TERM",
"fixed_term": 15 ,
"fixed_begin_term": 0
},
"sku": {
"quantity": 500000
},
"get_limit": 3,
"use_custom_code": false,
"bind_openid": false,
"can_share": true,
"can_give_friend": true,
"location_id_list" : [123, 12321, 345345],
"custom_url_name": "立即使用",
"custom_url": "http://www.qq.com",
"custom_url_sub_title": "6个汉字tips",
"promotion_url_name": "更多优惠",
"promotion_url": "http://www.qq.com"
},
"deal_detail": "以下锅底2选1（有菌王锅、麻辣锅、大骨锅、番茄锅、清补凉锅、酸 菜鱼锅可选）：\n大锅1份 12元\n小锅2份 16元 "}
}
}참고: date_info는 Unix 타임스탬프를 사용합니다. 주의하여 start_timestamp를 현재 시간보다 작게 변경하고 end_timestamp를 오늘 이후의 시간으로 변경하세요. 나중에 카드를 취소할 수도 있습니다. 쿠폰 테스트가 성공할 수 있습니다
인터페이스 주소: 카드 및 쿠폰 인터페이스 만들기
4단계 QR 코드 배달 만들기
페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 카드 인터페이스
인터페이스 목록: QR 코드 티켓 인터페이스 만들기
access_token: 첫 번째 단계에서 얻은 access_token
JSON 예:
{
"action_name": "QR_CARD",
"action_info": {
"card": {
"card_id": "po_2DjgJ2zrboM6SzK3qNuje5iWQ",
}
}
}인터페이스 주소: QR 코드 인터페이스 만들기
Step 5 QR 코드 표시
이전 단계에서 돌아올 때 show_qrcode_url 필드의 링크를 클릭하면 쿠폰 수집용 QR 코드가 표시됩니다.
예: https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQEr8ToAAAAAAAAASxodHRwOi8vd2V********NjRjVuAAIE3kqwVQMEgDPhAQ==
WeChat 열기 스캔한 다음 쿠폰이 심사를 통과하지 못했다고 표시되면 다음 단계에서 테스트 화이트리스트를 설정해야 합니다. 쿠폰을 받을 수 있으면 6단계를 무시하세요.
다음 QR 코드를 스캔하면 WeChat 쿠폰을 경험할 수 있습니다.
6단계 테스트 허용 목록 설정
#🎜🎜 # 페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 카드 인터페이스#🎜🎜 #
인터페이스 목록: 테스트 화이트리스트 인터페이스 설정access_token: 첫 번째 단계에서 얻은 access_token#🎜🎜 ## 🎜🎜#
JSON 예:
{ "username":["usr1","usr2"] }참고: usr1 및 sur2는 카드 수신을 위한 WeChat ID입니다. # 🎜🎜#
인터페이스 주소: 화이트리스트 인터페이스 설정
7단계 카드 상품권 확인
페이지 주소: http://mp.weixin.qq.com/debug/
인터페이스 유형: 카드 쿠폰 인터페이스
인터페이스 목록: 인증 카드 쿠폰 인터페이스
access_token: 첫 번째 단계에서 얻은 access_token
JSON 예:
{ "code"："759733467744" }참고: 유효 기간 내 승인만 지원합니다. 카드 쿠폰 인터페이스 주소: 인증 인터페이스
4 카드 및 쿠폰 인터페이스 개요
WeChat 카드 및 쿠폰 인터페이스는 주로 카드 및 쿠폰의 생성, 수집, 배치 및 확인과 관련된 일련의 인터페이스를 설정합니다. 개발자는 달성하려는 효과에 적합한 인터페이스를 선택하여
업계 고유의 카드 및 쿠폰 응용 프로그램을 개발할 수 있습니다.
5 카드 및 쿠폰 용어 소개
다음은 카드 및 쿠폰 개발 과정에서 이해해야 할 주요 개념입니다.
매개변수 이름 | 설명 |
card_id | 카드 아이디입니다. 쿠폰 ID는 쿠폰 종류에 해당하며 해당 재고 수량의 코드를 포함합니다. |
코드 | 쿠폰 코드. 카드 및 쿠폰의 고유 식별자입니다. 카드 및 쿠폰 취소 시 사용되는 문자열 코드입니다. |
openid | 이 공식 계정에 있는 사용자의 고유 ID입니다. |
access_token | 인터페이스 호출을 위한 자격 증명은 7200에 유효하며 은 get access_token 인터페이스를 통해 가져옵니다. 제대로 저장해야 해 캐시 메커니즘을 만듭니다. |
| jsapi_ticket | WeChat 웹 페이지에서 WeChat 기본 기능을 호출하는 JS-SDK 인터페이스를 호출하는 데 사용해야 하는 서명 티켓은 JS-SDK 섹션 | 을 참조하세요.
api_ticket | WeChat 카드 및 쿠폰 인터페이스 호출 시 서명된 임시 티켓은 7200년대 동안 유효합니다. 7200년대 이내에 반복 요청하면 변경되지 않습니다. api_ticket 인터페이스 받기받기. |
card_ext | 카드와 쿠폰을 넣을 때 사용하는 확장형 카드의 추가 정보로, 카드의 기본 정보와 함께 제공됩니다. |
outer_id | 쿠폰수집채널 씬값. 가맹점이 카드 및 쿠폰 발급을 위해 Card_ext에 맞춤형 Scene 값을 입력할 수 있도록 지원하며, 사용자가 카드를 받으면 해당 Scene 값을 이벤트를 통해 가맹점에 알려줍니다. ㅋㅋㅋ 본 이벤트는 개발자에게 푸시되어 공지되며, 수신 주소는 퍼블릭 플랫폼 개발자 센터에 입력된 서버 URL입니다. |
맞춤형 입구 | API를 통한 카드 및 쿠폰 생성은 판매자의 맞춤 카드 및 쿠폰 세부정보 페이지를 외부 링크 단위로 이동할 수 있도록 지원합니다. |
6 개발자 노트
6.1 WeChat 버전 판단
카드 및 쿠폰 기능 모듈은 버전 6.0.2 이후부터 지원됩니다. . 낮음 버전 사용자가 JS-SDK를 호출할 수 없습니다. 따라서 WeChat 팀은 판매자가 카드 패키지에 추가된 JS-SDK 인터페이스를 호출하기 전에 사용자 에이전트를 사용하여 사용자의 현재 버전 번호를 확인할 것을 권장합니다. iPhone 버전을 예로 들면 사용자 에이전트를 통해 다음 버전 샘플 정보를 얻을 수 있습니다.
"Mozilla/5.0(iphone;CPU iphone OS 5_1_1 like Mac OS X) AppleWebKit/534.46(KHTML,like Geocko)Mobile/9B206 MicroMessenger/6.0.2 "
여기서 6.0.2는 사용자가 설치한 WeChat 버전 번호입니다. 판매자는 버전 번호가 6.0.2 이상인지 확인할 수 있습니다.
6.2 카드 및 쿠폰 배치 제한
공식 계정 세션 환경에서는 공식 계정 도메인 이름의 카드 및 쿠폰만 지원됩니다. 공개 계정 세션 내에서 다른 판매자의 쿠폰을 푸시하는 것은 플랫폼의 허가 없이는 지원되지 않습니다. 그렇지 않으면 쿠폰을 받을 때 사용자에게 "쿠폰 판매자의 승인 없이 게시할 수 없습니다"라는 메시지가 표시됩니다. 공개 계정 대화(모멘트 및 대화 환경 등) 외부에는 그러한 제한이 없습니다.
Notes
공개 계정의 대화 상자에서 발생하는 작업과 공개 계정의 대화 상자에서 점프하는 웹 링크는 공개 계정의 세션 환경 내에 있습니다.
6.3 인코딩 규칙
API 인터페이스에서 게시된 모든 데이터는 UTF-8 인코딩만 지원하며, 그렇지 않으면 오류가 반환됩니다.
6.4 점프 외부 링크 매개 변수 설명
카드 및 쿠폰 자체를 기반으로 판매자의 확장 요구 사항을 충족하기위한 순서 : URL 점프가 허용됩니다. 카드 내부 페이지와 외부 링크에 추가됩니다.
카드와 쿠폰이 튀어나오는 외부 링크에는 개발자가 페이지에서 사용자의 신원을 확인하는 데 사용하는 카드 및 쿠폰 정보의 매개변수가 포함될 수 있습니다.
포함된 필드는 encrypt_code,card_id, openid,outer_str(회원카드만 해당)입니다.
참고: encrypt_code는 암호화된 코드이므로 실제 코드를 얻으려면 디코딩 인터페이스를 호출해야 합니다. 지정된 URL이 http://www.qq.com인 경우 사용자가 클릭하면 리디렉션되는 URL은 다음과 같습니다. http://www.qq.com?encrypt_code=ENCRYPT_CODE&card_id=CARDID&openid=xxxx&outer_str=xxxxx
6.5 문의하기
카드 및 쿠폰 개발에 문제가 발생하면 이메일 weixin_card@foxmail.com으로 문의하실 수 있습니다. 개발자 QQ 커뮤니케이션 그룹 205482166 512568283에 가입하실 수도 있습니다. 확인을 위해 판매자 이름과 업체를 반드시 기재해 주시기 바랍니다.
7 카드 및 쿠폰 정보 패키지 다운로드
개발자는 카드 및 쿠폰 인터페이스 정보 패키지를 다운로드할 수 있습니다.
- 생성 및 서명 도구 SDK
- 카드 및 쿠폰; 인터페이스 호출 프로세스 그림
- Android용 SDK
