Fund accounts with cash.
Let users add funds in cash at a nationwide retail network, credited to their CFX balance once the deposit clears.
POST/ v1/ deposit/ cash
HTTP
x-api-key: $CFX_API_KEY
x-api-secret: $CFX_API_SECRET
Content-Type: application/json
{
"identityId": "id_VfsdSMtd8UdgxCgTnz0tm",
"user": { "firstName": "Robert", "lastName": "Smith", "zipcode": "60601" },
"amount": { "amount": 300, "currency": "USD" },
"amountOut": { "amount": 300, "currency": "MOVEUSD" },
"reference": "CD-558210",
"retailerId": "10831"
}Result
Created
- Amount
- $300.00 USD
- Retailer
- Walgreens
- Barcode
- 8303 … 8375
- Reference
- CD-558210
The user pays at the retailer; funds post once it clears.
Reach cash-first users.
For users who pay in cash, CFX accepts deposits across a nationwide retail network and credits the balance once the deposit clears, with the same screening as every other rail.
- Nationwide retail network
- Credited once the deposit clears
- Same screening as every rail
- Reach the under-banked
What your team sees in CFX.
Cash dropped at the counter posts to the right account with the location attached: reconciled, not a mystery deposit.
Cash deposits
| Date | To / From | Amount | Method |
|---|---|---|---|
Downtown · 5th Ave | $1,800.00 | ||
Westgate Mall | $925.00 | ||
Harborview BranchPending | $2,340.00 |
Deposit locations
Downtown · 5th AveOnline
Westgate MallOnline
Harborview BranchPosting
Deposit posted · $1,800.00just now
How it moves.
Initiated
Generate a deposit reference for the user to present at a retail location.
Deposited
The user pays in cash at any participating store in the network.
Credited
Funds post to the CFX balance once the deposit clears.
In the API.
- Create
- POST /v1/deposit/cashReturns the barcode and reference the user shows at the store.
- Test
- POST /v1/deposit/cash/simulate/{id}/scanSimulate the in-store scan outside production, no store visit needed.
- Status
- deposit.cashRequest.statusUpdatedA webhook at each change, through to credited.
Ready to build on regulated U.S. banking rails?
Sign up, spin up a sandbox, and make your first cash-deposit call the same day.