# 常规卡对接指引

## 卡头列表查询

{% hint style="info" %}
调用接口[卡头列表查询](#ka-tou-lie-biao-cha-xun) 得到您可以开的常规卡卡头，也可在您的商户后台查看您目前可以开的卡头
{% endhint %}

## 如何开卡、充值、销卡

{% hint style="info" %}
**开卡：**

调用接口[开卡申请](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/2.-kai-ka-shen-qing-2.0)，实现开卡（某些卡头是实时返回开卡结果，某些不是，具体见[开卡申请](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/2.-kai-ka-shen-qing-2.0)）。

然后根据[webhook](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/20.webhook)中关于订单终态的推送，完成开卡闭环；也可调用接口[卡片订单信息查询](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/13.-ka-pian-ding-dan-xin-xi-cha-xun-dan-bi)，获取订单状态，当是终态时完成业务逻辑。

**充值：**

调用接口[卡片充值](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/4.-ka-pian-chong-zhi-2.0)，实现充值（某些卡头是实时返回充值结果，某些不是，具体见[卡片充值](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/4.-ka-pian-chong-zhi-2.0)）。

然后根据[webhook](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/20.webhook)中关于订单终态的推送，完成充值闭环；也可调用接口[卡片订单信息查询](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/13.-ka-pian-ding-dan-xin-xi-cha-xun-dan-bi)，获取订单状态，当是终态时完成业务逻辑。

**销卡：**

调用接口[销卡](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/6.-xiao-ka)，实现销卡（这个接口不会返回销卡金额）。

需要根据[webhook](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/20.webhook)中关于订单终态的推送，完成销卡闭环；也可调用接口[卡片订单信息查询](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/13.-ka-pian-ding-dan-xin-xi-cha-xun-dan-bi)，获取订单状态和销卡金额，当是终态时完成业务逻辑。
{% endhint %}

## 如何获知卡片交易明细、账单明细及它们的区别

{% hint style="info" %}
**交易明细**

交易明细为准实时记录，卡片发生绑卡、交易、退款等用户行为时，均会触发。可以通过[卡片交易明细](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/14.-ka-pian-jiao-yi-ming-xi)主动查询卡片交易明细，也可以根据[webhook](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/20.webhook)中的授权交易记录推送获得交易明细

**账单明细**

账单明细为跑批生成记录，只有完成清算的消费、退款才会在这里出现。一般在授权交易完成后7天左右完成清算，也有少量长时间清算才完成的情况，无定论。可以通过[卡片账单明细](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/15.-ka-pian-zhang-dan-ming-xi)主动查询卡片账单明细，也可以根据[webhook](https://blockpursevcc.gitbook.io/api-document/blockpurse-vcc-jie-kou-wen-dang/api-jie-kou/20.webhook)中的清算记录推送获得账单明细

{% endhint %}

## 商户模拟交易接口用途

{% hint style="info" %}
**方便商户在商测环境模拟交易，测试自身业务逻辑**
{% endhint %}

## 账户明细查询

{% hint style="info" %}
商户对账使用
{% endhint %}

## 特殊WEBHOOK

{% hint style="info" %}
除了以上提到的订单终态、交易明细、账单明细webhook之外，还存在两种情况的webhook推送。

1.被动销卡。指的是商户侧未发起销卡，是渠道侧发起（比如卡片到期，使用次数到限制，风控原因）。我们会主动推送给客户，方便您完成后续业务处理。

2.销卡后清算退款。指的是卡片交易清算时该卡片已经销卡不存在了，那么退款资金无卡可退，会自动退回到客户的主账户。我们会主动推送给客户，方便您完成后续业务处理。
{% endhint %}

##