Pyvio Open API Docs
首页
指南
收款
付款
换汇
收单
湃付卡
其它
首页
指南
收款
付款
换汇
收单
湃付卡
其它
  • 快速开始

    • 简介
    • 服务配置
    • 名词解释
      • 名词解释
        • 交易能力
        • 直接支付
        • 预授权支付
        • AUTH
        • CAPTURE
        • VOID
        • 退款
        • 查询
        • 3D认证支付
    • 错误码
  • 对接流程

    • 接口对接
    • 交易状态
    • 风控风险订单审核
    • 风控插件
  • 收银台模式

    • 跳转式收银台
    • 内嵌式收银台
  • 端到端模式

    • 端到端模式
  • 验收流程

    • 验收流程
  • 建站插件

    • woocommerce
目录

名词解释

# 名词解释

# 交易能力

Pyvio目前支持两种支付模式,直接支付,预授权支付

# 直接支付

支付交易发起时直接从提交的支付卡里直接扣除余额或者额度,完成消费和结算

# 预授权支付

发生支付行为时先冻结支付卡余额或者额度,等持卡人真实消费后才会真正扣除对应的消费金额,消费和结算不是同时发生,常用与酒店预订,车票预订等业务场景

# AUTH

发起预授权交易

收银台预授权支付 (opens new window)

端到端预授权支付 (opens new window)

接口参数:payment_type=AUTH 时发起预授权交易

# CAPTURE

对于发起的预授权交易完成后且状态SUCCESS时,在资金冻结期间内使用CAPTURE操作预授权确认接口 (opens new window)完成真实交易,CAPTURE的金额需小于AUTH预授权交易发起的交易金额,对于超时未及时CAPTURE的预授权交易会自动取消即VOID操作

# VOID

对于发起的预授权交易完成后且状态SUCCESS时,撤销预授权即撤销预授权交易 (opens new window)的冻结金额,相当于实际未发生过支付,超时未进行CAPTURE的交易会自动VOID

# 退款

真实完成的交易不管是直接支付还是预授权支付都可以发起退款,退款金额只要不大于消费金额都支持,但退款币种需和交易币种保持一致,具体可调用退款接口 (opens new window),完成退款交易

注意

退款原始交易ID -> 参数 reference_id

若发起的是SALE直接支付交易,reference_id应传支付那笔交易返回的payment_id

若发起的是AUTH预授权支付交易,reference_id应传确认预授权CAPTURE那笔交易返回的payment_id

# 查询

由于Pyvio对接不同的收单行和发卡行,每个系统的响应速度不可预知,所有的交易结果可能不能实时同步给商户,就需要商户根据自己的业务来进行主动查询,获取交易的最终状态,交易的类型没有限制,可对所有的交易进行查询,具体可参照接口交易查询接口 (opens new window),当然我们也会对交易的结果进行异步通知,及时的把交易的结果同步给商户,具体可参考异步通知模块

注意:

当交易发起时商户立马调用查询接口,这个时候Pyvio可能数据还在处理当中,并没有生成相应的交易订单,查询时候data返回的数据可能为空,这个时候不能以此数据作为交易的最终状态,判定交易的最终状态应该以data.status的状态为准,最好以支付接口同步响应回来之后调用查询接口。

# 3D认证支付

对于一些支付交易(支付/预授权支付)商户接入的过程中可以选择是否走3D认证确认持卡人身份,降低交易风险和拒付率。对于一些交易Pyvio系统风控可能判定为风险交易也可能转成3D认证支付,这个时候可能会跳转到发卡行或者收单行的3D认证页面,需要持卡人输入相应的认证信息来完成整个交易, 商户发起3D交易时需输入3D认证验证码 "1234"-验证成功 其他-验证失败

服务配置
错误码

← 服务配置 错误码→

© PYVIO Rights Reserved
  • 浅色模式
  • 阅读模式