非接触式（Contactless）配置

启用或禁用非接触式（contactless）支付功能，用于线下当面支付。

要启用或禁用卡片的非接触式支付功能，卡片状态必须为有效或临时封锁类型。（有关状态类型的详细信息，请参阅此处）

Request

ENDPOINT

/prepaid/card/CARD_KEY/contactless

MÉTODO

PATCH

路径参数

字段	类型	描述	字符数
CARD_KEY *	string	卡片识别密钥。	uuid

Request Body

{
    "contactless_enabled": false
}

请求体参数

字段	类型	描述	字符数
contactless_enabled *	Boolean	指示是否已启用。	true/false

Response

STATUS SUCCESS

200

错误

STATUS

4XX

Response Body

{
  "title": "Bad Request",
  "description": "We're sorry, but the card could not be update contactless. Please try again later.",
  "translation": "Unexpected error update contactless card",
  "code": "CARD000026"
}

Code	Status code	描述
QIT000001	400	Invalid Json schema.
CARD000011	404	It was not possible to fetch the Card for the card_key {card_key}.
CARD000023	406	The card type is invalid for this operation. Only plastic cards are allowed.
CARD000026	400	We're sorry, but the card could not be update contactless. Please try again later.
CARD000025	406	The status {status} is invalid for the operation.

Webhook

WEBHOOK_TYPE

baas.prepaid_card.card.updated.contactless

Webhook Body

{
    "webhook_type": "baas.prepaid_card.card.updated.contactless",
    "event_datetime": "2023-07-25T12:00:00.000Z",
    "data": {
        "card_key": "9bd93e97-bb6d-410f-8981-06b2765f12a1",
        "contactless_enabled": true
    }
}