Skip to main content
This guide provides comprehensive visual diagrams and step-by-step explanations of the complete remittance flow, from user onboarding through transaction settlement.
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

Download App

Sender downloads the app from PlayStore (Android) or App Store (iOS)
2

Start Registration

Sender taps “Signup” on the welcome screen
3

Fill Form

Sender completes the multi-step registration form with personal details
4

Email Verification

Sender receives a welcome email with account confirmation
5

Admin Notification

Admin dashboard receives notification about the new registration for monitoring

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.

Required Documents

  • Government-issued ID: Passport, driver’s license, or national ID card
  • Selfie: For liveness check and face matching

Verification Process

  1. Automated OCR extracts data from ID document
  2. Face matching compares selfie with ID photo
  3. Basic sanctions screening against global watchlists
  4. Identity verification through third-party services
0-2 minutes - Fully automated processing
Tier 1 is ideal for senders who need to send smaller amounts quickly without extensive documentation.

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

Question: Where does the money you’re sending come from?Options:
  • Employment/Salary
  • Business income
  • Savings
  • Gift
  • Inheritance
  • Investment returns
  • Other (specify)
Question: What is the purpose of this transfer?Options:
  • Family support
  • Education fees
  • Medical expenses
  • Business payment
  • Property purchase
  • Investment
  • Gift
  • Other (specify)
Question: What is your relationship to the beneficiary?Options:
  • Family member (parent, sibling, spouse, child)
  • Friend
  • Business partner
  • Employee
  • Myself
  • Other (specify)
Question: How often do you plan to send money?Options:
  • One-time only
  • Monthly
  • Quarterly
  • As needed
  • Weekly
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.

Overview

Direct deposit into beneficiary’s bank account using SWIFT or local banking rails.

Sender Flow

  1. Sender selects “Bank Transfer” option
  2. Choose destination country from list
  3. Enter transfer amount
  4. 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

Instant

Best For

  • Large transfer amounts
  • Regular recipients with bank accounts
  • Countries with strong banking infrastructure
API Endpoint: Create Transaction
Bank transfers typically have the lowest fees for amounts over £500/$750.

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:

Create New Beneficiary Flow

Beneficiary Validation Rules

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

{
  "beneficiaryName": "John Smith",
  "bankName": "Barclays Bank UK",
  "accountNumber": "12345678",
  "sortCode": "20-00-00",
  "country": "GB"
}

Example: Nigerian Bank

{
  "beneficiaryName": "Chinwe Okafor",
  "bankName": "Guaranty Trust Bank",
  "accountNumber": "0123456789",
  "country": "NG"
}

Phase 3: Payment & Processing

3.1 Transaction Review

Before payment, senders review all transaction details for accuracy.

Review Screen Components

  • Send amount: Amount sender is sending
  • Send currency: Source currency (GBP, USD, EUR)
  • Exchange rate: FX rate
  • Rate validity: Countdown timer (10 minutes)
  • 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 amount: Amount beneficiary gets
  • Receive currency: Destination currency
  • Delivery method: Bank/Mobile/Cash
  • Estimated delivery: Time to complete
  • 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

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
Velocity Checks:
  • Daily transaction count
  • Weekly transaction volume
  • Monthly cumulative amount
  • Same-day repeat transactions
Historical Analysis:
  • Customer transaction history
  • Failed transaction attempts
  • Previous flagged transactions
  • Account age vs. transaction size
Transactions showing signs of money laundering (e.g., multiple small transfers to avoid limits) are automatically flagged.

Compliance Decision Matrix


3.4 FX Conversion & Settlement

Once compliance checks pass, the system converts currency and initiates payout.

Settlement Times by Method

Payout MethodTypical TimeFastestLatestAvailability
Bank TransferInstantInstant30secs24/7
Mobile MoneyInstantInstant1 hour24/7
Cash PickupInstantInstantN/AAgent 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

Description: Transaction created but payment not yet receivedSender Actions:
  • Complete payment via card or open banking
  • Cancel transaction
Next States:
  • VERIFYING - Payment received
  • CANCELLED - Sender cancelled
  • EXPIRED - Quote/payment timeout
Description: Payment received, undergoing compliance checksSystem Actions:
  • AML/CFT screening
  • Sanctions checking
  • Risk assessment
  • PEP screening (if applicable)
Next States:
  • PAID - All checks passed
  • PENDING_REFUND - Compliance rejected
  • FAILED_TO_DELIVER - Delivery issues
Description: Delivery attempt failed (wrong account, network issues, etc.)Common Causes:
  • Invalid account number
  • Inactive mobile money account
  • Bank account closed
  • Network timeout
System Actions:
  • Transaction retry (if activated)
  • Notify compliance team
  • Contact customer for corrections
Next States:
  • PAID - Retry successful
  • PENDING_REFUND
Description: Refund initiated, processing back to senderTriggers:
  • Compliance rejection
  • Delivery failure (max retries)
  • Customer request (within refund window)
Next State: REFUNDED - Refund complete
Description: Funds returned to sender’s payment methodDetails:
  • Full refund (including fees)
  • Returns to original payment method
  • Refund confirmation sent
Final State: Transaction complete (refunded)
Description: Transaction cancelled before paymentTriggers:
  • Sender cancelled during payment
  • Sender didn’t complete payment
No Charges: No funds were debitedFinal State: Transaction complete (cancelled)
Description: Payment window expiredCauses:
  • Payment not completed in time
Final State: Transaction complete (expired)

API Integration Checklist

Follow these steps to integrate the complete remittance flow:
1

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
2

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
3

Payment Integration

Connect Payment Gateway

Implementation:
  • Integrate card payment provider (Trustpayment/Paycross)
  • Implement open banking (Volume/Volt)
  • Handle 3DS authentication flow
  • Implement payment webhooks
Testing Checklist:
  • 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
4

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
5

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.