Request a birr bank deposit
POST/v1/billing/bank_deposits
Returns the receiving bank account and the USD credit the deposit will earn. Pay the exact amount at the bank, then upload the receipt. One deposit may be open at a time.
Body
| Field | Type | Description |
|---|---|---|
| amount_microsrequired | integer | Birr to deposit |
Example
curl -X POST https://api.woyra.io/v1/billing/bank_deposits \
-H "Authorization: Bearer $WOYRA_KEY" \
-H 'Content-Type: application/json' \
-d '{
"amount_micros": 1
}'Response
201 The deposit request.
| Field | Type | Description |
|---|---|---|
| id | string | |
| object | "bank_deposit" | |
| account_id | string | |
| amount_micros | integer | |
| currency | "ETB" | |
| etb_per_usd_micros | integer | |
| credit_micros | integer | |
| credit_currency | "USD" | |
| bank_name | string | |
| bank_account_name | string | |
| bank_account_number | string | |
| status | string | One of awaiting_receipt, awaiting_approval, approved, rejected, cancelled. |
| review_reason | string | |
| created_at | timestamp | |
| updated_at | timestamp | |
| reviewed_at | timestamp |
Errors
| Status | Codes |
|---|---|
| 400 | invalid_request, unsupported_version |
Also in Billing
- POST /v1/topups — Add funds by card
- GET /v1/topups/{id} — One top-up
- POST /v1/subscriptions — Start a product subscription
- GET /v1/subscriptions/{product} — Current product subscription
- POST /v1/payments/stripe/webhook — Stripe's webhook
- GET /v1/ledger — The account statement
- GET /v1/billing/payment_options — How this account can pay
- PUT /v1/billing/payment_currency — Choose to pay in birr or in US dollars
- GET /v1/billing/bank_deposits — Recent birr bank deposits
- POST /v1/billing/bank_deposits/{id}/receipt — Upload the bank receipt for a deposit
- POST /v1/billing/bank_deposits/{id}/cancel — Cancel a deposit that has not been submitted or was returned
- GET /v1/balance — Retrieve account balance
- GET /v1/billing/email_tariff — The email price this account pays
- GET /v1/billing/email_subscription — This account's monthly email plan
- PUT /v1/billing/email_subscription — Take an email plan, or change it
- POST /v1/billing/email_subscription/cancel — Stop the email plan renewing
- GET /v1/pricing/email — The published email tariff