接口对接
# 接口对接
# 签名规约
为保障 Pyvio Open API 开放平台和商户交互时的数据的完整性及安全性,我们采用加签的方式进行数据校验,具体签名算法规则见下链接 (opens new window)
# 请求头 HTTP header
demo:
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRJZCI6IkNUMjIxMTA3MTY0MDAxNDciLCJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2ODEyMTQ5NjIxOTYsImFwcElkIjoiMTY0MzE0OTU5NTYyOTg1MjQxNiIsInVuaXRJZCI6IlVUMjIxMTIyMTY0MDAxODMiLCJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJvcmdDbGllbnRJZCI6IkNUMjIxMTA3MTY0MDAxNDciLCJvcmdVbml0SWQiOiJVVDIyMTEyMjE2NDAwMTgzIn0.vSN0w2\_ljYXVFMQYGKnC3te7dvkjxBtSW3V1t5eu-LE' \
--header 'Sign: Orrgl4WvDltn0servrMGeqjr3hZQ6r6T3YYSBxm4rnD/pM0WlmQn6AejPGovraTUBzXL5bfz58f0GoORFJbH8OotwYyg0/EWqJjSZ+YditJLcYCAImi/6VgzusiH4p5bc3w0OlHgmkCiU5qarf3aTG6bHdcd/2hryiiMPzkmcjc=' \
--header 'X-Timestamp: 1681204490980' \
--header 'Request-Id: 879ee5aa-1a30-408d-ba85-e98eca0b027a' \
--header 'Content-Type: application/json' \
Authorization:通过接口获取TOKEN (opens new window),并填充到后面所有请求header头里
Sign:对请求参数进行签名处理,生成的签名 (opens new window)填充到当前请求的 header头里
X-Timestamp:当前请求的时间戳
Request-Id:请求编号可自定义
Content-Type:内容类型相对固定一般填写application/json,特殊接口会在文档告知内容类型Content-Type的填充值
# 环境常用参数
Pyvio 服务环境地址
环境 | 地址 |
---|---|
沙箱环境 | https://sandbox-api.pyvio.com |
正式环境 | https://api.pyvio.com |
沙箱环境测试参数
支付交易(SALE/AUTH)状态 | 交易卡号 |
---|---|
SUCCESS | 4000000000001018,4000000000001026,5200000000001021 |
FAILED | 4000000000001034,4000000000001059,5200000000001047 |
PENDING | 4000000000001000,4000000000001091,5200000000001005 |
3D | 42000000000000003,4200000000000004,5200000000001048 |
PENDING(人工审核) | 4598011210311392 |
非支付交易(CAPTURE/VOID/REFUND)状态 | 交易金额区间 |
---|---|
SUCCESS | [100,1001) |
FAILED | [1001,+∞) |
PENDING | [0,100) |
商户发起3D交易时需输入3D认证验证码 "1234"-验证成功 其他-验证失败
# 接口文档
接口名称 | 描述 | 备注 |
---|---|---|
Cashier Checkout (opens new window) | 收银台页面检出 | 收银台模式需要对接, 商户发起3D交易时需输入3D认证验证码 "1234"-验证成功 其他-验证失败 |
S2S Pay (opens new window) | 支付接口 | S2S模式需要对接的支付接口, 商户发起3D交易时需输入3D认证验证码 "1234"-验证成功 其他-验证失败 |
Refund (opens new window) | 退款接口 | SALE模式交易时,退款原始交易为SALE模式支付接口返回的payment_id;AUTH模式交易时,退款原始交易为 CAPTURE 确认支付接口返回的payment_id |
Capture (opens new window) | 预授权确认接口 | |
Void (opens new window) | 预授权取消接口 | |
Order Query (opens new window) | 交易结果查询接口 |