Skip to content
Wajub
Loading keys…

Authorization

default
Authorization<token>

A public key (pk./pk_test.) is accepted on /payments, /customers, /links, /invoices and the catalogue reads (/channels, /providers, /countries, /currencies); anything that moves money out, reads the balance or manages the account answers 406 to it. It is an identifier, never an authorization. Use a secret key (sk./sk_test.) for sensitive operations (transfers, refunds, balance), or a restricted key (rk./rk_test.) scoped to specific permissions. The _test. variant of any key selects the sandbox environment, there is no separate sandbox URL. Never expose your secret key in client-side code.

In: header

Path Parameters

idstringrequired

The subaccount `id`.

Request Body

application/json

capabilitiesarray<string>

The new set of capabilities. Proposed to the merchant once they have accepted the connection.

pricingobject | null

Your fee on the account's activity: `percentage_fee`, `fixed_fee`, `min_fee`, `max_fee`, `currency`.

percentage_feenumber | null

Percentage the platform retains (0–100). Proposed to the merchant once they have accepted the connection.

fixed_feenumber | null

Flat fee per operation (major unit).

max_feenumber | null

Cap on the computed fee.

min_feenumber | null

Floor on the computed fee.

currencystring | null

Currency for the fee figures, required if any of fixed_fee/min_fee/max_fee is set.

callbackstring | null

The page the merchant is sent back to once they have accepted the connection. HTTPS only; `http://localhost` and `http://127.0.0.1` are accepted with a sandbox key.

emailstring | null

The merchant's address, where the invitation reminder is sent. Kept in `profile.email`; `null` removes it.

metadataobject | null

Merged into the connection's metadata; a key sent as `null` is removed.

payment_status"active" | "suspended"

`active` or `suspended`: your own switch on the connection's payments. `active` cannot lift a suspension Wajub applied because the merchant's verification is pending or was rejected.

"active""suspended"
commission_refund_policy"prorata" | "full" | "none"

`prorata`, `full` or `none`. Only while the connection is pending.

"prorata""full""none"
payout_schedule"manual" | "daily" | "weekly" | "monthly"

`manual`, `daily`, `weekly` or `monthly`. Lite accounts only.

"manual""daily""weekly""monthly"
payout_min_amountnumber | null

Do not pay out below this, in the merchant's own currency. Lite accounts only.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://api.wajub.com/accounts/acc_Gt6yU3nE8rM1kS5vX9bQ" \  -H "Content-Type: application/json" \  -d '{}'
PUT
/accounts/{id}
{  "code": 200,  "account": {    "id": "acc_Gt6yU3nE8rM1kS5vX9bQ"  },  "status": "OK",  "message": "Account updated"}

OK

What did you think of this content?