Skip to main content

Command structure

All commands follow the pattern:
uqpay <domain> <resource> <action> [flags]

Domains

DomainResources
bankingBalances, transfers, deposits, payouts, beneficiaries, conversions, virtual accounts
issuingCards, cardholders, transactions, spending controls, reports
paymentIntents, attempts, refunds, settlements, bank accounts
connectConnected accounts, sub-account onboarding, KYC uploads
simulateSandbox testing — deposits, authorizations, reversals
fileDocument uploads and retrieval links

Quick aliases

Common resources have top-level shortcuts so you can skip the domain name:
AliasEquivalent
uqpay beneficiary listuqpay banking beneficiary list
uqpay card listuqpay issuing card list
uqpay payout listuqpay banking payout list

Read operations

Use flags to pass query parameters:
uqpay banking beneficiary list --page-num 2 --page-size 20

Write operations

Use -d key=value to pass request body fields. Dot notation creates nested objects:
uqpay banking beneficiary create \
  -d entity_type=INDIVIDUAL \
  -d first_name=John \
  -d bank_details.swift_code=DBSSSGSG
Values default to strings with automatic number conversion per the API spec. You can pass -d amount=100 without worrying about type declarations.

File encoding

Base64 encoding

Prefix the file path with @ to base64-encode a local file:
-d identity.front_file=@./passport.jpg

Data URI format

For Connect document uploads, use @+ to encode as a data URI:
-d "certification[0]=@+./cert.png"