curl --location 'https://kf.pikabao.cc/agent/v1/cards/bins?appid=user123×tamp=1640995200000&sign=ABC123...'
const params = {
appid: "user123",
timestamp: Date.now().toString(),
};
const sign = generateSign(params, secretKey);
const response = await fetch(
`https://kf.pikabao.cc/agent/v1/cards/bins?${new URLSearchParams({...params, sign})}`
);
const bins = await response.json();
{
"code": 0,
"msg": "成功",
"content": [
{
"id": "240820174023000001",
"bin": "491090",
"cr": "美国",
"organization": "VISA",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 VISA 虚拟卡"
},
{
"id": "240820174023000002",
"bin": "554866",
"cr": "美国",
"organization": "MASTERCARD",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 MasterCard 虚拟卡"
}
]
}
用户与卡片
获取可用BIN
获取当前可用的信用卡 BIN(Bank Identification Number)列表及费率信息
GET
/
agent
/
v1
/
cards
/
bins
curl --location 'https://kf.pikabao.cc/agent/v1/cards/bins?appid=user123×tamp=1640995200000&sign=ABC123...'
const params = {
appid: "user123",
timestamp: Date.now().toString(),
};
const sign = generateSign(params, secretKey);
const response = await fetch(
`https://kf.pikabao.cc/agent/v1/cards/bins?${new URLSearchParams({...params, sign})}`
);
const bins = await response.json();
{
"code": 0,
"msg": "成功",
"content": [
{
"id": "240820174023000001",
"bin": "491090",
"cr": "美国",
"organization": "VISA",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 VISA 虚拟卡"
},
{
"id": "240820174023000002",
"bin": "554866",
"cr": "美国",
"organization": "MASTERCARD",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 MasterCard 虚拟卡"
}
]
}
请求参数
string
required
用户标识
string
required
当前时间戳(毫秒)
string
required
签名值
响应
integer
响应代码
string
响应消息
array
curl --location 'https://kf.pikabao.cc/agent/v1/cards/bins?appid=user123×tamp=1640995200000&sign=ABC123...'
const params = {
appid: "user123",
timestamp: Date.now().toString(),
};
const sign = generateSign(params, secretKey);
const response = await fetch(
`https://kf.pikabao.cc/agent/v1/cards/bins?${new URLSearchParams({...params, sign})}`
);
const bins = await response.json();
{
"code": 0,
"msg": "成功",
"content": [
{
"id": "240820174023000001",
"bin": "491090",
"cr": "美国",
"organization": "VISA",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 VISA 虚拟卡"
},
{
"id": "240820174023000002",
"bin": "554866",
"cr": "美国",
"organization": "MASTERCARD",
"actualOpenCardPrice": "2.00",
"actualRechargeFeeRate": "3.00%",
"enable": true,
"description": "美国 MasterCard 虚拟卡"
}
]
}
使用说明
开卡前建议先调用此接口获取可用的 BIN 列表和费率信息,然后选择合适的 BIN 进行开卡
费率计算示例
如果选择 BIN491090:
- 开卡费:$2.00
- 充值 100,手续费:100 × 3% = $3.00
- 实际扣费:100+3.00 + 2.00=105.00
⌘I
