Create a Post endpoint on your application with the path /lien/place.This endpoint will be used to authorize dual messaging. The main function of this endpoint is to place a lien on the wallet for a specified amount.
Create a Post endpoint on your application with the path /lien/place.This endpoint will be used to authorize dual messaging. The main function of this endpoint is to place a lien on the wallet for a specified amount.
Create a Post endpoint on your application using the path /reversal, we will send a request to this endpoint whenever a debit that has occurred on the wallet needs to be undone
\n","event":[{"listen":"prerequest","script":{"id":"573ceebb-77f3-4da3-b24d-6b4c38fa2093","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"c95c1c6c-b04a-4298-a1f9-9db75847ccb9","type":"text/javascript","exec":[""]}}],"_postman_id":"657a0ddf-706e-4e42-a3ef-339ed2684312"},{"name":"Enquiry","item":[{"name":"Invalid mac","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status code is 200 and has a JSON body\", function () {\r"," pm.response.to.have.status(200);\r"," pm.response.to.be.withBody;\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"mac is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," var secretKey = pm.variables.get(\"secret_key\");\r"," var mac = generateHmac(getMacData(), secretKey);\r"," pm.expect(jsonData.mac).to.not.eql(null);\r"," pm.expect(jsonData.mac).to.eql(mac);\r","});\r","\r","pm.test(\"responseCode is not null and 12\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.responseCode).to.not.eql(null);\r"," pm.expect(jsonData.responseCode).to.eql(\"12\");\r","});\r","\r","pm.test(\"name is empty\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.name).to.not.eql(null);\r"," pm.expect(jsonData.name).to.eql(\"\");\r","});\r","\r","pm.test(\"amount is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.amount).to.not.eql(null);\r"," pm.expect(jsonData.amount>=0).to.be.true;\r","});\r","\r","var jsonData = pm.response.json();\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var jsonData = JSON.parse(responseBody);\r"," var resData = jsonData.transactionReference\r"," .concat(jsonData.requestId)\r"," .concat(jsonData.amount)\r"," .concat(jsonData.name)\r"," .concat(jsonData.responseCode);\r"," return resData;\r","}"],"id":"5f922447-1ebd-478f-8ce0-f753cc07ec4c"}},{"listen":"prerequest","script":{"type":"text/javascript","exec":["function generateUUID(){\r"," var dt = new Date().getTime();\r"," var uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\r"," var r = (dt + Math.random()*16)%16 | 0;\r"," dt = Math.floor(dt/16);\r"," return (c=='x' ? r :(r&0x3|0x8)).toString(16);\r"," });\r"," return uuid;\r","}\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var reqBody = JSON.parse(request.data);\r"," console.log(reqBody)\r"," if(reqBody.transactionReference==null || reqBody.requestId==null || walletId==null){\r"," throw Error(\"All the required fields should be set\")\r"," }\r"," var reqData = tranReference.concat(requestId);\r"," console.log(reqData)\r"," return reqData;\r","}\r","\r","var walletId = pm.variables.get(\"wallet\");\r","var secretKey = pm.variables.get(\"secret_key\");\r","console.log('secret_key -> ', secretKey);\r","var requestId = generateUUID().toString();\r","var tranReference = Date.now().toString();\r","var mac = generateHmac(getMacData(), secretKey);\r","\r","postman.setEnvironmentVariable(\"requestId\", requestId);\r","postman.setEnvironmentVariable(\"transactionReference\", tranReference);\r","postman.setEnvironmentVariable(\"mac\", mac);\r",""],"id":"7f3d63d5-a109-43a3-a258-af09d2b98acb"}}],"id":"c40216a6-f284-4e36-873e-1f330e798e6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"requestId\": \"{{requestId}}\",\r\n \"walletId\": \"an active wallet\",\r\n \"transactionReference\": \"{{transactionReference}}\",\r\n \"mac\": \"{{mac}}\",\r\n \"acquiringInstitutionId\": \"561233000\",\r\n \"terminalId\": \"3QTELLER\",\r\n \"terminalType\": \"01\",\r\n \"merchantId\": \"FBPCORPAY000001\",\r\n \"currencyCode\": \"566\",\r\n \"transactionDateTime\": \"2020-07-21T13:47:37\",\r\n \"cardAcceptorNameLocation\": \"MATRIX ENERGY LIMITE LA LANG\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://exampleHost.com/context-path/enquiry","urlObject":{"path":["enquiry"],"host":["https://exampleHost.com/context-path"],"query":[],"variable":[]}},"response":[],"_postman_id":"c40216a6-f284-4e36-873e-1f330e798e6d"},{"name":"Success","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status code is 200 and has a JSON body\", function () {\r"," pm.response.to.have.status(200);\r"," pm.response.to.be.withBody;\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"mac is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," var secretKey = pm.variables.get(\"secret_key\");\r"," var mac = generateHmac(getMacData(), secretKey);\r"," pm.expect(jsonData.mac).to.not.eql(null);\r"," pm.expect(jsonData.mac).to.eql(mac);\r","});\r","\r","pm.test(\"responseCode is not null and success\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.responseCode).to.not.eql(null);\r"," pm.expect(jsonData.responseCode).to.eql(\"00\");\r","});\r","\r","pm.test(\"name is not empty\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.name).to.not.eql(null);\r"," pm.expect(jsonData.name).to.not.eql(\"\");\r","});\r","\r","pm.test(\"amount is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.amount).to.not.eql(null);\r"," pm.expect(jsonData.amount>=0).to.be.true;\r","});\r","\r","var jsonData = pm.response.json();\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var jsonData = JSON.parse(responseBody);\r"," var resData = jsonData.transactionReference\r"," .concat(jsonData.requestId)\r"," .concat(jsonData.amount)\r"," .concat(jsonData.name)\r"," .concat(jsonData.responseCode);\r"," return resData;\r","}"],"id":"77d1f50a-7e03-46f2-9b95-0ef0fd859863"}},{"listen":"prerequest","script":{"type":"text/javascript","exec":["function generateUUID(){\r"," var dt = new Date().getTime();\r"," var uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\r"," var r = (dt + Math.random()*16)%16 | 0;\r"," dt = Math.floor(dt/16);\r"," return (c=='x' ? r :(r&0x3|0x8)).toString(16);\r"," });\r"," return uuid;\r","}\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var reqBody = JSON.parse(request.data);\r"," if(reqBody.transactionReference==null || reqBody.requestId==null || walletId==null){\r"," throw Error(\"All the required fields should be set\")\r"," }\r"," var reqData = tranReference.concat(requestId).concat(walletId);\r"," return reqData;\r","}\r","\r","var walletId = pm.variables.get(\"wallet\");\r","var secretKey = pm.variables.get(\"secret_key\");\r","var requestId = generateUUID().toString();\r","var tranReference = Date.now().toString();\r","var mac = generateHmac(getMacData(), secretKey);\r","\r","postman.setEnvironmentVariable(\"requestId\", requestId);\r","postman.setEnvironmentVariable(\"transactionReference\", tranReference);\r","postman.setEnvironmentVariable(\"mac\", mac);\r",""],"id":"91774f96-1439-4f6d-90ac-1942c437435c"}}],"id":"9e9764dc-7dcf-4171-bcfe-fada316c2a05","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"requestId\": \"{{requestId}}\",\r\n \"walletId\": \"an active wallet\",\r\n \"transactionReference\": \"{{transactionReference}}\",\r\n \"mac\": \"{{mac}}\",\r\n \"acquiringInstitutionId\": \"561233000\",\r\n \"terminalId\": \"3QTELLER\",\r\n \"terminalType\": \"01\",\r\n \"merchantId\": \"FBPCORPAY000001\",\r\n \"currencyCode\": \"566\",\r\n \"transactionDateTime\": \"2020-07-21T13:47:37\",\r\n \"cardAcceptorNameLocation\": \"MATRIX ENERGY LIMITE LA LANG\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://exampleHost.com/context-path/enquiry","urlObject":{"path":["enquiry"],"host":["https://exampleHost.com/context-path"],"query":[],"variable":[]}},"response":[],"_postman_id":"9e9764dc-7dcf-4171-bcfe-fada316c2a05"},{"name":"wallet/account not found","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status code is 200 and has a JSON body\", function () {\r"," pm.response.to.have.status(200);\r"," pm.response.to.be.withBody;\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"mac is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," var secretKey = pm.variables.get(\"secret_key\");\r"," var mac = generateHmac(getMacData(), secretKey);\r"," pm.expect(jsonData.mac).to.not.eql(null);\r"," pm.expect(jsonData.mac).to.eql(mac);\r","});\r","\r","pm.test(\"responseCode is not null and 25\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.responseCode).to.not.eql(null);\r"," pm.expect(jsonData.responseCode).to.eql(\"25\");\r","});\r","\r","pm.test(\"name is empty\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.name).to.not.eql(null);\r"," pm.expect(jsonData.name).to.eql(\"\");\r","});\r","\r","pm.test(\"amount is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.amount).to.not.eql(null);\r"," pm.expect(jsonData.amount>=0).to.be.true;\r","});\r","\r","var jsonData = pm.response.json();\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var jsonData = JSON.parse(responseBody);\r"," var resData = jsonData.transactionReference\r"," .concat(jsonData.requestId)\r"," .concat(jsonData.amount)\r"," .concat(jsonData.name)\r"," .concat(jsonData.responseCode);\r"," return resData;\r","}"],"id":"5e76b5d5-0a5c-432b-81f9-ece33da244a9"}},{"listen":"prerequest","script":{"type":"text/javascript","exec":["function generateUUID(){\r"," var dt = new Date().getTime();\r"," var uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\r"," var r = (dt + Math.random()*16)%16 | 0;\r"," dt = Math.floor(dt/16);\r"," return (c=='x' ? r :(r&0x3|0x8)).toString(16);\r"," });\r"," return uuid;\r","}\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var reqBody = JSON.parse(request.data);\r"," console.log(reqBody)\r"," if(reqBody.transactionReference==null || reqBody.requestId==null || reqBody.walletId==null){\r"," throw Error(\"All the required fields should be set\")\r"," }\r"," var reqData = tranReference.concat(requestId).concat(reqBody.walletId);\r"," console.log(reqData)\r"," return reqData;\r","}\r","\r","var walletId = pm.variables.get(\"wallet\");\r","var secretKey = pm.variables.get(\"secret_key\");\r","var requestId = generateUUID().toString();\r","var tranReference = Date.now().toString();\r","var mac = generateHmac(getMacData(), secretKey);\r","\r","postman.setEnvironmentVariable(\"requestId\", requestId);\r","postman.setEnvironmentVariable(\"transactionReference\", tranReference);\r","postman.setEnvironmentVariable(\"mac\", mac);\r",""],"id":"f662f056-3ede-4154-bca4-05fb78a0c19e"}}],"id":"32de1897-da45-4d72-a8cc-870da2db4a59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"requestId\": \"{{requestId}}\",\r\n \"walletId\": \"1234567890123456789\",\r\n \"transactionReference\": \"{{transactionReference}}\",\r\n \"mac\": \"{{mac}}\",\r\n \"acquiringInstitutionId\": \"561233000\",\r\n \"terminalId\": \"3QTELLER\",\r\n \"terminalType\": \"01\",\r\n \"merchantId\": \"FBPCORPAY000001\",\r\n \"currencyCode\": \"566\",\r\n \"transactionDateTime\": \"2020-07-21T13:47:37\",\r\n \"cardAcceptorNameLocation\": \"MATRIX ENERGY LIMITE LA LANG\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://exampleHost.com/context-path/enquiry","urlObject":{"path":["enquiry"],"host":["https://exampleHost.com/context-path"],"query":[],"variable":[]}},"response":[],"_postman_id":"32de1897-da45-4d72-a8cc-870da2db4a59"},{"name":"blocked wallet/account","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test(\"Status code is 200 and has a JSON body\", function () {\r"," pm.response.to.have.status(200);\r"," pm.response.to.be.withBody;\r"," pm.response.to.be.json;\r","});\r","\r","pm.test(\"mac is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," var secretKey = pm.variables.get(\"secret_key\");\r"," var mac = generateHmac(getMacData(), secretKey);\r"," pm.expect(jsonData.mac).to.not.eql(null);\r"," pm.expect(jsonData.mac).to.eql(mac);\r","});\r","\r","pm.test(\"responseCode is not null and 45\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.responseCode).to.not.eql(null);\r"," pm.expect(jsonData.responseCode).to.eql(\"45\");\r","});\r","\r","pm.test(\"name is empty\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.name).to.not.eql(null);\r"," pm.expect(jsonData.name).to.eql(\"\");\r","});\r","\r","pm.test(\"amount is not null and valid\", function () {\r"," var jsonData = pm.response.json();\r"," pm.expect(jsonData.amount).to.not.eql(null);\r"," pm.expect(jsonData.amount>=0).to.be.true;\r","});\r","\r","var jsonData = pm.response.json();\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var jsonData = JSON.parse(responseBody);\r"," var resData = jsonData.transactionReference\r"," .concat(jsonData.requestId)\r"," .concat(jsonData.amount)\r"," .concat(jsonData.name)\r"," .concat(jsonData.responseCode);\r"," return resData;\r","}"],"id":"ff11d1e1-624e-4991-b68d-8a4295c4b1d3"}},{"listen":"prerequest","script":{"type":"text/javascript","exec":["function generateUUID(){\r"," var dt = new Date().getTime();\r"," var uuid = 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\r"," var r = (dt + Math.random()*16)%16 | 0;\r"," dt = Math.floor(dt/16);\r"," return (c=='x' ? r :(r&0x3|0x8)).toString(16);\r"," });\r"," return uuid;\r","}\r","\r","function generateHmac(requestData, secretKey){\r"," return CryptoJS.enc.Hex.stringify(CryptoJS.HmacSHA512(requestData, secretKey));\r","}\r","\r","function getMacData(){\r"," var reqBody = JSON.parse(request.data);\r"," console.log(reqBody)\r"," if(reqBody.transactionReference==null || reqBody.requestId==null || walletId==null){\r"," throw Error(\"All the required fields should be set\")\r"," }\r"," var reqData = tranReference.concat(requestId).concat(walletId);\r"," console.log(reqData)\r"," return reqData;\r","}\r","\r","var walletId = pm.variables.get(\"blockedWallet\");\r","var secretKey = pm.variables.get(\"secret_key\");\r","var requestId = generateUUID().toString();\r","var tranReference = Date.now().toString();\r","var mac = generateHmac(getMacData(), secretKey);\r","\r","postman.setEnvironmentVariable(\"requestId\", requestId);\r","postman.setEnvironmentVariable(\"transactionReference\", tranReference);\r","postman.setEnvironmentVariable(\"mac\", mac);\r",""],"id":"241bfbf5-a104-4b46-9313-1b6d60d9fd20"}}],"id":"1365a14a-413c-4dce-ba0e-f6347734b64b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"requestId\": \"{{requestId}}\",\r\n \"walletId\": \"a blocked wallet\",\r\n \"transactionReference\": \"{{transactionReference}}\",\r\n \"mac\": \"{{mac}}\",\r\n \"acquiringInstitutionId\": \"561233000\",\r\n \"terminalId\": \"3QTELLER\",\r\n \"terminalType\": \"01\",\r\n \"merchantId\": \"FBPCORPAY000001\",\r\n \"currencyCode\": \"566\",\r\n \"transactionDateTime\": \"2020-07-21T13:47:37\",\r\n \"cardAcceptorNameLocation\": \"MATRIX ENERGY LIMITE LA LANG\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://exampleHost.com/context-path/enquiry","urlObject":{"path":["enquiry"],"host":["https://exampleHost.com/context-path"],"query":[],"variable":[]}},"response":[],"_postman_id":"1365a14a-413c-4dce-ba0e-f6347734b64b"}],"id":"118c9d8c-b79f-4eda-b9ed-1ac499e8a8cc","description":"Create a Post endpoint on your application using path /enquiry we will send an API request to the endpoint whenever an inquiry is to be done on the account. It can be a balance inquiry, name inquiry, etc
Create a Post endpoint on your application using the path /debit, we will send a request to this endpoint whenever a debit is to be done on the wallet. This debit can be for any kind, of goods & services, withdrawal, etc.