카드와 쿠폰을 쓰세요


카드 및 쿠폰 인증

업데이트 로그

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

1. 상각 안내 프로세스를 표준화합니다. 개발자는 상각 인터페이스를 호출하기 전에 코드 상태를 확인하기 위해 쿼리 코드 인터페이스를 호출하는 것이 좋습니다.

2. 개발자가 보다 쉽게 ​​사용하고 사용할 수 있도록 쿼리 코드 인터페이스를 최적화합니다. 이전 인터페이스와 호환됩니다

2015-8-31




# 🎜 🎜#



#🎜 🎜#



이 섹션에서는 사용자가 쿠폰을 사용한 후 개발자가 사용자의 WeChat 클라이언트에서 쿠폰을 사라지게 하는 프로세스를 주로 소개합니다. 이 단계를 상각이라고 합니다.


상각은 현재 온라인 상각과 오프라인 상각으로 구분됩니다. -off 두 가지 유형.

온라인 인증은 사용자가 HTML5 웹페이지에 접속한 후 적극적으로 쿠폰을 판매하는 과정을 말합니다. WeChat 몰 쿠폰, 셀프 서비스 확인 등과 같은 쿠폰 페이지 #🎜 🎜#

오프라인 상각

은 사용자가 매장에 도착한 후 QR 코드를 보여주거나 일련 번호, 계산원은 상각 코드 스캔, 기계 상각 등과 같은 상각 작업을 완료합니다.

1 오프라인 상각

1.1 쿼리 코드 인터페이스

개발자는 상각 코드 인터페이스를 호출하기 전에 쿼리 코드 인터페이스를 호출하고 코드를 확인하는 것이 좋습니다. 불법적인 상태(예: 전송, 삭제, 삭제 등)의 코드는 삭제되기 전에 처리됩니다.


인터페이스 호출 요청 설명

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

매개변수 설명

access_token
매개변수 가 필수인가요?
is 통화 인터페이스 자격 증명 ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


POST 데이터

{
   "card_id" : "card_id_123+",
   "code" : "123456789",
   "check_consume" : true
}

매개변수 설명

입니다. string(32)



# 🎜 🎜#


#🎜 🎜#



# 🎜 🎜#



#🎜 🎜#


check_consume이 true인 경우 데이터 반환

카드 및 쿠폰 상태 정상: 

{
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}

카드 및 쿠폰 상태 비정상: 

{
 "errcode": 40127,
 "errmsg": "invalid user-card status! Hint: the card was given to user, but may be deleted or set unavailable ! hint: [iHBD40040ent3]"
}


check_consume 시 데이터 반환 거짓입니다

카드 상태가 정상입니다: 

{
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjk4T4Hx-QFQGL4zGQy27_Qg",
    "begin_time": 1457452800,
    "end_time": 1463155199
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": true,
  "user_card_status": "NORMAL"
}

카드 상태가 비정상입니다: 

 {
  "errcode": 0,
  "errmsg": "ok",
  "card": {
    "card_id": "pbLatjnK8NLbWgwMgfMtnj3gaglw",
    "begin_time": 1457625600,
    "end_time": 1460217599
  },
  "openid": "obLatjm43RA5C6QfMO5szKYnT3dM",
  "can_consume": false,
  "user_card_status": "GIFTING"
}
### ## ## ## ## ## #####매개 변수 이름### ## #####설명#🎜🎜 ##### 🎜 🎜#
매개변수 이름필수Type값 예설명
코드 은 string(20) 110201201245단일카드의 유일한 기준입니다.아니요 🎜#
pFS7Fjg8kV1I #🎜 🎜#dDz01r4SQwMkuCKc 카드 ID는 카드 종류를 나타냅니다. 맞춤 코드 쿠폰이 필요합니다. 아니요 🎜# bool

true

코드 확인 여부 상각 상태, true와 false가 채워졌을 때 코드 예외 상태 반환 데이터가 다릅니다.
errcode오류 코드# 🎜🎜#errmsg#🎜 🎜# openidcard_id#🎜 🎜 # # 🎜 🎜#사용 시작 시간종료 시간# 🎜🎜#ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ





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







주의 사항:

1. 사용자가 실제 수집한 시점을 기준으로 고정 기간이 환산됩니다. , 2013년 기준 고정기간 유효기간은 90일, 즉 2013년 10월 1일부터 12월 29일까지 유효합니다.

2. check_consume이 true인지 false인지에 관계없이 코드가 추가되지 않거나 코드가 전송 및 수신되면 균일한 오류가 보고됩니다. 잘못된 일련 코드

1.2 Underwriting Code 인터페이스

소비 코드 인터페이스는 쿠폰 취소를 위한 유일한 인터페이스입니다. 개발자는 현재 인터페이스를 호출하여 사용자의 쿠폰을 취소할 수 있습니다.

인터페이스 호출 요청 설명

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

参数说明

오류 메시지
useropenid
쿠폰 IDbegin_time
end_time
user_card_status

현재 코드에 해당하는 카드 상태

NORMAL 정상

CONSUMED 취소되었습니다

EXPIRE > >

UNAVAILABLE Invalid

코드가 추가되거나 전송 및 수신되지 않으면 오류가 보고됩니다: 잘못된 일련 코드

can_consume

쓸 수 있는지 여부, true 취소할 수 있다는 뜻이고 false는 취소할 수 없다는 뜻입니다

access_token
매개변수 가 필수인가요?
is 통화 인터페이스 자격 증명 ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


