接口对接
# 接口对接
# 签名规约
为保障 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) | 交易结果查询接口 |