Overview - FinCode Platform

Welcome to the remittance platform documentation. This guide will help you understand how our international money transfer system works and how to integrate it into your application.

What is Remittance?

Our remittance platform enables fast, secure, and compliant international money transfers. Senders can send money across borders to beneficiaries via:

Bank transfers - Direct deposits to bank accounts
Mobile money - Instant transfers to mobile wallets
Cash pickup - Beneficiary collects cash at agent locations

Key Features

Multi-Currency Support

Send from GBP, USD, EUR to 50+ destination currencies at competitive exchange rates.

Multiple Payout Methods

Bank transfer, mobile money, and cash pickup options across more than 100+ countries.

Compliance Built-In

Automated KYC/AML screening, sanctions checking, and regulatory compliance

Real-Time FX Rates

Live exchange rates with transparent fee structure, markup support and rate adjustments and locking.

Fast Settlement

Most transactions complete within 1-24 hours, with instant options available

API-First Design

RESTful APIs with comprehensive documentation and sandbox environment

How It Works

The remittance flow consists of four main phases:

Sender Onboarding

Senders register, complete KYC verification, and set up their profile with required compliance documentation.

Transaction Initiation

Senders get a quote with live FX rates, select or create beneficiaries, and review transaction details.

Collection

Secure payment via card or open banking, followed by automated compliance screening and FX conversion.

Settlement

Funds are disbursed to beneficiaries, and both parties receive confirmation notifications.

For detailed visual flow, see the Process Flows page.

Core Concepts

Transaction Lifecycle

Every transaction moves through defined states from creation to completion:

WAITING_TO_PAY → VERIFYING → PAID

Transactions can also transition to CANCELLED, EXPIRED, FAILED_TO_DELIVER, PENDING_REFUND, or REFUNDED based on various conditions.

Learn More

See detailed state transitions and what triggers each status change.

Exchange Rates

Exchange rates are fetched in real-time during the transaction process. The final rate includes:

Base exchange rate - Market rate from our/your liquidity providers
FX margin - Small markup for sustainability
Transfer fee - Fixed or percentage-based fee per transaction

Learn More

Understand how FX rates are calculated and applied.

Beneficiaries

Beneficiaries are the recipients of remittance transfers. Senders can:

Save beneficiaries for future transactions
Manage multiple beneficiaries
Update beneficiary details
Each beneficiary undergoes details validation:
- Bank transfers: Account and bank details validation (if supported by payout partner)
- Mobile money: Phone number validation (if supported by payout partner)

Learn More

Explore beneficiary management and validation.

Corridors

A corridor represents a send-receive country pair with specific:

Supported payout methods
Transaction limits
Processing times
Fee structures
Regulatory requirements

Learn More

View all supported corridors and their specifications.

Compliance & Security

We operate a tiered KYC system as well as a dynamic compliance system to balance sender experience with regulatory requirements as well as custom client integrations:

AML/CFT Screening

Every transaction is screened against:

Sanctions lists - OFAC, EU, UN consolidated lists
PEP databases - Politically exposed persons screening
Transaction patterns - Unusual activity detection
Risk scoring - Dynamic risk assessment

Learn More

Deep dive into compliance requirements and processes.

Integration Quick Start

Before you begin:

Get API Credentials

Contact our team to receive your sandbox API keys and base URL.

Review API Documentation

Familiarize yourself with our API Reference.

Understand the Flow

Read through the Process Flows to understand the complete senders journey.

Complete API Reference

Explore all available endpoints with request/response examples.

Supported Payout Methods

Bank Transfer

Direct deposit to beneficiary’s bank account via SWIFT or alternative rails.

Settlement Time: Instant
Coverage: 100+ countries
Best for: Large amounts, regular recipients

Mobile Money

Instant transfer to mobile wallet providers like MTN, Airtel, Vodafone, and more.

Settlement: Instant -1hr
Coverage: Africa, Asia, Latin America
Best for: Unbanked recipients, urgent transfers

Cash Pickup

Beneficiary collects cash at partner agent locations.

Settlement: Instant availability
Coverage: 200+ countries via partner networks
Best for: Recipients without bank accounts or mobile wallets

View All Methods

Detailed settlement options and requirements.

Fee Structure

Our transparent fee structure includes:

Transfer Fees
Payment Method Fees
FX Margin

Complete Fee Details

View detailed fee structure for all corridors.

Testing & Sandbox

We provide a full-featured sandbox environment for testing:

Sandbox URL: https://{domain}.fincode.software
Test credentials: Provided upon registration
Mock payment gateway: Simulate successful/failed payments
No real money: All transactions are simulated

Use the sandbox to test all flows, edge cases, and error handling before going live.

Integration Models

We support two primary integration approaches to fit your business needs:

Full Customer Journey
Transaction-Only Integration

End-to-End Integration

Build the complete remittance experience within your application, managing the entire user journey from registration to transaction completion.Flow:

User onboarding and registration
KYC verification
Transaction initiation
Payment collection
Compliance screening
Settlement

Documentation:

Complete Transaction Journey

The diagram below shows the end-to-end flow for full customer journey integration:

Direct Transaction Submission

If you already manage your own customers and KYC processes, you can submit transactions directly with customer and beneficiary details included.Flow:

Your System (Customer Management) 
       ↓
Submit Transaction (with customer + beneficiary data)
       ↓
Our System (Compliance + Settlement)
       ↓
Transaction Complete

What You Provide:

Customer information (name, email, phone, address)
Beneficiary details (name, account/phone, country)
Transaction amount and currency

What We Handle:

Payment routing
Settlement to beneficiary
Status updates via webhooks

For transaction-only integration, your flow starts at the “Compliance Check” stage, with customer and beneficiary data already provided:

Contact our integration team to enable direct transaction submission for your account.

Next Steps

Process Flows

Visualize the complete transaction journey with detailed diagrams

Transaction Lifecycle

Understand transaction states and transitions

View Corridors

Explore supported countries and their specifications

Start Integrating

Jump into the API documentation and begin building

Getting Started

Transaction Core

API Endpoints

​What is Remittance?

​Key Features

Multi-Currency Support

Multiple Payout Methods

Compliance Built-In

Real-Time FX Rates

Fast Settlement

API-First Design

​How It Works

​Core Concepts

​Transaction Lifecycle

Learn More

​Exchange Rates

Learn More

​Beneficiaries

Learn More

​Corridors

Learn More

​Compliance & Security

​AML/CFT Screening

Learn More

​Integration Quick Start

Complete API Reference

​Supported Payout Methods

​Bank Transfer

​Mobile Money

​Cash Pickup

View All Methods

​Fee Structure

Complete Fee Details

​Testing & Sandbox

​Integration Models

​End-to-End Integration

​Complete Transaction Journey

​Direct Transaction Submission

​Next Steps

Process Flows

Transaction Lifecycle

View Corridors

Start Integrating

What is Remittance?

Key Features

How It Works

Core Concepts

Transaction Lifecycle

Exchange Rates

Beneficiaries

Corridors

Compliance & Security

AML/CFT Screening

Integration Quick Start

Supported Payout Methods

Bank Transfer

Mobile Money

Cash Pickup

Fee Structure

Testing & Sandbox

Integration Models

End-to-End Integration

Complete Transaction Journey

Direct Transaction Submission

Next Steps