创建虚拟卡

Request

ENDPOINT

/prepaid/card

MÉTODO

POST

Request Body

{
    "account_key": "5294ed8d-08fc-4397-b15f-6d9aa07b0041",
    "program_key":"7d405c31-ec9a-46c1-8ac8-54bab209bf41",
    "type": "virtual",
    "card_name": "ecommerce",
    "printed_name": "Aurora Catarina",
    "cvv_rotation_interval_hours": 72
}

请求体参数

字段	类型	描述	字符数
account_key *	string	QI Tech 支付账户的识别密钥。	uuid
program_key *	string	用于发行卡片的程序识别密钥。	uuid
type *	string	要发行的卡片类型（VIRTUAL）。	枚举值
card_name *	string	卡片别名，用于识别该卡片。	uuid
printed_name *	string	印在卡片上的姓名（不允许使用数字和特殊字符）。	uuid
cvv_rotation_interval_hours *	int	CVV 号码更新的时间间隔（小时）。	Number

card_type 枚举值

枚举值	说明
plastic	实体卡
virtual	虚拟卡

Response

STATUS

201

Response Body

{
    "card_key": "05fd3654-1f5d-479d-ade5-64239fdf214d",
	"created_at": "2023-02-20T19:28:16Z",
    "status":"created"
}

错误

STATUS

4XX

Response Body

{
  "title": "Bad Request",
  "description": "The type of person is invalid for this program, please try another.",
  "translation": "Invalid Person",
  "code": "CARD000007"
}

Code	Status code	描述
QIT000001	400	Invalid Json schema.
CARD000005	404	It was not possible to fetch the Program for the program_key {program_key}.
CARD000006	404	It was not possible to fetch the Account for the account_key {account_key}.
CARD000007	400	The type of person is invalid for this program, please try another.
CARD000008	400	The Card Holder with the status {status} is invalid for the operation.
CARD000009	400	We're sorry, but the card could not be generated. Please try again later.
CARD000010	404	It was not possible to fetch the Person for the person_key {owner_person_key}.
CARD000032	403	Create virtual card is not allowed for program_key {program_key}.

Webhook

WEBHOOK_TYPE

baas.prepaid_card.card

Webhook Body

{
    "webhook_type": "baas.prepaid_card.card",
    "event_datetime": "2023-07-24T12:00:00.000Z",
    "data": {
        "card_key": "9bd93e97-bb6d-410f-8981-06b2765f12a1",
        "account_key": "595e08f0-da4e-40f7-8db4-f9a25c829818",
        "program_key": "bf74df61-557a-45cb-914f-41e127a6e18c",
        "status": "created",
        "type": "virtual"
    }
}