购买会员卡

为指定用户开通会员卡。支持全款直接开卡（储值卡选择充值档位）和零门槛提交赊账申请（待商户审核）两种模式。

请求

POST /open-api/v1/member-cards/purchase

请求体

字段	类型	必填	说明
merchantId	long	是	商户 ID
templateId	long	是	会员卡模板 ID
appUserId	long	是	App 用户映射 ID（调用用户同步接口后获取）
tierId	long	否	充值档位 ID，储值卡选择档位时传入

请求示例

curl -X POST 'https://openapi.example.com/open-api/v1/member-cards/purchase' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature' \
  -H 'Content-Type: application/json' \
  -d '{
    "merchantId": 1001,
    "templateId": 3001,
    "appUserId": 10001,
    "tierId": 201
  }'

响应

响应参数

字段	类型	说明
resultType	int	开卡结果类型：1-直接开卡成功 2-赊账申请已提交待审核
id	long	会员卡 ID（直接开卡成功时返回）或赊账申请 ID

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "resultType": 1,
    "id": 5001
  }
}

appUserId 说明

appUserId 是通过客户同步接口（POST /open-api/v1/customers/sync）将应用侧用户同步到平台后获取的映射 ID，不是应用侧的原始用户 ID。

开卡模式说明

• 全款直接开卡：resultType=1，开卡成功，id 为会员卡 ID。
• 赊账申请：resultType=2，已提交申请等待商户审核，id 为申请记录 ID。审核通过后会触发回调通知。