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.

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

Response

Account approved