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/

인터페이스 유형: 카드 인터페이스#🎜🎜 #

JSON 예:

{ "username":["usr1","usr2"] }

인터페이스 주소: 화이트리스트 인터페이스 설정

7단계 카드 상품권 확인

페이지 주소: http://mp.weixin.qq.com/debug/

인터페이스 유형: 카드 쿠폰 인터페이스

인터페이스 목록: 인증 카드 쿠폰 인터페이스

access_token: 첫 번째 단계에서 얻은 access_token

JSON 예:

{ "code"："759733467744" }

참고: 유효 기간 내 승인만 지원합니다. 카드 쿠폰 인터페이스 주소: 인증 인터페이스

4 카드 및 쿠폰 인터페이스 개요

WeChat 카드 및 쿠폰 인터페이스는 주로 카드 및 쿠폰의 생성, 수집, 배치 및 확인과 관련된 일련의 인터페이스를 설정합니다. 개발자는 달성하려는 효과에 적합한 인터페이스를 선택하여

업계 고유의 카드 및 쿠폰 응용 프로그램을 개발할 수 있습니다.

5 카드 및 쿠폰 용어 소개

다음은 카드 및 쿠폰 개발 과정에서 이해해야 할 주요 개념입니다.

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

제출하다