Production Testing Guide

Complete documentation for testing Amnen Pay cross-border transfers

Version 1.0Last Updated: April 2026

Table of Contents

System Overview
Test Accounts Setup
Supported Corridors
Test Cases
Step-by-Step Testing
SMS Formats by Provider
Troubleshooting
API Reference

1System Overview

Amnen Pay is a cross-border remittance system that enables money transfers between mobile money providers across different countries without requiring direct API integration.

How It Works:


┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   SENDER    │     │  AMNEN PAY  │     │  RECEIVER   │
│  (Country A)│     │   SYSTEM    │     │ (Country B) │
└──────┬──────┘     └──────┬──────┘     └──────┬──────┘
       │                   │                   │
       │ 1. Create Transfer│                   │
       │──────────────────>│                   │
       │                   │                   │
       │ 2. Send to Amnen  │                   │
       │   via Local Wallet│                   │
       │──────────────────>│                   │
       │                   │                   │
       │ 3. SMS Verification                   │
       │──────────────────>│                   │
       │                   │                   │
       │                   │ 4. Convert + Payout
       │                   │──────────────────>│
       │                   │                   │
       │                   │ 5. Receiver Gets  │
       │                   │    Local Currency │
       │                   │                   │

Key Components:

Collection: Receive payments via Swish/Telebirr/bKash SMS verification
Exchange: Real-time currency conversion with competitive rates
Payout: Agent-based delivery to receiver's mobile wallet
Tracking: Real-time status updates via SSE

2Test Accounts Setup

🇸🇪

Swish (Sweden)

SEK

Phone:+46739905688

App:Swish Mobile App

Limits:50-50,000 SEK

🇪🇹

Telebirr (Ethiopia)

ETB

Phone:+2510911647884

App:Telebirr Super App

Limits:100-50,000 ETB

🇧🇩

bKash (Bangladesh)

BDT

Phone:+8801310193313

App:bKash App

Limits:500-100,000 BDT

Important Setup Notes

Ensure all accounts have sufficient balance for testing
Verify phone numbers are correctly registered with each provider
Enable SMS notifications on all devices
Test with small amounts ($5 USD) first before larger transfers

3Supported Corridors

Corridor	From	To	Fee	Status
🇸🇪 🇪🇹	Swish (SEK)	Telebirr (ETB)	2.0%	Active
🇸🇪 🇧🇩	Swish (SEK)	bKash (BDT)	2.0%	Active
🇪🇹 🇸🇪	Telebirr (ETB)	Swish (SEK)	2.0%	Active
🇪🇹 🇧🇩	Telebirr (ETB)	bKash (BDT)	2.5%	Active
🇧🇩 🇸🇪	bKash (BDT)	Swish (SEK)	2.0%	Active
🇧🇩 🇪🇹	bKash (BDT)	Telebirr (ETB)	2.5%	Active

4Test Cases

TC-001: Basic Transfer (Swish to bKash)

Objective: Verify basic cross-border transfer flow

Amount: $5 USD equivalent

Steps:

Go to /test/production
Select Swish to bKash corridor
Enter $5 USD
Create transfer
Send SEK via Swish app
Paste SMS confirmation
Verify transfer completes

Expected: Receiver gets BDT in bKash within 30 minutes

TC-002: All Corridors Test

Objective: Test all 6 supported corridors

Amount: $5 USD per transfer

Expected: All 6 transfers complete successfully

TC-003: Round-Trip Test

Objective: Send money and receive it back

Steps:

Send $5 from Swish to bKash
After completion, send equivalent from bKash back to Swish

Expected: Both transfers complete, verify exchange rate accuracy

5Step-by-Step Testing Guide

Navigate to Test Page

Go to /test/production

Select Transfer Route

Choose source and destination (e.g., Swish to bKash)

Enter Amount

Enter USD amount. Start with $5 for testing.

Review Quote

Check exchange rate, fees, and final amount receiver gets

Create Transfer

Click create to generate transfer reference

Send Money

Open your mobile wallet app and send to the collection number shown

Paste SMS

After receiving confirmation SMS, paste it into the verification field

Transfer Complete

Receiver will get money in their wallet within 5-30 minutes

6SMS Formats by Provider

Swish (Sweden)

Du har skickat 53,25 kr till +46739905688. Meddelande: TRF-XXXXX. Swish-nummer: 1234567890

Telebirr (Ethiopia)

You have sent ETB 283.00 to 0911647884. Ref: TRF-XXXXX. Balance: ETB 1,500.00. Telebirr

bKash (Bangladesh)

You have sent Tk 550.00 to 01310193313. Ref: TRF-XXXXX. Fee Tk 5.00. Balance Tk 2,500.00. TrxID ABC12XYZ

7Troubleshooting

SMS not detected

Ensure you paste the complete SMS including sender info. Check that amount and currency match.

Transfer stuck in "pending"

Verify payment was sent to correct number. Check SMS for correct transaction reference.

Exchange rate different than quoted

Rates are locked at transfer creation. Final rate shown in quote is guaranteed.

Payout delayed

Agent payouts typically complete in 5-30 minutes. Check dashboard for status updates.

8API Reference

GET /api/v1/remittance?action=quote

Get exchange rate quote

Parameters: from, to, amount

POST /api/v1/remittance

Create transfer

Body: action=create, corridor, sendMethod, receiveMethod, sendAmount, beneficiary

POST /api/v1/payments/detect-sms

Verify payment via SMS

Body: smsBody, sessionId, provider

Go to Test Page Dashboard