@uqpay/cli 1.2.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +29 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -77,6 +77,35 @@ uqpay issuing card list
77
77
  uqpay payment intent list
78
78
  ```
79
79
 
80
+ Virtual Account applications are tracked separately from issued bank details:
81
+
82
+ ```bash
83
+ # Submit one application. Omit payment_method to evaluate LOCAL and SWIFT.
84
+ uqpay banking virtual-account create \
85
+ --idempotency-key va-application-001 \
86
+ -d country=SG -d currency=USD -d nickname=Collections
87
+
88
+ # List application summaries, then retrieve the complete current application.
89
+ uqpay banking virtual-account application list --page-num 1 --page-size 50
90
+ uqpay banking virtual-account application retrieve <application-id> -o json
91
+
92
+ # Existing command: list issued Virtual Account bank details, not applications.
93
+ uqpay banking virtual-account list --page-num 1 --page-size 50
94
+ ```
95
+
96
+ For connected accounts, add `--on-behalf-of <account-id>` to all three flows.
97
+ Reuse an idempotency key only for the same normalized Create request. Create
98
+ returns HTTP 200 application data; usable bank details arrive asynchronously.
99
+
100
+ Successful Gateway Create and Retrieve application data and each List summary
101
+ include required `account_id` and `direct_id` fields. `account_id` is the UUID of
102
+ the account that owns the application. `direct_id` is an ordinary string: `"0"`
103
+ for a main account and the main account ID for a connected account. The CLI does
104
+ not validate or transform either field; `-o json` preserves them as received.
105
+
106
+ The CLI does not parse or type webhook deliveries. Use a customer webhook
107
+ handler or an SDK verifier for that flow.
108
+
80
109
  Or inline without config file:
81
110
 
82
111
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@uqpay/cli",
3
- "version": "1.2.0",
3
+ "version": "2.0.0",
4
4
  "description": "UQPAY command-line tool for banking, issuing, and payment APIs",
5
5
  "bin": {
6
6
  "uqpay": "scripts/run.js"