Prerequisites
Before you begin, make sure you have:
- A Rolla business account at app.rolla.xyz
- An API key from your dashboard (Settings → API Keys)
- NGN balance in your wallet for payouts
Step 1: Get Your API Key
Navigate to API Keys
Click Settings in the sidebar, then select API Keys.
Create a new key
Click Create API Key, give it a name, and copy the key. Store it securely—you won’t be able to see it again.
Keep your API key secret. Never expose it in frontend code or public repositories.
Step 2: Test Your API Key
Make a simple request to list available banks:
curl -X GET "https://api.rolla.xyz/api/v1/external/banks" \
-H "X-API-Key: your_api_key_here"
{
"status": true,
"message": "Banks retrieved successfully",
"data": {
"data": [
{ "bankName": "Access Bank", "bankCode": "000014" },
{ "bankName": "GTBank", "bankCode": "000013" }
]
}
}
Step 3: Validate an Account
Before sending a payout, validate the recipient’s account:
curl -X POST "https://api.rolla.xyz/api/v1/external/lookup" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"bankCode": "000014",
"accountNumber": "0123456789"
}'
Step 4: Send Your First Payout
With validated account details, initiate a payout:
curl -X POST "https://api.rolla.xyz/api/v1/external/payouts" \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"amount": 1000,
"currency": "NGN",
"beneficiary": {
"accountName": "JOHN DOE",
"accountNumber": "0123456789",
"bankName": "Access Bank",
"bankCode": "000014"
},
"remark": "Test payout",
"externalReference": "test-001"
}'
The amount is in Naira (1000 = ₦1,000). Fees are automatically deducted from your balance.
Next Steps
