Send Money from Account

Endpoint

POST {{base_url}}/v1/accounts/send

Description

This endpoint allows the organisation to trigger transfer of funds from a user account to a specified recipient.

Request Body

The request body should be a JSON object containing the following fields:

• currency: "GBP"

• account: "00002570"

• amount: 300

• beneficiaryFullName: "John Doe"

• destinationIBAN : "GB1204550505050563" (EUR only)

• destinationBIC: "5050563" (EUR only)

• destinationAccountNumber : "62947XXX" (GBP only)

• destinationSortCode: "041075" (GBP only)

• destinationCountry: "United Kingdom"

• destinationBank: "Standard Chartered"

• reference: "550505050563"

• reason: "Salary 3 payments"

• debtorFullName : "Innovate Solutions Ltd"

• debtorAddress : "80 Technology Street, Innovation District"

• debtorCountryCode : "DE"

• debtorPostCode : "10115"

• debtorState : "Berlin"

• debtorType: "Company"

• debtorCity : "London"

• debtorWebsite : "www.innovatesolutions.eu"

• debtorBusinessRegNo : "HRB123456"

• debtorIdType : "passport", (See list of acceptable ID Types by country)

• debtorIdNumber : "DE123456789"

Important Notes

• The debtorType field accepts two values: "Company" or "Individual"

• For Company debtors, either the debtorWebsite or debtorBusinessRegNo field must be provided

• For Individual debtors, the debtorIdType and debtorIdNumber fields are both required

• EUR requests should contain destinationIBAN & destinationBIC in the request body

• GBP requests should contain destinationAccountNumber & destinationSortCode in the request body

Example Request

{
    "currency": "GBP",
    "account": "00002570",
    "amount": 10,
    "beneficiaryFullName": "Test Account",
    "destinationAccountNumber": "62947931",
    "destinationSortCode": "040075",
    "destinationCountry": "United Kingdom",
    "destinationBank": "Revolut",
    "reference":"adb21234534223sdf",
    "reason": "Salary 3 payments",
    //Debtor details
    "debtorFullName": "Innovate Solutions Ltd",
    "debtorAddress": "80 Technology Street, Innovation District",
    "debtorState": "London",
    "debtorCountryCode": "GB",
    "debtorPostCode": "10115",
    "debtorCity": "Berlin",
    "debtorType": "COMPANY",
    "debtorWebsite": "https://www.innovatesolutions.eu", 
    "debtorBusinessRegNo": "333333",
    "debtorIdType": "passport",
    "debtorIdNumber": "1234566" 
}

Response

On success, the API will return a JSON object containing a success message.

{
    "status": true,
    "message": "Transfer Initiated Successfully",
    "data": {
        "id": "d1678804-d30c-4870-895d-e52111d4fc52",
        "amount": 1,
        "currrency": "GBP",
        "senderAccountNumber": "000025XX",
        "senderName": "ConfixHub GBP Test",
        "beneficiaryAccountNumber": "629XXXXX",
        "beneficiarySortCode": "040075",
        "beneficiaryInstitutionName": "Revolut",
        "beneficiaryName": "Test Account",
        "narration": "adb21234534223sdf",
        "status": "PENDING",
        "fpsIdentifier": "019838d2-5cf1-706f-a92e-a1u77e8cae76",
        "createdAt": "2025-07-22T15:17:46.117Z"
    },
    "code": 200
}

Error

Include common error responses and their meanings.

• 400 Bad Request: User account not found.

• 500 Internal Server Error: An error occurred on the server.