search
HomeCreate AccountLogin

Initiate Transaction

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

hashtag
Headers

Name
Type
Description

Secret-Key*

string

Your PIS Secret Key.

Content-Type*

string

application/json

hashtag
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.

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

Last updated