跳转到主要内容
cardDetect 方法激活终端读卡器以识别和捕获支付方式(卡或 QR)的数据,而不发起资金冻结或收费。它是一种多用途工具,适用于必须先进行客户识别再进行支付阶段的工作流程。 使用此方法可以:
  • 通过会员卡或手机二维码识别顾客,并提供个性化折扣。
  • 检索已屏蔽的卡片数据,以欢迎老用户或验证会员资格。
  • 使用卡片数据确定符合条件的燃油类型或促销活动,然后再请求授权。
  • 接受非接触式支付(CTLS)、芯片支付(EMV)、磁条支付(刷卡)和二维码扫描。
Nayax 设备上卡检测提示的示例: cardDetect

请求

All requests must include the command and a unique requestId. While this method does not authorize funds, an amount must be provided for display purposes on the terminal screen. 以下示例展示了一个典型的请求:

参数定义

下表描述了检测请求中可用的参数:

回应

当用户与读卡器交互或成功扫描二维码时,VPOS 终端会返回响应。 以下示例展示了典型的信用卡响应:
以下示例展示了典型的二维码响应:
以下示例展示了按钮按下时的响应:
注意:当使用 cardDetect 处理非信用卡方式(例如专有的 QR 码)或按下按钮时,客户端系统负责后续的任何授权或结算逻辑。QR 码扫描或按下按钮后,读卡器会自动禁用。

响应参数

响应数据按客户使用的输入方式进行分类: