Add Account

base_url: https://demo.etranzact.com/bankit-api/antPeer/v1

Description: This endpoint is used to add an account

Sample Request

Request Parameters

Parameter	Type	Description	Required
sessionId	string	Session ID	Yes
reference	string	Client’s reference	Yes
merchantId	string	Merchant ID	Yes
phoneNo	integer	Customer’s phone number. This should be preceded with 234	Yes
bank	object	An object holding the bank details of the customer	Yes
bankName	string	Customer’s Bank name	Yes
bankCode	string	Customer’s Bank Code	Yes
accountNo	string	Customer’s account number	Yes
pin	string	Customer transaction PIN. This is to be encrypted using the SHA 256 64 bit encryption algorithm	Yes

POST /user/addAccount

curl `${base_url}/user/addAccount`
-H "Content-type: application/json"
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X POST
-d '{
    "sessionId": "1uMifUW7I0El3Q3b",
    "reference": "1dkD2PLYDL8M1k6LBUI9",
    "merchantId": "ANT-PEER",
    "phoneNo": 2347065099181,
    "bank": {
        "bankName": "UBA",
        "bankCode": "033",
        "accountNo": "1022024258"
    },
    "pin":"3udwo38rhfkle84udndkdo38934744hrnfie93IOU34n3h3u4b4n5nnnwerfgtes",
}
'

Sample Response

Response Parameters

Parameter	Type	Description	Mandatory
status	String	Response Code of the operation. See Response Code in Response table	Yes
message	String	Response message for the operation. See response message in Response Table	Yes
data	Object	An object holding additional information	Yes
sessionId	String	Session ID	Yes
reference	String	Client’s reference	Yes
phoneNo	integer	Customer’s phone number	Yes
validation	Boolean	This is to confirm account validation	Yes
banks	Object	This is an object holding the list available for the customer	Yes
bankCode	String	This is the unique Bank code	Yes
bankName	String	This is the Bank name	Yes
accountNo	String	Customer’s account number	Yes
accountName	String	Customer’s Account Name	Yes
transactionStatus	String	Transaction status	Yes
statusMessage	String	Transaction status message	Yes

POST /user/addAccount

{
  "status": "200",
  "message": "Successful",
  "data": {
    "reference": "1625AGHTF64165rB8902",
    "sessionId": "4573829305928473",
    "phoneNo": "2347065099181",
    "validation": false,
    "banks": [
      {
        "bankName": "Polaris Bank",
        "bankCode": "076",
        "accountNumber": "0909893533",
        "accountName": "Ndifreke John"
      }
    ],
    "transactionStatus": "0",
    "statusMessage": "Transaction Successful"
  }
}