跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://developers-sandbox.uqpaytech.com/llms.txt

Use this file to discover all available pages before exploring further.

命令结构

所有命令遵循统一结构:
uqpay <domain> <resource> <action> [flags]

业务域

业务域资源
banking余额、转账、充值、出款、受益人、换汇、虚拟账户
issuing卡片、持卡人、交易、消费控制、报表
paymentIntent、Attempt、退款、结算、银行账户
connectConnected 账户、子账户入驻、KYC 上传
simulate沙盒测试——充值、授权、冲正
file文档上传与下载链接

快捷别名

常用资源有顶层快捷方式,可以跳过业务域名:
别名等价写法
uqpay beneficiary listuqpay banking beneficiary list
uqpay card listuqpay issuing card list
uqpay payout listuqpay banking payout list

读操作

通过 flag 传入查询参数:
uqpay banking beneficiary list --page-num 2 --page-size 20

写操作

使用 -d key=value 传入请求体字段。点号记法可以构造嵌套对象:
uqpay banking beneficiary create \
  -d entity_type=INDIVIDUAL \
  -d first_name=John \
  -d bank_details.swift_code=DBSSSGSG
字段默认以字符串类型传入,CLI 会按 API spec 自动转换数值类型。可以直接写 -d amount=100,无需声明类型。

文件编码

Base64 编码

在文件路径前加 @ 前缀,将本地文件 base64 编码后上传:
-d identity.front_file=@./passport.jpg

Data URI 格式

Connect 文档上传使用 @+ 前缀,将文件编码为 data URI:
-d "certification[0]=@+./cert.png"