async getCardMetadataInDevice() {
   try {
      // 如果是手机设备，数组只有一个元素。如果是穿戴设备，会根据连接的穿戴设备数返回对应数量的数组元素。
      const cardMetadataInDeviceList = await this.transitCardClient.getCardMetadataInDevice(this.deviceType);
      console.info(`Succeeded in getting cardMetadataInDevice, card length is ${cardMetadataInDeviceList.length}`);
      return cardMetadataInDeviceList;
   } catch (err) {
      console.error(`Failed to get CardMetadataInDevice, code:${err.code}, message:${err.message}`);
      return [];
   }
}

用户选择开通交通卡后，开发者调用canAddTransitCard接口，传入issuerId和指定设备Id。

钱包会检查指定设备上目标卡片的开卡条件是否满足，如有条件不满足，会返回相应错误码，请按错误码类型给用户具体的错误提示。如条件满足则会返回开卡凭证数据addCardOpaqueData，数据长度为64个字符。

async canAddTransitCard(cardMetadataInDevice: walletTransitCard.CardMetadataInDevice) {
   try {
      const issuerId = cardMetadataInDevice.cardMetadata[0].issuerId;
      const specifiedDeviceId = cardMetadataInDevice.deviceId;
      const addCardOpaqueData = await this.transitCardClient.canAddTransitCard(issuerId, specifiedDeviceId);
      return addCardOpaqueData;
   } catch (err) {
      console.error(`Failed to check, code:${err.code}, message:${err.message}`);
      return '';
   }
}

在开卡条件检查通过获取到开卡凭证数据后，开发者App需要将用户的开卡和首充值的订单信息连同开卡凭证addCardOpaqueData一起提交给开发者的服务器生成开卡+首充的订单，addCardOpaqueData需和订单关联存储。

开发者的服务器将订单提交给支付机构，在用户授权完成支付并收到支付机构的支付完成通知后，向卡公司的SP TSM服务器下发开卡+首充值的订单数据，其中需要包括addCardOpaqueData数据。

在确认订单支付完成后，开发者调用addTransitCard接口，传入addCardOpaqueData和serverOrderId进行开卡。

开卡过程会跳转到钱包App页面进行，开卡成功后返回到开发者App并携带卡片的基本数据，包括卡号和余额信息。开卡过程中如出现失败，钱包App会自动重试，如重试不成功，钱包App会自动发起回滚流程，向支付机构申请退款。

async addTransitCard(addCardOpaqueData: string) {
   try {
      const res = await this.transitCardClient.addTransitCard(addCardOpaqueData, this.serverOrderId);
      // 开卡成功，获取到卡片数据，可以用来展示对应交通卡的卡片，包含卡号及余额。
      console.info(`Succeeded in adding card, balance: ${res.balance}, cardNumber: ${res.cardNumber}, logicalCardNumber: ${res.logicalCardNumber}`);
   } catch (err) {
      console.error(`Failed to add card, code:${err.code}, message:${err.message}`);
   }
}

开发场景

充值交通卡

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问