Skip to main content
Payments are the core functionality of Pooler. This guide provides an overview of how payments work, the payment process, and key concepts you need to understand.

​
What are Payments?

Payments in Pooler are transfers of funds from your account to recipient bank accounts. Pooler handles the complexity of routing payments through various payment networks, currency conversions, and compliance requirements.

​
Payment Types

​
Local Payments

Payments within the same country:
  • NIP (Nigeria) - Instant bank transfers in Nigeria
  • Local Bank Transfers - Standard bank transfers within country
  • Mobile Money - Mobile money transfers (where supported)

​
Cross-Border Payments

Payments between different countries:
  • SWIFT - International wire transfers
  • Regional Networks - Regional payment networks
  • Corridor-Specific - Optimized routes for specific corridors

​
Payment Process

​
Two-Step Payment Flow

Pooler uses a two-step payment process for transparency and control:
1

Initiate Payment

Create a payment quote with fees and exchange rates.
2

Review Quote

Review the quote including:
  • Payment amount
  • Fees
  • Exchange rates (if applicable)
  • Total amount to deduct
3

Confirm Payment

Confirm the payment to execute the transfer.
4

Processing

Pooler processes the payment through selected route.
5

Completion

Payment is completed and recipient receives funds.

​
Payment States

​
Payment Statuses

Payments progress through various states:

​
Key Concepts

​
Payment Amounts

​
Payment Routes

Pooler selects optimal payment routes based on:
  • Destination - Recipient country and bank
  • Currency - Source and destination currencies
  • Amount - Payment amount
  • Speed - Processing time requirements
  • Cost - Route fees and exchange rates
See Route Management for details on how routes are selected and optimized.

​
Currency Conversion

When sending payments in different currencies:
  • Exchange Rates - Real-time or quoted rates
  • Conversion Fees - Fees for currency conversion
  • Rate Lock - Quotes may lock rates for a period
See Conversion Rates for details on exchange rates and conversions.

​
Fees

Payments may include various fees:
See Transaction Fees for a detailed breakdown of fees.

​
Payment Features

​
Idempotency

Use idempotency keys to prevent duplicate payments:

​
Payment References

Provide custom references for tracking:

​
Payment Limits

Payments are subject to limits:
Contact support to adjust limits based on your needs.

​
Best Practices

  • Always review payment quotes before confirming to understand fees and rates.
  • Always use idempotency keys to prevent duplicate payments.
  • Store payment references and IDs for tracking and reconciliation.
  • Set up webhooks to monitor payment status in real-time.
  • Implement proper error handling for failed payments.