Gourmet Card

Verify and retrieve full details of an Alipay Gourmet Card (美食卡) using its memberCardId. Returns the card's discount details, expiry, and metadata.

When to Use

▾

Use this endpoint when:

• Verifying an Alipay Gourmet Card before applying the discount
• Looking up card details for a verified Alipay member

note

For Alipay merchants only.

How to Use

▾

Endpoint

POST/v3/membership/verify

POST memberCardId and storeId to /v3/membership/verify. Use the returned details to apply the discount in your payment flow.

---

Request Parameters

▾

memberCardIdSTRING

From Ali Pay member card id

Example: 28158443195878043074

storeIdSTRING

Store ID

Example: "4949529109748431621"

Response Parameters

▾

itemOBJECT

Transaction object

idSTRING

Gourmet Card ID

Example: "28158443195878043074"

transactionIdSTRING

Transaction ID

Example: "1584431832399399267"

cardIdSTRING

Card ID

Example: "1576632501406219093"

memberIdSTRING

Member ID

Example: "1584431797984173748"

expiredAtDATETIME

Expired date time

Example: "2020-05-16T07:59:18Z"

createdAtDATETIME

Creation date time

Example: "2020-03-17T07:59:18Z"

updatedAtDATETIME

Last update date time

Example: "2020-03-05T09:40:21Z"

cardOBJECT

Refer to explanation below

idSTRING

Card ID

Example: "1576632501406219093"

nameSTRING

Card Name

Example: "九折美食卡"

lifetimeINTEGER

Life Time

Example: 60

lifetimeTypeSTRING

Life Time Type

Example: "DAY"

amountINTEGER

Amount

Example: 10

currencySTRING

Currency type

Example: "RMB"

discountTypeSTRING

Discount type

Example: "DISCOUNT"

discountValueNUMBER

Discount Value

Example: 1000

minimumSpentAmountINTEGER

Minimum Spent Amount

Example: 10

walletSTRING

Wallet : Alipay

Example: "ALIPAY"

templateIdSTRING

Template ID

Example: "20191218000000002154347000300178"

statusSTRING

Status

Example: "ACTIVE"

imageSTRING

Image

Example: "https://rm-sandbox-membership-public.oss-ap-southeast-3.aliyuncs.com/gourmet/card/image-1579510518825819467-1579510518.png"

iconSTRING

Icon

Example: "https://rm-sandbox-membership-public.oss-ap-southeast-3.aliyuncs.com/gourmet/card/icon-1579505367845553007-1579505367.png"

createdAtDATETIME

Create date time

Example: "2019-12-18T01:28:24Z"

updatedAtDATETIME

Update date time

Example: "2019-12-18T01:28:24Z"

codeSTRING

Successfully call this endpoint. If fail, will return error code object (Refer Appendix 1: Error Codes)

Example: "SUCCESS"