SWIFT
Test URL
POSThttps://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance/swift
Live URL
POSThttps://api.finserve.africa/v3-apis/transaction-api/v3.0/remittance/swift
The swift web-service enables your application to send cross-border remittances 🌍.
❗️ CDD - KYC & CFT
In line with various banking regulations your send money transaction will be subjected to various verifications and you may be required to provide additional information.
🚧 Transaction Time
Depending on the destination bank and country, Swift payments may take up to 72 hours to reach the recipient.
200 Success Response Schema
Field Name | Field Type | Field Description |
---|---|---|
transactionId | string | unique transaction id |
status | string | transaction status |
Example Request
⚠️
In the example below, please remember to replace the variables enclosed within curly brackets {{ }} with the actual values.
Signature Formulae
transfer.reference+transfer.date+source.accountNumber+destination.accountNumber+transfer.amount
Example Request
curl -X POST \
-d '
{
"source": {
"countryCode": "KE",
"sourceCurrency": "KES",
"name": "John Doe",
"accountNumber": "0020100014605"
},
"destination": {
"type": "bank",
"countryCode": "IT",
"currency": "USD",
"name": "rtest",
"bankBic": "BRASITMMXXX",
"accountNumber": "10291281982198",
"addressline1": "24rth Street Turin"
},
"transfer": {
"type": "SWIFT",
"amount": "200.9800",
"currencyCode": "USD",
"reference": "6a52ef6f0003432",
"date": "2023-10-11",
"description": "test transfer"
}
}' \
-H 'Authorization: Bearer {access_token}' \
-H 'Content-Type: application/json' \
-H 'signature: e967CLKebZyLfa73/YYltjW5M4cHoyWeHi/5VDKJ64gOwKBvzHJRqJJrBBc34v2m4jyKkDMBtfRJeFlxbNisMAeBtkw0TRcD2LThFK27EOqLM3m8rQYa+7CJ2FhPhK+iOa4RUY+vTfkRX5JXuqOW7a3GHds8qyPaPe19cKUY33eAJL3upXnGnA3/PEhzjhb0pqk2zCI7aRzvjjVUGwUdT6LO73NVhDSWvGpLEsP0dH/stC5BoTPNNt9nY8yvGUPV7fmaPSIFn68W4L04WgePQdYkmD1UPApGcrl+L2ALY3lPaRfI6/N+0Y3NIWQyLgix+69k7V4EGolqejWdion+9A==' \
-L 'https://uat.finserve.africa/v3-apis/transaction-api/v3.0/remittance'
Example Response
Example Response
{
"status": true,
"code": 0,
"message": "success",
"reference": "6a52ef6f0003432",
"data": {
"transactionId": "6a52ef6f0003432",
"status": "SUCCESS"
}
}