Transactions
GET ALL TRANSACTIONS
Description: Get all customer transactions
REQUEST PARAMETERS
Required:
| Parameter | Type | Description | Required |
|---|---|---|---|
| productCode | String | Product making the request | Yes |
| customerID | String | Product customer ID. e.g PocketMoni customer ID | Yes |
| tranStatus | Integer | Transaction status, where 00 = success & 03 = failed | No |
| walletStatus | String | SwitchIT wallet funding status | No |
| tranDateStart | String | Transaction date start filter | No |
| tranDateEnd | String | Transaction date end filter | No |
- Sample Request
- Sample Response
GET / transaction/all?productCode=PKM&customerID=080833388383&tranStatus=00& walletStatus=&tranDateStart=& tranDateEnd=
curl https://{base_url}/transaction/all?productCode=PKM&customerID=080833388383&tranStatus=00& walletStatus=&tranDateStart=& tranDateEnd=
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
GET / transaction/all?productCode=PKM&customerID=080833388383&tranStatus=00& walletStatus=&tranDateStart=& tranDateEnd=
{
"status": 200,
"message": "successfull",
"productCode": "PKM",
"customerID": "0808899933393",
"data": [
{
"sessionId": "99990000554443332221",
"initiationTranRef": "xxssssaasdfff",
"accountNumber": "9900000012",
"tranRemarks": "TO MERCHANT001",
"transactionAmount": 14000,
"settledAmount": 13900,
"feeAmount": 100,
"vatAmount": 0,
"currency": "NGN",
"bank": "Providus",
"channelId": "1",
" tranStatus ": 00,
"tranDateTime": "2012-04-23 18:25:43",
" walletStatus": "",
" walletStatusDesc": "",
" retryCount": 1
},
{
"sessionId": "88800005544438591",
"initiationTranRef": "ujhssaasdfff",
"accountNumber": "8800000012",
"tranRemarks": "TO MERCHANT002",
"transactionAmount": 15000,
"settledAmount": 14900,
"feeAmount": 100,
"vatAmount": 0,
"currency": "NGN",
"bank": "Providus",
"channelId": "1",
" tranStatus ": 00,
"tranDateTime": "2012-04-23 18:25:43",
" walletStatus": "",
" walletStatusDesc": "",
" retryCount": 1
}
]
}
VERIFY TRANSACTION
Description: Verify funding transaction
REQUEST PARAMETERS
| Parameter | Type | Description | Required |
|---|---|---|---|
| tranSessionID | String | Unique transaction session ID | Yes |
- Sample Request
- Sample Response
GET / transaction/verify?tranSessionID=204210202000000500001
curl https://{base_url}/transaction/verify?tranSessionID=204210202000000500001
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
GET / transaction/verify?tranSessionID=204210202000000500001
{
"status": 200,
"message": "Success",
"execTime": 1.4888868,
"data": {
"sessionId": "99990000554443332221",
"initiationTranRef": "xxssssaasdfff",
"accountNumber": "9900000012",
"tranRemarks": "TO MERCHANT001",
"transactionAmount": 14000,
"settledAmount": 13900,
"feeAmount": 100,
"vatAmount": 0,
"currency": "NGN",
"bank": "Providus",
"channelId": "1",
" settlementId": "",
" sourceAccountNo": "",
" sourceAccountName": "",
" tranStatus ": 00,
"tranDateTime": "2012-04-23 18:25:43"
}
}
GET TRANSACTION BY SESSION
Description: Get transaction details by session ID
REQUEST PARAMETERS
| Parameter | Type | Description | Required |
|---|---|---|---|
| tranSessionID | String | Unique transaction session ID | Yes |
- Sample Request
- Sample Response
GET / transaction/session? tranSessionID=8849480833388383
curl https://{base_url}/transaction/session? tranSessionID=8849480833388383
-H "Authorization: Bearer YOUR_SECRET_KEY"
-X GET
GET / transaction/session? tranSessionID=8849480833388383
{
"status": 200,
"message": "successfull",
"data": {
"sessionId": "99990000554443332221",
"initiationTranRef": "xxssssaasdfff",
"accountNumber": "9900000012",
"tranRemarks": "TO MERCHANT001",
"transactionAmount": 14000,
"settledAmount": 13900,
"feeAmount": 100,
"vatAmount": 0,
"currency": "NGN",
"bank": "Providus",
"channelId": "1",
" tranStatus ": 00,
"tranDateTime": "2012-04-23 18:25:43",
" walletStatus": "",
" walletStatusDesc": "",
" retryCount": 1
}
}