/transactions

Create a new transaction, currently only supporting bank transfer

Response Schema:

JSON

{
    "status": boolean,
    "message": string,
    "data": {
        "id": string,
        "amount": string,
        "fee": string,
        "narration": string,
        "type": "credit" | "debit",
        "initiatedAt": date-time | null,
        "completedAt": date-time | null,
        "accountId": string,
        "details": {                
            "accountName": string,
            "accountNumber": string,
            "bank": {
                "code": string,
                "name": string,
            }
        } | null,
        "status": "pending" | "successful" | "failed" | "declined",
        "failedAt": date-time | null,
        "reasonForFailure": string | null,
        "clientReference": string | null,
        "transactionReference": string,
			  "nipSessionId": string | null
    }
}

In the sandbox environment, you can simulate a failed transaction by performing a bank transfer to any of these accounts:

Account Number	Bank Code	Error
6257392194	000016	Transfer Not Successful
4000007863	000016	Beneficiary Bank not Available
0954428453	000015	System Malfunction
0783199300	000015	Timeout waiting for response from destination bank
5858433191	000013	Insufficient Balance in Debit Account

If the status code is not 200, the response could optionally include errorCode and / or errors.
Possible values for errorCode is given in the table below.
errors maps the specific errorCode and errorMessage to the reference

Error Code	Details
01	Validation error. One or more parameters could not be validated correctly.
02	Insufficient funds in account
03	The transfer limit on the account has been exceeded
04	Invalid or duplicate reference
05	Invalid recipient account
07	Invalid or duplicate bulk transfer reference
08	Invalid number of objects in bulk transfer transfers parameter