订阅性支付

线下场景中仅适用于订阅性支付首笔交易（保存凭据）场景

订阅性支付包括两种类型的交易：初始的交易（或第一笔）和后续交易。

订阅性支付首笔交易（保存凭据）

持卡人在商户处进行第一笔定期交易（持卡人主动发起），以既定频率购买或同意接受一组商品或服务时。此笔交易还表明持卡人同意将凭据保存在商家处。

后续交易

后续交易是指商户自动向持卡人收取在第一笔定期交易中已经同意的指定商品或服务的费用，而无需持卡人主动发起支付（持卡人不在场），直到达到预定或约定的时间范围为止。

根据交易金额和频率的区别，订阅性支付有以下不同类型：

固定金额和固定频率
可变金额和可变频率，可变金额但频率固定以及固定金额但频率可变。

保存凭据

EVO Cloud 要求在卡和持卡人在场的情况下处理定期付款时首先保存凭据。您需要使用以下两个步骤：

完成付款：首先持卡人可以使用卡完成付款，并且带订阅性支付标识。paymentMethod.recurringProcessingModel。
卡号令牌化：当支付成功时，商家或收单机构可以使用在线 API：PaymentInstruments对卡进行令牌化。

流程如下:

提交一个付款后请求，其中包含您从购物者那里收集的数据，并包含以下值：
- autoCapture: true，表示消费。false或不出现，表示预授权。
- paymentMethod.type: 固定值 card，表示卡支付类型。
- paymentMethod.card: 卡信息
- paymentMethod.recurringProcessingModel: 表示订阅性支付交易.
  - Subscription: 固定金额和固定频率的订阅性支付。
  - Unscheduled:可变金额和可变频率，可变金额但频率固定以及固定金额但频率可变。
- transAmount: 支付的金额和币种.
- transInitiator: 包含商家设备或终端发起方式等信息.

样例

curl 'https://hkg-online-uat.everonet.com/g2/v0/payment/acq/10130014/evo.offline.payment' \
-H 'Authorization: 7bfb1d35a0e3d904fd06a2a46df73bb4acba7c3efb1b10cda3e7a30b28510199' \
-H 'DateTime: 20240306135818+0800' \
-H 'SignType: SHA256' \
-H 'Content-Type: application/json' \
-H 'MsgID: M20240306135818963' \
-d '{
    "merchantTransInfo": {
        "merchantTransID": "T20240306135818963",
        "merchantTransTime": "2024-03-06T13:58:18+08:00"
    },
    "paymentMethod": {
        "type": "card",
        "card": {
            "posEntryMode":"manual",
            "pinFlag":false,
            "termReadability":"5",
            "cardInfo": {
                "cardNumber": "4761340000000043"
            }
        },
        "recurringProcessingModel":"Subscription"
    },
    "transAmount": {
        "currency":"HKD",
        "value":"1.00"
    },
    "autoCapture": true,
    "pspInfo": {
        "mcc": "5499",
        "sponsorCode": "441378",
        "merchantID": "202106305812001",
        "terminalID":"00000001",
        "merchantName": "Test",
        "storeID": "202106305812001",
        "storeName": "Test Store",
        "street": "Test street",
        "city": "MYS",
        "postCode": "202000",
        "nation": "MYS"
    }
}'

检查支付应答。如果支付成功，您将在响应中收到paymentMethod.recurringReference。您将在后续支付中使用此关联信息。
卡号令牌化。请参阅线上支付场景绑卡：PaymentInstruments。
后续交易。请参阅线上支付方案订阅性支付：后续交易

订阅性支付 ​

保存凭据 ​

订阅性支付

保存凭据