Skip to main content

通用说明

皮卡宝 API 为开发者提供了虚拟信用卡管理的完整接口。

请求地址

所有 API 请求的基础 URL:

认证方式

所有 API 请求都需要进行签名验证,详见签名规则部分。

签名规则

为确保API请求的安全性,所有请求都需要进行签名验证。

签名步骤

1

参数排序

将集合 M 内所有非空参数值按照参数名 ASCII 码从小到大排序(字典序)
2

构建字符串

使用 URL 键值对格式(key1=value1&key2=value2…)拼接,需要对参数值进行 URL encode
3

处理特殊字符

若 URL encode 后出现 ’+’ 字符,需要将 ’+’ 替换为 ‘%20’,得到字符串 stringA
4

生成签名

在 stringA 最后拼接 &key={secretKey},得到 stringSignTemp对 stringSignTemp 进行 MD5 运算,将结果转换为大写,得到 sign 值
secretKey 由平台提供,请联系客服人员获取

签名示例

响应代码

API 响应采用统一的格式,包含以下字段:

常见错误代码

参数错误
请求参数不正确或缺少必需参数
对象不存在
请求的资源不存在
余额不足
账户余额不足以完成操作
签名错误
签名验证失败,请检查签名算法和密钥

响应示例

成功响应:
错误响应:

通用参数

大多数 API 接口都需要以下通用参数:
时间戳与服务器时间相差超过 5 分钟的请求将被拒绝

开始使用

现在您已经了解了 API 的基本概念,可以开始使用以下接口:

用户信息

获取用户账户信息和余额

信用卡管理

查看和管理虚拟信用卡

开卡服务

创建新的虚拟信用卡

交易查询

查询信用卡交易记录