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
          • 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
  • API Explorer
    • API Rules
  • PaymentMethod
    • PaymentMethod
      POST
    • PaymentMethod
      PUT
    • PaymentMethod
      GET
    • PaymentMethod
      DELETE
  • FXRateInquiry
    • FXRateInquiry
      POST
    • FXRateInquiry
      GET
  • 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
  • HealthCheck
    • HealthCheck
  • ZPK
    • ZPK
  • 附录
    • Result Code
    • Appendix: Payment Method Variant
    • Appendix: Payment Brands
  • Coupon Write-off
    • Coupon Write-off
  • Coupon Reversal
    • Coupon Reversal
  1. Features

Payout

Payout#

产品概述#

EVO Payment 提供原始信用交易(Original Credit Transaction,OCT),适用于退税、线上游戏等多种业务场景。

工作原理#

下图描述了出款(Payout)的完整流程。

步骤 1:检查银行卡是否可用#

EVO Payment 支持在发起原始信用交易之前,通过零金额授权交易验证银行卡。详情请参阅“账户状态查询(ASI)”章节。该步骤为可选步骤。

步骤 2:收集用户出款信息#

根据 API 规范收集用户的出款信息,然后发送到您的服务端。请注意,如果用户选择使用银行卡,商户必须满足 PCI DSS 合规要求。您可以通过以下 2 种方式收集卡信息:
1.
使用 EVO Payment 客户端方案对用户卡信息进行安全加密。
该方式可确保您满足 PCI DSS 合规要求,您只需提交 PCI DSS 自评估问卷 A(SAQ A)。详情请参阅《EVO Payment SDK 集成指南》。
2.
收集并发送卡片明文数据。
该方式要求您按照 PCI DSS 自评估问卷 D(SAQ D)评估自身的 PCI DSS 合规情况,这是范围最广的自我认证形式。在原始信用交易场景中,用户只需发送卡号或加密后的卡号。

步骤 3:发起出款#

1.
仅有出款交易时
用户选择银行卡并提交所需出款信息后,您需要向 EVO Payment 发起出款请求。您可以从服务端向 EVO Payment 以下接口发起 HTTP POST 请求:
/g2/v1/payment/mer/{sid}/payout
并指定以下参数:
Body 参数是否必填说明
merchantTransInfoM出款的参考信息,包括唯一的 merchantTransID,以及表示您发起请求时间的 merchantTransTime。
transAmountM出款的币种和金额。金额必须符合该币种的最小单位规则。
paymentMethodM使用 paymentMethod.type 指定出款方式类型(例如 card),并携带上一步收集的对应出款信息。
transInitiatorM发起交易的设备信息。
tradeInfoM用于说明原始信用交易的具体场景。
senderInfoM向收款卡汇款的付款人详细信息。如果您能获取该信息,请传入,有助于 EVO Payment 进行反洗钱和欺诈检测,并提升出款成功率。
recipientInfoM接收付款人资金的收款人详细信息。如果您能获取该信息,请传入,有助于提升出款成功率。
webhookO接收通知的 URL。传入该参数后,出款成功时将收到 EVO Payment 的通知。
metadataO您可在请求中自定义的参考信息,会在响应中原样返回。除 GET 请求外,响应中的 metadata 与您请求中的 metadata 相同;GET 响应中的 metadata 与 POST 请求中的 metadata 相同;通知中的 metadata 也与 POST 请求中的 metadata 相同。
paymentMethod 对象的更多说明:
以下以银行卡场景为例:
1.
paymentMethod.type:请求中设置为 card。
2.
paymentMethod.card.payoutCardInfo.cardNumber:设置为收款人的卡号。
tradeInfo 对象的更多说明:
tradeInfo.tradeType:
该字段用于定义原始信用交易的具体场景,不同场景需要使用不同的取值。目前 EVO Payment 支持以下四种有效取值:
Funds_Disbursement:用于退税、代发工资、游戏充值等。
Online_Gambling_Payout:用于线上游戏。
Account_Transfer:用于 P2P 场景中同一人名下两个账户之间的原始信用交易。
Personal_Transfer:用于 P2P 场景中两个人之间的原始信用交易。
以下是使用 Visa 卡发起 10 USD 出款的示例:
以下是响应示例:
2.
P2P 场景中的 OCT 交易
在 P2P 场景中,如果用户选择通过两个请求完成转账,需要先发送一笔 AFT(Account Funding Transaction,账户注资交易)请求(POST Payment),再发送一笔 OCT 请求(POST Payout)。OCT 请求必须在请求 URL 中关联 AFT 请求的 merchantTransID,以便关联必要的信息。
以下是 P2P 场景中 OCT 的请求 URL 示例(merchantTransID 的值仅为示例,该 merchantTransID 属于 AFT 交易):
/g2/v1/payment/mer/{sid}/payout?merchantTransID=T509091757387259148

步骤 4:展示出款结果#

用户确认出款后,您可以根据 result.code 和 payout.status 告知用户出款状态。
Result codeDescription
S0000Success
V0008Field { } is not applied with { }
C0004Request resource merchantTransID {XXX} not exist
B0005Unsupported function {XXX}, please check your profile setup in EVO Payment
B0006Unsupported payment brand {XXX}, please check your profile setup in EVO Payment
B0033The transaction was rejected for security violation
其他可能的 result.code 取值以及可向用户展示的推荐提示语,请参阅《EVO Payment API 规范》附录。
查询出款详情
用户可以发送 GET Payout 请求获取出款的详细信息。
您可以从服务端向 EVO Payment 以下接口发起 HTTP GET 请求(merchantTransID 的值仅为示例,该 merchantTransID 属于您要查询的出款交易):
/g2/v1/payment/mer/{sid}/payout?merchantTransID=T509091757387259148
响应内容与 POST Payout 的响应相同。
上一页
Transaction Retry
下一页
3D Secure
Built with