@spritz-finance/api-client 0.4.28 → 0.5.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.
- package/README.md +36 -0
- package/dist/spritz-api-client.cjs +71 -85
- package/dist/spritz-api-client.d.ts +7677 -5333
- package/dist/spritz-api-client.mjs +72 -86
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -88,6 +88,9 @@ const transactionData = await client.paymentRequest.getWeb3PaymentParams({
|
|
|
88
88
|
- [Activation Steps](#activation-steps)
|
|
89
89
|
- [Virtual Accounts](#virtual-accounts)
|
|
90
90
|
- [Supported Tokens](#supported-tokens)
|
|
91
|
+
- [ACH Onramp (Direct Debit)](#ach-onramp-direct-debit)
|
|
92
|
+
- [Sandbox](#sandbox)
|
|
93
|
+
- [Bypassing KYC](#bypassing-kyc)
|
|
91
94
|
- [Webhooks](#webhooks)
|
|
92
95
|
- [Events](#events)
|
|
93
96
|
- [Setup](#setup)
|
|
@@ -812,6 +815,39 @@ const accounts = await client.virtualAccounts.list()
|
|
|
812
815
|
| Solana | USDC, PYUSD |
|
|
813
816
|
| Tron | USDT |
|
|
814
817
|
|
|
818
|
+
## ACH Onramp (Direct Debit)
|
|
819
|
+
|
|
820
|
+
ACH onramp lets users convert USD from their bank account into USDC delivered to a Solana wallet. The flow is:
|
|
821
|
+
|
|
822
|
+
1. **Link bank account** via Plaid → funding source created automatically
|
|
823
|
+
2. **Bind wallet** — user signs a message proving wallet ownership
|
|
824
|
+
3. **Create deposit** — user authorizes an ACH debit, USDC released to wallet
|
|
825
|
+
|
|
826
|
+
For a complete walkthrough with code examples, request/response schemas, and deposit lifecycle documentation, see the **[ACH Onramp Integration Guide](docs/ach-onramp-guide.md)**.
|
|
827
|
+
|
|
828
|
+
A standalone sandbox demo is available at `scripts/sandbox/ach-onramp.html` — open it in a browser to walk through the full flow interactively.
|
|
829
|
+
|
|
830
|
+
## Sandbox
|
|
831
|
+
|
|
832
|
+
Use `Environment.Sandbox` for development and testing. The sandbox environment is available at `https://sandbox.spritz.finance`.
|
|
833
|
+
|
|
834
|
+
### Bypassing KYC
|
|
835
|
+
|
|
836
|
+
In sandbox, you can skip identity verification to speed up testing:
|
|
837
|
+
|
|
838
|
+
```typescript
|
|
839
|
+
// Simulate successful US KYC verification
|
|
840
|
+
await client.sandbox.bypassKyc()
|
|
841
|
+
|
|
842
|
+
// Simulate KYC for a specific country
|
|
843
|
+
await client.sandbox.bypassKyc({ country: 'CA' })
|
|
844
|
+
|
|
845
|
+
// Simulate a failed KYC check
|
|
846
|
+
await client.sandbox.bypassKyc({ failed: true })
|
|
847
|
+
```
|
|
848
|
+
|
|
849
|
+
This endpoint returns 403 in production.
|
|
850
|
+
|
|
815
851
|
## Webhooks
|
|
816
852
|
|
|
817
853
|
### Events
|