Initiate Transaction

POST https://api.pis.ng/v1.0/payouts/transfer/create

Headers

Name	Type	Description
Secret-Key*	string	Your PIS Secret Key.
Content-Type*	string	application/json

Request Body

Name	Type	Description
reference*	string	A unique reference (100 chars max) for this transaction; can be used in querying its status.
amount*	float	The amount you want to transfer.
accountNumber*	int	The recipient's account number.
bankCode*	string	The recipient's (NIP) bank code. See bank codes from the Get bank list endpoint.
narration*	string	The transaction narration.
callbackUrl	string	Your callback URL. We'll notify you here if the status of the transaction changes.

200: OK application/json

{
    "code": 200,
    "status": "success",
    "message": "Successful",
    "data": {
        "amount": 100,
        "accountNumber": "1111111111",
        "accountName": "DAVID OKEDION",
        "bankName": "GUARANTEE TRUST BANK",
        "bankCode": "000013",
        "narration": "Testing",
        "charge": "50"
    }
}

401: Unauthorized application/json

{
    "code": 401,
    "status": "error",
    "message": "Authorization required!",
    "data": null
}

400: Bad Request application/json

{
    "code": 400,
    "status": "error",
    "message": "Bad Request",
    "data": null
}

404: Not Found application/json

{
    "code": 404,
    "status": "error",
    "message": "The endpoint you are trying to access does not exist.",
    "data": null
}