POST 데이터

非自定义Code卡券的请求
{
  "code": "12312313"
}
或自定义Code卡券的请求
{
  "code": "12312313",
  "card_id": "pFS7Fjg8kV1IdDz01r4SQwMkuCKc"
}
# 🎜 🎜 ####유형#### ## ## ######예제 값#🎜🎜 ## ## ######설명###🎜🎜 아니요 ㅋㅋㅋ kuCKc# 🎜🎜##🎜 🎜 #
매개변수 이름필수쿠폰ID. 쿠폰 생성 시 use_custom_code를 입력하면 true로 입력됩니다. 비맞춤형 코드는 입력할 필요가 없습니다.
code은 확인이 필요한 코드 코드입니다. ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ




데이터 반환 

 {
"errcode":0,
"errmsg":"ok",
"card":{"card_id":"pFS7Fjg8kV1IdDz01r4SQwMkuCKc"},
"openid":"oFS7Fjl0WsZ9AMZqrI80nbIq8xrA"
}
### ## ## ## ## ## #####매개 변수 이름### ## #####설명#🎜🎜 ##### 🎜 🎜#errcode오류 코드. 오류 메시지. openid공개 계정 로고 내 사용자의 고유 ID . card_id카드쿠폰ID.








참고:

1. 유효한 카드와 쿠폰만 취소 가능합니다. 상태가 이상하면 취소할 수 없습니다. (예외 상태에는 카드 및 쿠폰 삭제됨, 유효하지 않음, 만료됨, 양도 중, 양도를 위해 반환됨, 유효하지 않음)

2.맞춤 코드(use_custom_code가 true)가 포함된 쿠폰은 코드에서 삭제됩니다. 이 인터페이스를 호출해야 합니다. 사용자 클라이언트의 코드 상태를 변경하는 데 사용됩니다. 사용자 정의 코드가 있는 카드 및 쿠폰에 대한 인터페이스를 호출할 때 게시물 데이터에는 카드 ID가 포함되어야 합니다. 그렇지 않으면 잘못된 일련 코드가 보고될 필요가 없습니다.

2 온라인 인증

2.1 풀 카드 및 쿠폰 목록 인터페이스(JS-SDK)

WeChat JS-SDK는 WeChat 내장 브라우저에서만 사용할 수 있으며, 다른 브라우저에서의 호출은 유효하지 않습니다. WeChat은 판매자의 프런트엔드 웹페이지 호출을 위한 chooseCard 인터페이스를 제공합니다. 이는 사용자 이름으로 판매자 필터 조건의 카드 및 쿠폰 콘텐츠를 가져오는 데 사용됩니다. 클릭해서 보세요 매장에 적용 가능한 카드 및 쿠폰 목록을 불러오고 사용자 선택 목록을 받으세요 JS-SDK

1476165443869832.jpg

2.2 코드 디코딩 인터페이스

코드 디코딩 인터페이스 두 가지 시나리오를 지원합니다:

1. 판매자가 chooses_card_info를 얻은 후 디코딩 인터페이스를 통해 카드 ID 및 encrypt_code 필드를 전달하여 실제 코드를 얻습니다.

2. 코드는 카드 내 외부 링크의 서명으로 암호화되며, 실제 코드는 디코딩 인터페이스를 호출하여 얻을 수 있습니다.

인터페이스 호출 요청 설명

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

매개변수 설명

access_token
매개변수 가 필수인가요?
is 통화 인터페이스 자격 증명 ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ


POST 데이터

{
  "encrypt_code":"XXIzTtMqCxwOaawoE91+VJdsFmv7b8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE"
}


  参数说明

입니다.
매개변수 이름필수Type예제 값Description
encrypt_ 코드 는 string(128)

XXIzTtMqCxwOaawoE91+VJdsFmv7b

8g0VZIZkqf4GWA60Fzpc8ksZ/5ZZ0DVkXdE

암호화된 코드.
ㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋㅋ




반품 데이터

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

매개변수 설명

매개변수 이름설명
errcode오류 코드
errmsg 오류 메시지
code해독 나중에 얻은 실제 코드





# 🎜 🎜#



메모

# 🎜 🎜 #

1. 이 공식 계정의 쿠폰에서 얻은 암호화된 코드만 해독할 수 있습니다.

2. 개발자가 URL에서 암호화된 코드를 얻은 경우 urldecode에 주의하세요. 먼저 그렇지 않으면 오류가 보고됩니다.

3.encrypt_code는 원투코드를 암호화하여 얻은 암호화된 코드입니다. -코드와의 하나의 대응.

4. 개발자는 이 공개 계정의 암호화된 코드만 해독할 수 있습니다. 그렇지 않으면 오류가 발생합니다. 보고됩니다.

2.3 질의코드 인터페이스

개발자는 상쇄코드 인터페이스를 호출하기 전 질의코드 인터페이스를 먼저 호출하여 불법적인 상태(이전, 삭제, 검증 등)된 코드를 확인하시길 적극 권장합니다. )을 작성하기 전에 판매 등)이 처리됩니다.

2.4 상쇄 코드 인터페이스

온라인에서 일반 쿠폰을 상쇄하는 인터페이스는 오프라인에서 일반 쿠폰을 상쇄하는 인터페이스와 동일합니다.

←
→

PHP 중국어 웹사이트

집집강의강의기사기사Q&AQ&A사전사전수동수동다운로드다운로드찾다찾다APP다운로드 APP다운로드