The complete journey has 4 main phases: Onboarding, Transaction
Initiation, Payment & Processing, and Post-Transaction.
Phase 1: Sender Onboarding & Authentication
1.1 Sender Registration
The registration process creates a new sender account with required personal information.Sender Registration
Go to create customer endpoint.
Sender Experience Flow
1.2 Sender Login & Authentication
Secure authentication using email and password with JWT token management.Sender Login
Go to login endpoint.
1.3 KYC Verification
Know Your Customer (KYC) verification is required before sender’s can make transactions.- Tier 1 - Basic KYC
- Tier 2 - Enhanced KYC
Required Documents
- Government-issued ID: Passport, driver’s license, or national ID card
- Selfie: For liveness check and face matching
Verification Process
- Automated OCR extracts data from ID document
- Face matching compares selfie with ID photo
- Basic sanctions screening against global watchlists
- Identity verification through third-party services
KYC Decision Flow
1.4 Customer Risk Assessment (CRA)
CRA forms are optional forms for collecting additional user information for regulatory compliance and risk assessment.API Endpoint
Go to CRA form endpoint.
When CRA Forms Are Required
First Transaction
Required when transaction amount exceeds limit set for the first time.
High-Risk Corridors
Transactions to countries with enhanced due diligence requirements.
Periodic Reviews
Annual or biennial reviews for active customers.
Regulatory Changes
When new regulations require additional information.
Typical CRA Questions
Source of Funds
Source of Funds
Question: Where does the money you’re sending come from?Options:
- Employment/Salary
- Business income
- Savings
- Gift
- Inheritance
- Investment returns
- Other (specify)
Purpose of Transfer
Purpose of Transfer
Question: What is the purpose of this transfer?Options:
- Family support
- Education fees
- Medical expenses
- Business payment
- Property purchase
- Investment
- Gift
- Other (specify)
Beneficiary Relationship
Beneficiary Relationship
Question: What is your relationship to the beneficiary?Options:
- Family member (parent, sibling, spouse, child)
- Friend
- Business partner
- Employee
- Myself
- Other (specify)
Transaction Frequency
Transaction Frequency
Question: How often do you plan to send money?Options:
- One-time only
- Monthly
- Quarterly
- As needed
- Weekly
Employment Details
Employment Details
Question: What is your occupation and employer?Fields:
- Occupation/Job title
- Employer name
- Industry sector
Phase 2: Transaction Initiation
2.1 Dashboard & Send Money
The dashboard is the central hub for all remittance activities.Dashboard Features
Quick Send
One-tap access to start a new transaction.
Recent Activity
Last 5 transactions with status indicators.
KYC Status
Current verification tier and limits.
Saved Beneficiaries
Quick access to frequent recipients.
Transaction Limits
Remaining daily/monthly limits.
Exchange Rates
Live rates for popular corridors.
2.2 Transaction Type Selection
Senders choose from three or more primary transaction types based on beneficiary preferences.- Bank Transfer
- Mobile Money
- Cash Pickup
Overview
Direct deposit into beneficiary’s bank account using SWIFT or local banking rails.Sender Flow
- Sender selects “Bank Transfer” option
- Choose destination country from list
- Enter transfer amount
- Get instant quote with FX rate
Required Information
- Account number or IBAN
- SWIFT/BIC code (for international transfers)
- Beneficiary full name (must match bank records)
- Dynamic form details (if required & set by the backend)
Settlement Time
InstantBest For
- Large transfer amounts
- Regular recipients with bank accounts
- Countries with strong banking infrastructure
Transaction Types
Go to transaction types endpoint.
2.3 FX Quotation Flow
Real-time exchange rate quotation with rate locking mechanism.API Endpoint
Go to transaction quote endpoint.
2.4 Beneficiary Management
Senders can save and manage beneficiaries for faster repeat transactions. API Endpoints:Beneficiary List
View all saved beneficiaries endpoint.
Create Beneficiary
Create beneficiary endpoint.
Create New Beneficiary Flow
Beneficiary Validation Rules
- Bank Transfer
- Mobile Money
- Cash Pickup
Validation Checks
- Bank name: Must exist in destination country
- Account number: Format validation (e.g., 10 digits for Nigerian accounts)
- SWIFT/BIC code: Valid code from SWIFT registry
- IBAN: Checksum validation for IBAN countries
- Beneficiary name: Minimum 3 characters, maximum 100 characters
Example: UK Bank
Example: Nigerian Bank
Phase 3: Payment & Processing
3.1 Transaction Review
Before payment, senders review all transaction details for accuracy.Review Screen Components
Send Details
Send Details
- Send amount: Amount sender is sending
- Send currency: Source currency (GBP, USD, EUR)
- Exchange rate: FX rate
- Rate validity: Countdown timer (10 minutes)
Fees & Total
Fees & Total
- Transfer fee: Platform fee
- Payment method fee: Card fee if applicable
- Total to pay: Final amount to be charged
- Fee breakdown:
- Transfer fee
- Payment method fee
- Exchange rate margin
- Other fees (if any)
Receive Details
Receive Details
- Receive amount: Amount beneficiary gets
- Receive currency: Destination currency
- Delivery method: Bank/Mobile/Cash
- Estimated delivery: Time to complete
Beneficiary Info
Beneficiary Info
- Recipient name: Full name
- Delivery details: Account/phone number
- Destination country: Country flag and name
- Transaction type: Visual indicator
3.2 Payment Processing
Secure payment through card or open banking with 3D Secure authentication.Payment Integration Guide
View detailed integration steps for Card and Open Banking payments.
3.3 Compliance Screening
All transactions undergo automated compliance checks before processing.Screening Checks Performed
- AML/CFT Checks
- Sanctions Screening
- PEP Screening
- Risk Scoring
Anti-Money Laundering & Counter-Terrorism Financing
Transaction Pattern Analysis:- Unusual transaction amounts
- Frequency of transfers
- Multiple small transactions (structuring)
- Sudden changes in behavior
- Round-number transactions
- Daily transaction count
- Weekly transaction volume
- Monthly cumulative amount
- Same-day repeat transactions
- Customer transaction history
- Failed transaction attempts
- Previous flagged transactions
- Account age vs. transaction size
Compliance Decision Matrix
3.4 FX Conversion & Settlement
Once compliance checks pass, the system converts currency and initiates payout.Settlement Times by Method
| Payout Method | Typical Time | Fastest | Latest | Availability |
|---|---|---|---|---|
| Bank Transfer | Instant | Instant | 30secs | 24/7 |
| Mobile Money | Instant | Instant | 1 hour | 24/7 |
| Cash Pickup | Instant | Instant | N/A | Agent hours |
Phase 4: Post-Transaction
4.1 Status Tracking
Transactions move through defined states from creation to completion.Transaction History
Go to transaction history endpoint.
Transaction Status Definitions
WAITING_TO_PAY
WAITING_TO_PAY
Description: Transaction created but payment not yet receivedSender Actions:
- Complete payment via card or open banking
- Cancel transaction
VERIFYING- Payment receivedCANCELLED- Sender cancelledEXPIRED- Quote/payment timeout
VERIFYING
VERIFYING
Description: Payment received, undergoing compliance checksSystem Actions:
- AML/CFT screening
- Sanctions checking
- Risk assessment
- PEP screening (if applicable)
PAID- All checks passedPENDING_REFUND- Compliance rejectedFAILED_TO_DELIVER- Delivery issues
PAID
PAID
Description: Transaction completed successfully, funds deliveredSystem Actions:
- FX conversion executed
- Funds disbursed to beneficiary
- Confirmations sent
- Email receipt to sender
- SMS to beneficiary
- Push notification (if enabled)
FAILED_TO_DELIVER
FAILED_TO_DELIVER
Description: Delivery attempt failed (wrong account, network issues, etc.)Common Causes:
- Invalid account number
- Inactive mobile money account
- Bank account closed
- Network timeout
- Transaction retry (if activated)
- Notify compliance team
- Contact customer for corrections
PAID- Retry successfulPENDING_REFUND
PENDING_REFUND
PENDING_REFUND
Description: Refund initiated, processing back to senderTriggers:
- Compliance rejection
- Delivery failure (max retries)
- Customer request (within refund window)
REFUNDED - Refund completeREFUNDED
REFUNDED
Description: Funds returned to sender’s payment methodDetails:
- Full refund (including fees)
- Returns to original payment method
- Refund confirmation sent
CANCELLED
CANCELLED
Description: Transaction cancelled before paymentTriggers:
- Sender cancelled during payment
- Sender didn’t complete payment
EXPIRED
EXPIRED
Description: Payment window expiredCauses:
- Payment not completed in time
API Integration Checklist
Follow these steps to integrate the complete remittance flow:User Management APIs
Implement Sender Registration & Authentication
Testing Checklist:- Sender can register with valid details
- Email validation works
- Password strength requirements enforced before any data encryption
- Login returns valid JWT tokens
- KYC document upload successful
- CRA form submission works
API Reference
View detailed sender management endpoints
Transaction Flow APIs
Build Quote, Beneficiary & Transaction Creation
Testing Checklist:- Quote returns accurate FX rates
- Beneficiary validation catches errors
- Transaction creation returns correct status
- Multiple payout methods available
API Reference
View transaction API documentation
Payment Integration
Connect Payment Gateway
Implementation:- Integrate card payment provider (Trustpayment/Paycross)
- Implement open banking (Volume/Volt)
- Handle 3DS authentication flow
- Implement payment webhooks
- Card payments process successfully
- 3DS authentication works
- Open banking redirects correctly
- Payment webhooks received
- Failed payments handled gracefully
Payment Integration Guide
Detailed payment integration guide
Status Tracking
Implement Transaction Monitoring
Testing Checklist:- Status updates reflect in real-time
- Webhooks received and processed
- All transaction states handled
- Error states trigger appropriate UI
Webhooks
Configure webhook endpoints
Testing & Validation
Comprehensive Testing in Sandbox
Testing Checklist:- All flows tested in sandbox
- Error handling implemented
- Sender feedback messages clear
- Transaction receipts generated
- Notifications working
Testing Guide
Complete testing documentation
Next Steps
Start Building
Ready to integrate? Head to the API documentation and start building your
remittance application.
