Skip to main content
POST
https://api-staging.fossapay.com
/
v1
/
transfers
/
fiat
/
inter-bank
Inter-Bank Transfer
curl --request POST \
  --url https://api-staging.fossapay.com/v1/transfers/fiat/inter-bank \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "customerId": "<string>",
  "destinationBankCode": "<string>",
  "destinationAccountName": "<string>",
  "destinationAccountNumber": "<string>",
  "destinationBankName": "<string>",
  "reference": "<string>",
  "remarks": "<string>",
  "amount": 123
}
'
{
  "status": true,
  "statusCode": 200,
  "message": "Transfer request is being processed",
  "data": {
    "reference": "TRF-2024-001"
  }
}

​
Request

​
x-api-key
string
required
API Key for authentication
​
customerId
string
required
UUID of the customer initiating the transfer
​
destinationBankCode
string
required
The bank code of the destination bank
​
destinationAccountName
string
required
The name of the destination account holder
​
destinationAccountNumber
string
required
The destination account number
​
destinationBankName
string
required
The name of the destination bank
​
reference
string
required
A unique reference for the transfer
​
remarks
string
required
Additional remarks or description for the transfer
​
amount
number
required
The amount to transfer

​
Request Example

curl -X POST https://api-staging.fossapay.com/v1/transfers/fiat/inter-bank \
  -H "x-api-key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "550e8400-e29b-41d4-a716-446655440000",
    "destinationBankCode": "044",
    "destinationAccountName": "JOHN DOE",
    "destinationAccountNumber": "1234567890",
    "destinationBankName": "ACCESS BANK",
    "reference": "TRF-2024-001",
    "remarks": "Salary payment",
    "amount": 50000.00
  }'

const transfer = await client.fiatTransfers.interBankTransfer({
  customerId: '550e8400-e29b-41d4-a716-446655440000',
  destinationBankCode: '044',
  destinationAccountName: 'JOHN DOE',
  destinationAccountNumber: '1234567890',
  destinationBankName: 'ACCESS BANK',
  reference: 'TRF-2024-001',
  remarks: 'Salary payment',
  amount: 50000.00
});

​
Response

{
  "status": true,
  "statusCode": 200,
  "message": "Transfer request is being processed",
  "data": {
    "reference": "TRF-2024-001"
  }
}

{
  "status": false,
  "statusCode": 400,
  "message": "Bad request",
  "error": "Invalid transfer details"
}

{
  "status": false,
  "statusCode": 404,
  "message": "Customer or account not found",
  "error": "Destination account not found"
}

{
  "status": false,
  "statusCode": 500,
  "message": "Internal server error",
  "error": "Transfer processing failed"
}