WoyraDocs
Get an API key

Request a birr bank deposit

POST/v1/billing/bank_deposits

Billing · Requires an API key

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

FieldTypeDescription
amount_microsrequiredintegerBirr 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.

FieldTypeDescription
idstring
object"bank_deposit"
account_idstring
amount_microsinteger
currency"ETB"
etb_per_usd_microsinteger
credit_microsinteger
credit_currency"USD"
bank_namestring
bank_account_namestring
bank_account_numberstring
statusstring
One of awaiting_receipt, awaiting_approval, approved, rejected, cancelled.
review_reasonstring
created_attimestamp
updated_attimestamp
reviewed_attimestamp

Errors

StatusCodes
400invalid_request, unsupported_version

Also in Billing