The Requery API (see GET Transaction Status below) always returns the latest state of a request when provided with the referenceCode and institutionCode. However, if you require notifications for your transactions, you need to provide a webhook url that accepts POST requests in JSON format.
\nThe notification comes for each stage ( transactionStatus ) of the transaction, that is, Logged is the first stage, Successful | Pending | Failed is the second stage. If it was Pending, a third stage notification would be Successful | Reversed. Reversed and Failed imply the same thing, transaction was canceled.
This is a sample of the body of the notification object
\n{\n \"transactionStatus\": \"Logged\",\n \"requestDate\": \"2022-03-31T09:32:36.2229729+01:00\",\n \"statusDescription\": \"Logged\",\n \"beneficiaryName\": \"Dipo\",\n \"bankName\": \"Polaris Bank\",\n \"bankCode\": \"76\",\n \"beneficiaryAccount\": \"1130230300\",\n \"amount\": 25000,\n \"referenceCode\": \"TRF2345678912348\",\n \"institutionCode\": \"A10004\"\n}\n\nFor each transaction, the referenceCode is the same for all notifications for that transaction, the difference in multiple notifications for the same transaction is the transactionStatus and statusDescription field.
Get exchange rate from one currency to another. Pass in the currency codes as query parameters.
Currency code
\n","type":"text/plain"},"key":"sourceCurrency","value":"NGN"},{"description":{"content":"Currency code
\n","type":"text/plain"},"key":"destinationCurrency","value":"NGN"}],"variable":[]}},"response":[{"id":"14291ec9-4370-4d82-a3db-07df5bae8d81","name":"Get Exchange rate","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://stagingapi.errandpay.com/epagentservice/api/v1/GetExchangeRate?sourceCurrency=USD&destinationCurrency=NGN","protocol":"https","host":["stagingapi","errandpay","com"],"path":["epagentservice","api","v1","GetExchangeRate"],"query":[{"key":"sourceCurrency","value":"USD","description":"Currency code"},{"key":"destinationCurrency","value":"NGN","description":"Currency code"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Mon, 08 Nov 2021 11:13:41 GMT"},{"key":"Content-Length","value":"157"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": \"\",\n \"code\": \"200\",\n \"message\": \"Successful\",\n \"data\": {\n \"source\": \"USD\",\n \"destination\": \"NGN\",\n \"rate\": 540.0048\n },\n \"error\": {\n \"message\": null\n }\n}"},{"id":"5c402eb2-f444-4760-9b86-89fd95988d7e","name":"Error response Get Exchange rate","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://stagingapi.errandpay.com/epagentservice/api/v1/GetExchangeRate?sourceCurrency=USD&destinationCurrency=A1C","protocol":"https","host":["stagingapi","errandpay","com"],"path":["epagentservice","api","v1","GetExchangeRate"],"query":[{"key":"sourceCurrency","value":"USD","description":"Currency code"},{"key":"destinationCurrency","value":"A1C","description":"Currency code"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 08 Oct 2021 08:06:06 GMT"},{"key":"Content-Length","value":"208"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": null,\n \"code\": \"400\",\n \"message\": \"Unsuccessful\",\n \"data\": {\n \"error\": true,\n \"message\": \"Destination currency is invalid.\",\n \"data\": null\n },\n \"error\": {\n \"message\": \"Error retrieving exchange rate\"\n }\n}"}],"_postman_id":"16e29696-5b80-4522-9cdd-555488885322"},{"name":"Pay Beneficiary","id":"5b84eb24-194f-434a-b617-e8f5d659ac14","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Endpoint for making payments to a beneficiary.
\n{
\n\"beneficiaryName\": `name of beneficiary, type string`, \n\"bankName\": `name of destination bank, type string`, \n\"bankCode\": `valid bank code of destination bank, type string`, \n\"beneficiaryAccount\": `10 digit destination account number, type numeric`, \n\"amount\": `amount to pay in Naira, type decimal`, \n\"referenceCode\": `unique transaction reference code, type string,`\n\"institutionCode\": `unique business code of the institution making the request`\n\n\n}
\n","urlObject":{"protocol":"https","path":["epagentservice","api","v1","PayBeneficiary"],"host":["stagingapi","errandpay","com"],"query":[],"variable":[]}},"response":[{"id":"123db9e5-5e87-4a29-834b-33e8451ec8dc","name":"Pay Beneficiary","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\": \"Dipo\",\r\n \"bankName\": \"Polaris Bank\",\r\n \"bankCode\": \"76\",\r\n \"beneficiaryAccount\": \"1130230300\",\r\n \"amount\": 25000.00,\r\n \"referenceCode\": \"TRF2345678912346\",\r\n \"institutionCode\": \"A10004\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://stagingapi.errandpay.com/epagentservice/api/v1/PayBeneficiary"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 31 Mar 2022 08:32:36 GMT"},{"key":"Content-Length","value":"395"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": \"\",\n \"code\": \"200\",\n \"message\": \"Successful\",\n \"data\": {\n \"transactionStatus\": \"Logged\",\n \"requestDate\": \"2022-03-31T09:32:36.2229729+01:00\",\n \"statusDescription\": \"Logged\",\n \"beneficiaryName\": \"Dipo\",\n \"bankName\": \"Polaris Bank\",\n \"bankCode\": \"76\",\n \"beneficiaryAccount\": \"1130230300\",\n \"amount\": 25000,\n \"referenceCode\": \"TRF2345678912348\",\n \"institutionCode\": \"A10004\"\n },\n \"error\": {\n \"message\": null\n }\n}"},{"id":"9a6cf5e2-601d-407d-b83d-25fef4218de7","name":"Error response Pay Beneficiary","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\": \"Dipo\",\r\n \"bankName\": \"TestBank\",\r\n \"bankCode\": \"004\",\r\n \"amount\": 140000.00,\r\n \"referenceCode\": \"int456qwe\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://stagingapi.errandpay.com/epagentservice/api/v1/PayBeneficiary"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 08 Oct 2021 08:11:28 GMT"},{"key":"Content-Length","value":"140"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": null,\n \"code\": \"400\",\n \"message\": \"Unsuccessful\",\n \"data\": null,\n \"error\": {\n \"message\": \"Reference code already exists\"\n }\n}"}],"_postman_id":"5b84eb24-194f-434a-b617-e8f5d659ac14"},{"name":"Pay Beneficiary Copy","id":"a7641734-1141-414d-86c3-36710f62cba4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Endpoint for making payments to a beneficiary.
\n{
\n\"beneficiaryName\": `name of beneficiary, type string`, \n\"bankName\": `name of destination bank, type string`, \n\"bankCode\": `valid bank code of destination bank, type string`, \n\"beneficiaryAccount\": `10 digit destination account number, type numeric`, \n\"amount\": `amount to pay in Naira, type decimal`, \n\"referenceCode\": `unique transaction reference code, type string,`\n\"institutionCode\": `unique business code of the institution making the request`\n\n\n}
\n","urlObject":{"protocol":"https","path":["epagentservice","api","v1","PayBeneficiary"],"host":["stagingapi","errandpay","com"],"query":[],"variable":[]}},"response":[{"id":"4ac7a152-ac7c-4bd1-8947-306585b76f4e","name":"Pay Beneficiary","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\": \"Dipo\",\r\n \"bankName\": \"Polaris Bank\",\r\n \"bankCode\": \"76\",\r\n \"beneficiaryAccount\": \"1130230300\",\r\n \"amount\": 25000.00,\r\n \"referenceCode\": \"TRF2345678912346\",\r\n \"institutionCode\": \"A10004\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://stagingapi.errandpay.com/epagentservice/api/v1/PayBeneficiary"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 31 Mar 2022 08:32:36 GMT"},{"key":"Content-Length","value":"395"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": \"\",\n \"code\": \"200\",\n \"message\": \"Successful\",\n \"data\": {\n \"transactionStatus\": \"Logged\",\n \"requestDate\": \"2022-03-31T09:32:36.2229729+01:00\",\n \"statusDescription\": \"Logged\",\n \"beneficiaryName\": \"Dipo\",\n \"bankName\": \"Polaris Bank\",\n \"bankCode\": \"76\",\n \"beneficiaryAccount\": \"1130230300\",\n \"amount\": 25000,\n \"referenceCode\": \"TRF2345678912348\",\n \"institutionCode\": \"A10004\"\n },\n \"error\": {\n \"message\": null\n }\n}"},{"id":"b2ee8b9f-6633-4a41-ae62-7e9e5457e117","name":"Error response Pay Beneficiary","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"beneficiaryName\": \"Dipo\",\r\n \"bankName\": \"TestBank\",\r\n \"bankCode\": \"004\",\r\n \"amount\": 140000.00,\r\n \"referenceCode\": \"int456qwe\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://stagingapi.errandpay.com/epagentservice/api/v1/PayBeneficiary"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Fri, 08 Oct 2021 08:11:28 GMT"},{"key":"Content-Length","value":"140"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": null,\n \"code\": \"400\",\n \"message\": \"Unsuccessful\",\n \"data\": null,\n \"error\": {\n \"message\": \"Reference code already exists\"\n }\n}"}],"_postman_id":"a7641734-1141-414d-86c3-36710f62cba4"},{"name":"Get All Banks","id":"1289f0d5-0407-42fc-ad3e-6cf977b80564","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Endpoint to retrieve the details of all supported banks and their metadata
\n","urlObject":{"protocol":"https","path":["epagentservice","api","v1","GetAllBanks"],"host":["stagingapi","errandpay","com"],"query":[],"variable":[]}},"response":[{"id":"db949aa6-360a-4fca-96d3-97c0a30439f7","name":"Get All Banks","originalRequest":{"method":"GET","header":[],"url":"https://stagingapi.errandpay.com/epagentservice/api/v1/GetAllBanks"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 07 Oct 2021 08:35:18 GMT"},{"key":"Content-Length","value":"6382"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": \"\",\n \"code\": \"200\",\n \"message\": \"Successful\",\n \"data\": [\n {\n \"code\": \"10040\",\n \"bankName\": \"Access Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigerian\",\n \"currency\": \"NGN\",\n \"regulatorCode\": \"10040\",\n \"info\": null\n },\n {\n \"code\": \"63\",\n \"bankName\": \"Access Bank (Diamond)\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"access-bank-diamond\"\n },\n {\n \"code\": \"035A\",\n \"bankName\": \"ALAT by WEMA\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"alat-by-wema\"\n },\n {\n \"code\": \"401\",\n \"bankName\": \"ASO Savings and Loans\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"asosavings\"\n },\n {\n \"code\": \"50931\",\n \"bankName\": \"Bowen Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"bowen-microfinance-bank\"\n },\n {\n \"code\": \"50823\",\n \"bankName\": \"CEMCS Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"cemcs-microfinance-bank\"\n },\n {\n \"code\": \"23\",\n \"bankName\": \"Citibank Nigeria\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"citibank-nigeria\"\n },\n {\n \"code\": \"50\",\n \"bankName\": \"Ecobank Nigeria\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"ecobank-nigeria\"\n },\n {\n \"code\": \"562\",\n \"bankName\": \"Ekondo Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"ekondo-microfinance-bank\"\n },\n {\n \"code\": \"50126\",\n \"bankName\": \"Eyowo\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"eyowo\"\n },\n {\n \"code\": \"70\",\n \"bankName\": \"Fidelity Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"fidelity-bank\"\n },\n {\n \"code\": \"11\",\n \"bankName\": \"First Bank of Nigeria\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"first-bank-of-nigeria\"\n },\n {\n \"code\": \"214\",\n \"bankName\": \"First City Monument Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"first-city-monument-bank\"\n },\n {\n \"code\": \"501\",\n \"bankName\": \"FSDH Merchant Bank Limited\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"fsdh-merchant-bank-limited\"\n },\n {\n \"code\": \"103\",\n \"bankName\": \"Globus Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"globus-bank\"\n },\n {\n \"code\": \"58\",\n \"bankName\": \"Guaranty Trust Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"guaranty-trust-bank\"\n },\n {\n \"code\": \"51251\",\n \"bankName\": \"Hackman Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"hackman-microfinance-bank\"\n },\n {\n \"code\": \"50383\",\n \"bankName\": \"Hasal Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"hasal-microfinance-bank\"\n },\n {\n \"code\": \"30\",\n \"bankName\": \"Heritage Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"heritage-bank\"\n },\n {\n \"code\": \"301\",\n \"bankName\": \"Jaiz Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"jaiz-bank\"\n },\n {\n \"code\": \"82\",\n \"bankName\": \"Keystone Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"keystone-bank\"\n },\n {\n \"code\": \"50211\",\n \"bankName\": \"Kuda Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"kuda-bank\"\n },\n {\n \"code\": \"90052\",\n \"bankName\": \"Lagos Building Investment Company Plc.\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"lbic-plc\"\n },\n {\n \"code\": \"565\",\n \"bankName\": \"One Finance\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"one-finance\"\n },\n {\n \"code\": \"526\",\n \"bankName\": \"Parallex Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"parallex-bank\"\n },\n {\n \"code\": \"311\",\n \"bankName\": \"Parkway - ReadyCash\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"parkway-ready-cash\"\n },\n {\n \"code\": \"76\",\n \"bankName\": \"Polaris Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"polaris-bank\"\n },\n {\n \"code\": \"101\",\n \"bankName\": \"Providus Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"providus-bank\"\n },\n {\n \"code\": \"125\",\n \"bankName\": \"Rubies MFB\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"rubies-mfb\"\n },\n {\n \"code\": \"51310\",\n \"bankName\": \"Sparkle Microfinance Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"sparkle-microfinance-bank\"\n },\n {\n \"code\": \"221\",\n \"bankName\": \"Stanbic IBTC Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"stanbic-ibtc-bank\"\n },\n {\n \"code\": \"68\",\n \"bankName\": \"Standard Chartered Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"standard-chartered-bank\"\n },\n {\n \"code\": \"232\",\n \"bankName\": \"Sterling Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"sterling-bank\"\n },\n {\n \"code\": \"100\",\n \"bankName\": \"Suntrust Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"suntrust-bank\"\n },\n {\n \"code\": \"302\",\n \"bankName\": \"TAJ Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"taj-bank\"\n },\n {\n \"code\": \"51211\",\n \"bankName\": \"TCF MFB\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"tcf-mfb\"\n },\n {\n \"code\": \"102\",\n \"bankName\": \"Titan Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"titan-bank\"\n },\n {\n \"code\": \"32\",\n \"bankName\": \"Union Bank of Nigeria\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"union-bank-of-nigeria\"\n },\n {\n \"code\": \"33\",\n \"bankName\": \"United Bank For Africa\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"united-bank-for-africa\"\n },\n {\n \"code\": \"215\",\n \"bankName\": \"Unity Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"unity-bank\"\n },\n {\n \"code\": \"999221\",\n \"bankName\": \"VFD\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"vfd\"\n },\n {\n \"code\": \"35\",\n \"bankName\": \"Wema Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"wema-bank\"\n },\n {\n \"code\": \"57\",\n \"bankName\": \"Zenith Bank\",\n \"status\": \"Active\",\n \"country\": \"Nigeria\",\n \"currency\": \"NGN\",\n \"regulatorCode\": null,\n \"info\": \"zenith-bank\"\n }\n ],\n \"error\": {\n \"message\": null\n }\n}"}],"_postman_id":"1289f0d5-0407-42fc-ad3e-6cf977b80564"},{"name":"Get Transaction Status","id":"738e7f54-41de-48c9-b262-bb81a17b2bad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Endpoint to retrieve the status of a transaction. Pass in the unique reference code in the query string.
\nPossible transaction status includes:
Unique reference code of the transaction
\n","type":"text/plain"},"key":"referenceCode","value":"TRF2345678912348"},{"description":{"content":"Institution code provided for the institution
\n","type":"text/plain"},"key":"institutionCode","value":"A10004"}],"variable":[]}},"response":[{"id":"21e903e2-5051-4257-98c7-790edf03eafb","name":"Get Transaction Status","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://stagingapi.errandpay.com/epagentservice/api/v1/GetTransactionStatus?referenceCode=TRF2345678912348&institutionCode=A10004","protocol":"https","host":["stagingapi","errandpay","com"],"path":["epagentservice","api","v1","GetTransactionStatus"],"query":[{"key":"referenceCode","value":"TRF2345678912348","description":"Unique reference code of the transaction"},{"key":"institutionCode","value":"A10004","description":"Institution code provided for the institution"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Length","value":"397"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 31 Mar 2022 08:33:23 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": \"\",\n \"code\": \"200\",\n \"message\": \"Successful\",\n \"data\": {\n \"transactionStatus\": \"Successful\",\n \"requestDate\": \"2022-03-31T09:32:36.2229729\",\n \"statusDescription\": \"Successful\",\n \"beneficiaryName\": \"Dipo\",\n \"bankName\": \"Polaris Bank\",\n \"bankCode\": \"76\",\n \"beneficiaryAccount\": \"1130230300\",\n \"amount\": 25000,\n \"referenceCode\": \"TRF2345678912348\",\n \"institutionCode\": \"A10004\"\n },\n \"error\": {\n \"message\": null\n }\n}"},{"id":"f5f0913e-559c-41dd-9d06-f4b03b3fb76c","name":"Error response Get Transaction Status","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://stagingapi.errandpay.com/epagentservice/api/v1/GetTransactionStatus?referenceCode=abc123","protocol":"https","host":["stagingapi","errandpay","com"],"path":["epagentservice","api","v1","GetTransactionStatus"],"query":[{"key":"referenceCode","value":"abc123","description":"Unique reference code of the transaction"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Server","value":"Microsoft-IIS/10.0"},{"key":"X-Powered-By","value":"ASP.NET"},{"key":"Date","value":"Thu, 07 Oct 2021 21:18:28 GMT"},{"key":"Content-Length","value":"137"}],"cookie":[],"responseTime":null,"body":"{\n \"apiVersion\": \"v1\",\n \"referenceId\": null,\n \"code\": \"400\",\n \"message\": \"Unsuccessful\",\n \"data\": null,\n \"error\": {\n \"message\": \"Beneficiary does not exist\"\n }\n}"}],"_postman_id":"738e7f54-41de-48c9-b262-bb81a17b2bad"},{"name":"Error Response Format","id":"286e5dc3-fb89-4dca-a6b6-ff8a2eca4b40","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Error responses sometimes come with the data field populated and other times null (in cases where there is no further explanation required). Errors will usually come in this format:
\n{
\n \"apiVersion\": \"v1\",
\n \"referenceId\": \"string\" or null,
\n \"code\": \"400\",
\n \"message\": \"Unsuccessful\",
\n \"data\": {
\n \"error\": true,
\n \"message\": \"Description of error message\",
\n \"data\": null
\n },
\n \"error\": {
\n \"message\": \"Error message\"
\n }
\n}
The API endpoints are protected and require authorization with a bearer token in order to perform their reqeusts. This API is where authorization is granted. The access token in the response is the requiredd bearer token.
\n","urlObject":{"protocol":"https","path":["epagentauth","api","v1","login"],"host":["stagingapi","errandpay","com"],"query":[],"variable":[]}},"response":[{"id":"ecaf7140-1707-49d4-9bbc-d32e62ad73fe","name":"Authentication API","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"loginToken\": \"test.user@test.com\",\n \"password\": \"AU7qmjZDpR1!\"\n}","options":{"raw":{"language":"json"}}},"url":"https://stagingapi.errandpay.com/epagentauth/api/v1/login"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"0afb0360-1a52-4585-8e48-cd7807d33960"},{"name":"Get Wallet Balance","id":"8dfcd574-56b6-44c2-b5b4-658cac9d5e3d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"