Paused settlement (Escrow)

Hold funds in escrow until you release them. Useful for milestone payments, dispute resolution, or holding periods.

Hold funds in escrow before releasing them to your bank account. Useful for:

  • Service delivery confirmation
  • Milestone-based payments
  • Dispute resolution periods
  • Subscription trial periods

How it works

{
  "amount": 50000,
  "email": "customer@example.com",
  "currency": "NGN",
  "pauseSettlement": 1,
  "pauseSettlementDate": "2026-03-15"
}

Funds are held until March 15, 2026, then automatically released.

Fields

FieldTypeDescription
pauseSettlementnumber1 to pause, 0 to release immediately
pauseSettlementDatestringRelease date in YYYY-MM-DD format

Funds remain paused until the specified pauseSettlementDate is reached.

Settlement reporting

Download settlement reports for accounting and reconciliation:

  1. Go to ReportsSettlements
  2. Select date range
  3. Choose format (CSV, PDF, Excel)
  4. Download

Report includes:

  • Settlement reference
  • Transaction references
  • Gross amounts
  • Fees deducted
  • Net settlement amounts
  • Settlement dates

Pending settlements

In rare cases, settlement to your bank account may be delayed:

Common causes:

  • Bank account closed or frozen
  • Account name mismatch
  • Bank network issues
  • Public holidays or weekends

Resolution:

  1. Check your settlement account details in SettingsSettlement
  2. Update account if needed (may require re-verification)
  3. Contact support for settlements pending longer than expected

Pending settlements remain in queue until the issue is resolved. Funds are not returned to your Credo balance - they will be settled once the account details are corrected.

Best practices

  • Reconcile daily: Match your dashboard settlements with your bank account credits daily.
  • Monitor paused settlements: Track paused settlements approaching their release dates.
  • Use pre-configured splits: Prefer dashboard-managed splits over dynamic splits for easier auditing.
  • Keep account updated: Ensure your settlement account is always active and correct.

Next steps

Was this page helpful?

Last updated on

On this page