常规卡对接指引

该文档面向开发人员，可根据自身业务逻辑选择不同的接口调用

卡头列表查询

调用接口卡头列表查询 得到您可以开的常规卡卡头，也可在您的商户后台查看您目前可以开的卡头

如何开卡、充值、销卡

开卡：

调用接口开卡申请，实现开卡（某些卡头是实时返回开卡结果，某些不是，具体见开卡申请）。

然后根据webhook中关于订单终态的推送，完成开卡闭环；也可调用接口卡片订单信息查询，获取订单状态，当是终态时完成业务逻辑。

充值：

调用接口卡片充值，实现充值（某些卡头是实时返回充值结果，某些不是，具体见卡片充值）。

然后根据webhook中关于订单终态的推送，完成充值闭环；也可调用接口卡片订单信息查询，获取订单状态，当是终态时完成业务逻辑。

销卡：

调用接口销卡，实现销卡（这个接口不会返回销卡金额）。

需要根据webhook中关于订单终态的推送，完成销卡闭环；也可调用接口卡片订单信息查询，获取订单状态和销卡金额，当是终态时完成业务逻辑。

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

交易明细

交易明细为准实时记录，卡片发生绑卡、交易、退款等用户行为时，均会触发。可以通过卡片交易明细主动查询卡片交易明细，也可以根据webhook中的授权交易记录推送获得交易明细

账单明细

账单明细为跑批生成记录，只有完成清算的消费、退款才会在这里出现。一般在授权交易完成后7天左右完成清算，也有少量长时间清算才完成的情况，无定论。可以通过卡片账单明细主动查询卡片账单明细，也可以根据webhook中的清算记录推送获得账单明细

商户模拟交易接口用途

方便商户在商测环境模拟交易，测试自身业务逻辑

账户明细查询

商户对账使用

特殊WEBHOOK

除了以上提到的订单终态、交易明细、账单明细webhook之外，还存在两种情况的webhook推送。

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

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