卡操作

创建卡片

说明：

批量开卡需循环调用本接口，建议调用频率不超过每秒2次。
开卡成功后，系统将发送异步通知。如未收到通知，可通过查询接口补偿获取结果。

请求方式：POST
请求地址：/card/api/v1/op/create

请求参数

参数名	类型	是否必填	说明
partner_order_id	string	是	商户请求ID
card_bin_id	string	是	卡段ID
amount	decimal	是	开卡金额（创建子卡时传0）
account_currency	string	是	钱包币种，固定传USD
card_holder_id	string	否	持卡人ID（卡段需要持卡人时才需传）
card_model	string	是	卡模式。CARD：充值卡，SHARE：共享卡
primary_card_id	string	否	主卡ID（创建子卡时需要传）
total_auth_limit	string	否	子卡限额（创建子卡时指定，0代表不限额）
auth_limit_flag	string	否	是否限额。Y：是，N：否（创建子卡时需传）

返回参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID

卡详情查询

请求方式：GET
请求地址：/card/api/v1/op/queryCardDetail

请求参数

以下参数二选一传：

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID

返回参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
card_number	string	卡号
cvv	string	cvv
expiry	string	过期时间
currency	string	卡币种
active_date	string	激活日
inactive_date	string	失效日
card_brand	string	卡品牌
card_model	string	卡类型（SHARE/CARD）
card_level	string	SubCard/主卡
card_status	string	卡状态（Pending/Active/Failure/Closed）
available_balance	decimal	可用余额
total_auth_limit	decimal	子卡限额
used_auth_limit	decimal	子卡已用额度
primary_card_id	string	主卡ID

卡充值

对子卡无需充值，仅需充值主卡。

请求方式：POST
请求地址：/card/api/v1/op/recharge

请求参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
amount	decimal	充值金额
account_currency	string	钱包币种

返回参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
transaction_id	string	交易ID

卡提现

仅主卡可提现。

请求方式：POST
请求地址：/card/api/v1/op/withdraw

请求参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
amount	decimal	提现金额
account_currency	string	钱包币种

返回参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
transaction_id	string	交易ID

卡注销

请求方式：POST
请求地址：/card/api/v1/op/cancel

请求参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID

返回参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
transaction_id	string	交易ID

调整限额

请求方式：POST
请求地址：/card/api/v1/op/updateTotalAuthLimit

请求参数

参数名	类型	说明
partner_order_id	string	商户请求ID
card_id	string	卡ID
total_auth_limit	decimal	子卡限额，不限额传0
auth_limit_flag	string	是否限额是：Y，否：N

卡操作记录查询

请求方式：GET
请求地址：/card/api/v1/trade/queryCardOpDetail

请求参数

参数名	类型	说明
partner_order_id	string	商户持卡人ID
card_id	string	卡ID
transaction_type	string	交易类型，详见下表
begin_time	LocalDateTime	查询开始时间，例：2025-10-01 10:00:00
end_time	LocalDateTime	查询结束时间，例：2025-10-20 10:00:00
page_size	int	每页大小
page_no	int	当前页

返回参数

参数名	类型	说明
page_size	int	当前页大小
page_no	int	当前页数
total	int	总数
pages	int	总页数
list	List`<CardOpDetail>`	记录列表

CardOpDetail 字段

参数名	类型	说明
partner_order_id	string	商户持卡人ID
card_id	string	卡ID
primary_card_id	string	主卡ID
transaction_id	string	交易流水号
transaction_time	long	交易时间
create_time	long	创建时间
billing_currency	string	账单币种
billing_amount	decimal	账单金额
transaction_type	string	卡操作类型，详见下表
transaction_status	string	交易状态（Success/Failure/Processing）
fail_reason	string	失败原因
reference_id	string	关联ID
fund_account_type	string	资金账户类型（Wallet/卡）
fund_direct	int	资金方向（1增加，-1减少）
merchant_fee	MerchantFee	费用信息

MerchantFee 字段

参数名	类型	说明
total_fee_amount	decimal	总费用
fee_currency	string	费用币种
fee_detail	List`<MerchantFeeDetail>`	费用明细

MerchantFeeDetail 字段

参数名	类型	说明
fee_amount	decimal	费用
fee_type	string	费用类型

卡操作类型

类型	说明
Create	开卡
Recharge	卡充值
Withdraw	卡提现
Cancel	注销卡

Keyboard shortcuts

api