> ## Documentation Index
> Fetch the complete documentation index at: https://developer.speedpay.hk/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 完成 Open API 接入的最短路径。

## 接入步骤

1. 向平台申请商户号、应用 ID、API Key、签名密钥和回调配置。
2. 在测试环境完成请求签名、验签、加密解密和幂等处理。
3. 调用枚举值查询接口，缓存国家、职业、用途、财富来源等枚举值。
4. 按业务需要接入 Visa 或 JCB 的申请、激活、查询、交易等接口。
5. 配置并联调 Webhook，确保申请结果、卡状态、交易通知能被正确处理。
6. 按上线指南提交生产环境配置并完成生产验证。

## 推荐接入顺序

| 阶段    | 接口                           |
| ----- | ---------------------------- |
| 基础联调  | 枚举值查询、签名验签、通用响应处理            |
| 开卡流程  | 申请提交、激活、卡信息查询                |
| 卡管理   | 锁卡/解锁、密码修改、单笔消费限额设置、单笔消费限额查询 |
| 资金与交易 | Visa 充值、交易查询、JCB 钱包地址、钱包充值记录 |
| 通知闭环  | Visa 回调、JCB 回调               |

## 调用示例

测试环境 host：`https://test.speedpay.hk`

生产环境 host：`https://speedpay.hk`

```bash theme={null}
curl -X POST "https://test.speedpay.hk/mc-platformapi/v1/open/et/vs/card/info/query" \
  -H "Content-Type: application/json" \
  -H "Authorization: BASE64_SIGNATURE" \
  -d '{
    "app_id": "app_123456",
    "timestamp": 1784880000,
    "card_no": "493875******0990"
  }'
```

示例中的签名字段仅用于展示。实际签名值为完整 JSON 请求体经 `SHA256withRSA` 签名后再 `BASE64` 编码得到的字符串。