跳转到主要内容

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.

卡片可以交易之前，你的发卡账户余额必须有充足资金。资金流向取决于卡模式：
  • Share mode —— 交易直接从发卡账户余额扣款。卡片的 card_limit 作为消费上限。
  • Single mode —— 创建卡片时，资金从发卡账户余额转入卡片。卡片使用自己独立的预付余额。

​
为发卡账户余额充值

在 Dashboard 中，把资金从你的银行账户充值到发卡账户余额。
  1. 登录 Dashboard，选择 Card Issuance。
funding your issuing balance 1
  1. 点击 Deposit 按钮。
funding your issuing balance 2
  1. 选择币种（USD 或 SGD），输入金额。
  2. 点击 Transfer 执行。
funding your issuing balance 3

​
主账户与子账户之间的转账

如果你使用了子账户，可以在主发卡账户和子账户之间转账。 通过 API： 使用 Create Issuing Transfer 接口： 
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/transfers \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{
    "source_account_id": "main-account-uuid",
    "destination_account_id": "sub-account-uuid",
    "amount": 5000,
    "currency": "USD"
  }'
  1. 进入 Transfer 页面。
  2. 点击右上角的 New transfer。
  3. 填写源账户、目标账户和币种。
  4. 点击 Create。
funding your issuing balance 3 2funding your issuing balance 4

​
查询发卡账户余额

使用 Retrieve Issuing Balance 或 List Issuing Balances 接口查询当前余额。 
curl "https://api-sandbox.uqpaytech.com/api/v1/issuing/balances?page_number=1&page_size=10" \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json"

​
管理卡级余额

​
卡片充值

使用 Card Recharge 接口为卡片充值。
  • Single mode：把资金从发卡账户余额转入卡片。
  • Share mode：增加 card_available_balance，但不实际转移资金。
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{card_id}/recharge \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500}'
完成后会触发一次 card.recharge.succeeded webhook。

​
从卡片提现

使用 Card Withdraw 接口从卡片提现。
  • Single mode：把资金从卡片退回发卡账户余额。
  • Share mode：减少 card_available_balance。
curl -X POST https://api-sandbox.uqpaytech.com/api/v1/issuing/cards/{card_id}/withdraw \
  -H "x-auth-token: YOUR_API_TOKEN" \
  -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
  -H "Content-Type: application/json" \
  -d '{"amount": 200}'
完成后会触发一次 card.withdraw.succeeded webhook。