Skip to main content
POST
Approve Account (Sandbox)
Self-approves a submitted account so you can test the entire onboarding-to-payout journey end to end without waiting for Rolla’s manual compliance review.
Sandbox / testing only. This endpoint does not exist in production — calls to the production API return 404 Not Found. In production, accounts are approved by Rolla’s compliance team.
It runs the same approval path as the Rolla admin dashboard, so wallets are provisioned and the account.approved webhook fires — exactly as a real approval would.

Prerequisites

The account must already be submitted — which is only possible once every onboarding requirement is complete (see Submit Application). If it isn’t, the call returns 409 with code ACCOUNT_NOT_SUBMITTED:
The submission gate is re-run at approval time. If the account would no longer pass it, the call returns 400 whose message names the blocking requirement, the same message Submit Application reports.

Example Request

Example Response

What happens

  1. The account’s application status moves from submitted to approved.
  2. Wallets are provisioned and the account.approved outbound webhook is delivered to your endpoint.
  3. You can now issue bank accounts (NGN/USD), fund them, and initiate payouts for the account.
Calling this on an already-approved account is a no-op and returns applicationStatus: "approved" with alreadyApproved: true.
Full sandbox test loop: create account → complete details + KYC → submit → approve (this endpoint) → issue USD/NGN account → simulate a deposit → initiate a payout.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Path Parameters

accountId
string<uuid>
required

Identifier of a submitted account owned by the same user as your API key's business

Example:

"eec3cbed-79d8-4370-87a0-b6be9e287337"

Response

Account approved (or already approved, in which case alreadyApproved: true is included)

status
integer
required
Example:

200

message
string
required
Example:

"Account approved"

success
boolean
required
Example:

true

data
object
required