Funding
Deposits and withdrawals move cash between the investor's bank and their settled balance. POST /v1/transfers is a signed money endpoint.
bash
curl -X POST https://sandbox.boursa.sh/v1/transfers \
-H "Authorization: Bearer $KEY" -H "Idempotency-Key: $(uuidgen)" \
-H "X-Boursa-Timestamp: $TS" -H "X-Boursa-Signature: $SIG" \
-d '{"investor_id":"inv_…","direction":"deposit","amount_micros":50000000000}'
# → {"transfer_id":"…","state":"…"}| Field | Notes |
|---|---|
direction | deposit or withdrawal. |
amount_micros | Integer micros. |
Limits: 70,000 EGP per transfer, 200,000 EGP per day.
Lifecycle
received → pending_rail → at_broker → completed (or failed). A deposit lands in the settled balance once complete; a withdrawal holds the amount, then releases it to the bank — or releases the hold back on failure.
GET /v1/transfers?investor_id=… lists transfers; GET /v1/transfers/{id} is the single view.
Sandbox magic value
A transfer of exactly EGP 666 fails on the payment rail (the withdrawal hold is released) — useful for demonstrating the failure path.