1. Features
Merchant Connect API
  • Integration Guide
    • EC Payment
      • Merchant API
        • Overview
        • Payment
        • Payment Methods
        • Response code
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
        • Features
          • Account Status Inquiry (ASI)
          • COF
          • Multi-Currency Transaction
          • Recurring
          • Smart Routing
          • Transaction Retry
          • Payout
          • Authentication
            • 3D Secure
            • FIDO Authentication
            • Authentication only
            • Authorization only
          • Tokenization
            • Gateway Tokenization
            • Create a gateway token
            • Network Tokenization
            • Pay with gateway token
            • Manage token
            • Network Token update notification
            • Card Based Network Token
    • In-store Payment
      • Merchant API (线下卡支付)
        • ZPK
          • ZPK
        • Payment
          • Payment
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
      • Merchant API(QR)
        • Payment
          • CPM
          • MPM
          • MPM static QR code
        • After Payment
          • Capture
          • Cancel
          • Refund
          • Cancel or Refund
          • Accept Notification
  • API Explorer
    • 下载 OpenAPI 规范文件
    • API Rules
    • PaymentMethod
      • PaymentMethod
      • PaymentMethod
      • PaymentMethod
      • PaymentMethod
    • FXRateInquiry
      • FXRateInquiry
      • FXRateInquiry
    • Payment
      • Payment
      • Payment
      • Payment
    • Payout
      • Payout
      • Payout
    • Capture
      • Capture
      • Capture
    • Cancel
      • Cancel
      • Cancel
    • Refund
      • Refund
      • Refund
    • Cryptogram
      • Cryptogram
      • Cryptogram
    • CancelOrRefund
      • Cancel or Refund
      • Cancel or Refund
    • Notification
      • Notification for PaymentMethod
      • Notification for Payment
      • Notification for Capture
      • Notification for Cancel
      • Notification for Refund
      • Notification for DataSubmission
      • Notification for MPM Static QR Code
      • Notification for Token Status Update
      • Notification for Settlement
      • Notification for Reversal
      • Notification for Cryptogram
      • Notification for Payout
    • 附录
      • Product Code
      • Result Code
      • Appendix: Payment Method Variant
      • Appendix: Payment Brands
    • HealthCheck
      • HealthCheck
    • ZPK
      • ZPK
    • Coupon Write-off
      • Coupon Write-off
    • Coupon Reversal
      • Coupon Reversal
  • MerchandiseCredit
    • Merchandise Credit
    • Merchandise Credit
  • Notification
    • Notification for Merchandise Credit
  1. Features

Recurring

仅适用于线上(EC)场景。
周期扣款包括两类交易:初始(或首次)周期扣款交易,以及后续交易。
初始或首次周期扣款交易(保存凭证)
初始或首次周期扣款交易是指:持卡人在商户网站交易时(持卡人在场),购买或同意按约定频率接收一组商品或服务。该交易同时表示持卡人同意商户保存其支付凭证。
后续交易
后续交易是指:商户在无需再次与持卡人交互(持卡人不在场)的情况下,就持卡人在初始交易中已同意的指定商品或服务自动向其扣款,直至达到预先设定或双方约定的期限(recurringExpiry)。
根据交易金额和频率是否固定,周期扣款分为以下几种类型:
1.
固定金额、固定频率
2.
变动金额、变动频率,变动金额、固定频率,或固定金额、变动频率。

保存凭证#

EVO Cloud 要求在处理周期扣款前先保存凭证。您可以使用以下两种方式:
1.
商户自行保存凭证:如果您已提交并完成 PCI DSS 自评估问卷 D(SAQ D),可以保存卡信息并用于后续支付。
2.
网关令牌化(Gateway Tokenization):详情请参阅 Gateway Tokenization(网关令牌化) 章节。

商户自行保存凭证#

您可以从服务端向 EVO Cloud 以下接口发起 HTTP POST 请求:
/g2/v1/payment/mer/{sid}/payment
并指定以下额外参数:
参数是否必填说明
paymentMethod.recurringProcessingModelO表示该交易是否为周期扣款交易。
Subscription:固定金额、固定频率的周期扣款。
Unscheduled:变动金额变动频率、变动金额固定频率,或固定金额变动频率的周期扣款。
captureAfterHoursO支付成功后,EVO Cloud 代商户发起完成(Capture)的小时数。周期扣款交易请设置为 0,EVO Cloud 将在支付成功后立即发起完成。
transAmountM支付的币种和金额。金额必须符合该币种的最小单位规则。
如涉及以下情况,您需要在支付请求中添加额外参数:
1.
卡信息:请参阅 paymentMethod.card 对象中的额外参数。
2.
用户认证:使用 3D Secure 或 SecurePlus。详情请参阅 Authentication(认证) 章节。
EVO Cloud 支持通过 ASI(transAmount 对象中金额为零)或带金额的授权来完成凭证保存。
如果支付成功,响应中会返回 paymentMethod.recurringReference,您将在后续交易中使用该参考号。
如果响应中没有返回 paymentMethod.recurringReference,您可以查询支付结果。详情请参阅 Payment(支付) 章节。

后续交易#

您可以从服务端向 EVO Cloud 以下接口发起 HTTP POST 请求:
/g2/v1/payment/mer/{sid}/payment
并指定以下额外参数:
参数是否必填说明
paymentMethod.recurringProcessingModelO表示该交易是否为周期扣款交易。
Subscription:固定金额、固定频率的周期扣款。
Unscheduled:变动金额变动频率、变动金额固定频率,或固定金额变动频率的周期扣款。
paymentMethod.recurringReferenceO唯一标识该周期扣款交易的 recurringReference。商户后续为用户发起支付时需要使用该参考号。
captureAfterHoursO支付成功后,EVO Cloud 代商户发起完成(Capture)的小时数。周期扣款交易请设置为 0,EVO Cloud 将在支付成功后立即发起完成。
transAmountM支付的币种和金额。金额必须符合该币种的最小单位规则。
如果您使用 ASI 保存凭证,首次后续交易也可能需要认证。详情请参阅 Authentication 章节。
上一页
Multi-Currency Transaction
下一页
Smart Routing
Built with