Brick API Documentation
Dashboard

Bulk Transfer

Use Cases

  1. Payroll distribution
    Send monthly salaries to many employees in one batch upload (one file → many transfers), with per-employee status tracking and downloadable reports for reconciliation.

  2. Vendor payments
    Pay multiple suppliers/partners on the same cycle (weekly/monthly) using a single batch, reducing manual bank transfers and ensuring consistent payment records.

  3. Cashback / incentives
    Distribute cashback, promotions, referral rewards, or campaign incentives to large customer lists, with unique reference IDs for audit and tracking.

  4. Loan disbursement
    Disburse loans to multiple borrowers at once (e.g., daily approvals), with clear success/failed status per borrower and retry via failed-only re-upload.

  5. Mass payouts
    Handle high-volume payouts such as creator payouts, gig-worker payouts, refunds, claims, or tournament rewards—processed asynchronously with callback updates and exportable reports.



User Guideline

Step 1 - Batch Creation

  1. User navigates to Disbursement → Bulk Disbursement

Brick Dashboard bulk transfer workflow

  1. Fill batch details using a CSV/XLSX bulk transfer file. Use one row per transfer and include the required destination and transfer details:
FieldDescription
referenceIdUnique transfer reference for reconciliation.
amountTransfer amount.
bankShortCodeDestination bank or payment shortcode. See Disbursement Coverage.
bankAccountNoRecipient destination account number.
bankAccountHolderNameRecipient account holder name.

Brick Dashboard bulk transfer workflow

Brick Dashboard bulk transfer workflow


  1. Upload bulk file (CSV/XLSX)
  2. System saves batch as Draft.

Step 2 - File Validation

After file upload, system performs:

Brick Dashboard bulk transfer workflow

A. Format Validation
• Required columns check
• File structure validation

Brick Dashboard bulk transfer workflow

B. Data Validation
• Mandatory fields
• Duplicate reference check
• Amount > 0
• Bank code validity
• Account number format

C. Balance Check
• Sufficient wallet balance

D. (Optional) Account Validation
• Bank Account Verification (BAV)

Result:

Brick Dashboard bulk transfer workflow

If failed → Batch remains Draft


Brick Dashboard bulk transfer workflow

If passed → Status becomes Validated


Step 3 - Confirmation

Brick Dashboard bulk transfer workflow


  1. User reviews:
  • Total records
  • Valid / failed records
  • Total amount
  1. Click Confirm

Step 4 - Processing

Brick Dashboard bulk transfer workflow

If Maker–Checker enabled: Status → Waiting for Approval (Transfer Request Sent)


Brick Dashboard bulk transfer workflow

If no approval required: Status → Approved (Transfer being Processed)

Last modified on