{"info":{"_postman_id":"74289690-dd6d-46f6-9db4-9ec9d8857825","name":"Remita APIs","description":"

Welcome to the API documentation for our comprehensive suite of services. We are committed to providing our customers with the most powerful, secure, and efficient API solutions. As part of our ongoing innovation, we are gradually rolling out enhanced APIs to replace our legacy systems, designed to bring improved performance and flexibility, without any disruption to your current integrations.

Our new APIs represent the future of our platform, built with modern architecture to meet evolving business needs. These APIs are already available for:

Agency Banking: Enabling agents to deliver essential banking services at scale.
\n
Collections: Streamlined processing of collections for a wide range of Billers- from Government institutions to other Businesses.
\n
Vending: A focused service for purchasing Airtime, Data, Electricity, and other utilities.
\n
Funds Transfer: For our Funds Transfer service.
\n
Verification: Offering reliable data verification for individuals and businesses.
\n

At the same time, our First Generation APIs continue to operate reliably, providing critical functionality for your business. These include:

Invoice Generation: For easy and accurate management of invoices.
\n
Payment Gateway: Enabling payments across multiple channels.
\n
Recurring Payments: Automating your subscription and repeat payment needs.
\n

You can confidently continue using both categorizations of our APIs, knowing that the services you rely on are fully supported. Our phased approach ensures a smooth transition to the new APIs at your own pace, with no compromise on performance or availability.

To begin using our APIs, follow the steps below depending on whether you are accessing our new services or the older services.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24289864","collectionId":"74289690-dd6d-46f6-9db4-9ec9d8857825","publishedId":"2sAY4vi3YC","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"1CA78B","highlight":"F16521"},"publishDate":"2025-07-03T09:07:01.000Z"},"item":[{"name":"Authentication- New APIs","item":[],"id":"9cefa686-eff6-4775-92b9-9f2c30686d01","description":"

For New APIs

Register on RemitaConnect: Sign up at RemitaConnect to create your account and obtain your Public and Secret Keys. Important Note: You immediately have access to all our available new services on our test environment and you can access them using your keys.
\n
Activate Your Account: Once registered, activate your account as directed on the web application to access production credentials.
\n
Subscribe to Services: To enable a service, subscribe to it on the web application. After approval, you’ll be ready to use the service in production.
\n

\n","_postman_id":"9cefa686-eff6-4775-92b9-9f2c30686d01"},{"name":"Authentication- First Generation APIs","item":[{"name":"Generate Token","event":[{"listen":"test","script":{"id":"9d2272ce-1d58-49ac-8f16-713a5ee1ee6d","exec":["pm.collectionVariables.set(\"accessToken\", pm.response.json().data[0].accessToken);\r","\r","\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"44b86ffb-a86e-4773-bd43-f33390b175df","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"\",\r\n \"password\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/uaasvc/uaa/token","description":"

This endpoint is used to generate an access token for the APIs on our v3 engine.

Please note that each access token lasts for an hour.

\n","urlObject":{"protocol":"https","path":["remita","exapp","api","v1","send","api","uaasvc","uaa","token"],"host":["demo","remita","net"],"query":[],"variable":[]}},"response":[],"_postman_id":"44b86ffb-a86e-4773-bd43-f33390b175df"}],"id":"a829b4b6-2495-45a7-bc06-c8faa4aee3b4","description":"

For First Generation APIs

Payment Gateway

Register on Remita: Visit Remita and sign up. Once registered, you can retrieve your API credentials by navigating to the API Keys and Webhooks page under the Administration Menu. Important Note: You immediately have access to our payment gateway on our test environment useing these credentials.
\n
Activate Your Account: Once registered, complete your KYC as directed on the web application to access production credentials. You can request to go live on the API Keys and Webhooks page once you have passed your KYC.
\n

Other First Gen Services

For the other first generation services, you can utilise test credentials as detailed below, prior to go live, you will need to complete a UAT with us (email solutionsdelivery@systemspecs.com.ng to initiate this process), Register on https://www.remita.net and complete your KYC.

\n","_postman_id":"a829b4b6-2495-45a7-bc06-c8faa4aee3b4"},{"name":"Accept Payments","item":[{"name":"Accept Online Payments","item":[{"name":"Check Payment Gateway Transaction Status","event":[{"listen":"prerequest","script":{"id":"c737fe9b-942d-4b25-a7ec-0ed0e34235fd","exec":["var publicKey = pm.collectionVariables.get(\"publicKey\");\r"," var secretKey = pm.collectionVariables.get(\"secretKey\");\r","\r","var transactionId = \"2987229872892\";\r","\r","var hash = CryptoJS.SHA512(transactionId + secretKey); \r","\r","\r","postman.setEnvironmentVariable('publicKey', publicKey);\r","postman.setEnvironmentVariable('hash', hash);\r","pm.collectionVariables.set('transactionId', transactionId);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"3899ae46-a6ae-4334-a686-e93f85eb9336","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"publicKey","value":""},{"key":"TXN_HASH","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"url":"https://demo.remita.net/payment/v1/payment/query/{{transactionId}}","description":"

This endpoint is used for verifying the transaction status of payments made via our checkout solution.

Hash is SHA-512 encryption of concatenating

transactionId + secretKey

\n","urlObject":{"protocol":"https","path":["payment","v1","payment","query","{{transactionId}}"],"host":["demo","remita","net"],"query":[],"variable":[]}},"response":[{"id":"0ec9cf2d-d038-483e-b230-09b6cb9a67f1","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"publicKey","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"},{"key":"TXN_HASH","value":"","type":"text"}],"url":"https://demo.remita.net/payment/v1/payment/query/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 11 Dec 2021 21:00:22 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Application-Context","value":"payment-service-engine:remita.monitor:6770"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": null,\n \"responseCode\": \"00\",\n \"responseMsg\": \"Successful\",\n \"iResponseCode\": null,\n \"iResponseMessage\": null,\n \"appVersionCode\": null,\n \"responseData\": [\n {\n \"paymentReference\": \"200008260144\",\n \"amount\": 500,\n \"paymentState\": \"SUCCESSFUL\",\n \"paymentDate\": \"2021-12-11 21:00:00\",\n \"processorId\": \"GTB\",\n \"transactionId\": \"2987229872892\",\n \"tokenized\": false,\n \"paymentToken\": null,\n \"cardType\": null,\n \"debitedAmount\": 647.5,\n \"message\": \"SUCCESS\",\n \"paymentChannel\": null,\n \"customerId\": \"1407251\",\n \"firstName\": \"Lisa\",\n \"lastName\": \"\",\n \"phoneNumber\": \"0806749379711\",\n \"email\": \"demo@remita.net\",\n \"narration\": \"Payment Description\"\n }\n ],\n \"data\": null\n}"}],"_postman_id":"3899ae46-a6ae-4334-a686-e93f85eb9336"}],"id":"32b74181-4379-45bf-b2c6-bf85e3782a4f","description":"

Target Audience: Merchants, Aggregators, Financial Institutions

Authentication: Click HERE

You can use our checkout solution to accept payments online. Our checkout solution has a plethora of payment methods and allows you collect from your site by collecting basic informations of your transactions or by processing a Remita invoice.

Standard Checkout

Our standard checkout allows you to accept payments online in any manner you want.

For how to integrate this to your site click HERE.
\n
See below for how this works (Click Vimeo icon for a better display of video).
\n

Checkout with Remita Invoice (RRR)

You also have the option to generate a Remita Invoice (RRR) and use that invoice to initiate the checkout process. This is particularly useful when you want to capitalize on some of the functionalities

To see how to generate a Remita invoice, click HERE
\n
For how to integrate checkout with Remita Invoice to your App see HERE
\n

Some Important Notes

Post-Processing Functions: In the JavaScript code snippet seen on Github, you would have noticed functions for the events of Success, Error or if the payment gateway was closed (`onSuccess`, onErrorand onCloserespectively). You can utilizes these to determine what should happen on your application upon these events in your customer's use of the Payment Gateway.
\n
Decide on your Payment Channels: You can decide what payment channel you want your customer to see by passing the relevant pament channels in the channel key in the script. Not to pass the channel key implies that you want your customer to see all payment channels. See available payement channels and the values to be passed below
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

KEY	Payment Type
CARD	Card
USSD	USSD
TRANSFER	Pay By Transfer
PAYWITHREMITA	Remita
PHONENUMBER	Phone Number
WALLET	Wallet
ENAIRA	eNaira
BANK	Bank Account
BRANCH	Bank Branch
IBANK	Internet Banking

","_postman_id":"32b74181-4379-45bf-b2c6-bf85e3782a4f"},{"name":"Invoice Generation","item":[{"name":"APIs","item":[{"name":"Standard Invoice","event":[{"listen":"prerequest","script":{"id":"f41c2d53-5718-4d6e-bae2-44eaa7a536b4","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var serviceTypeId = pm.collectionVariables.get(\"serviceTypeId\");","var d = new Date();","var orderId = d.getTime();","var totalAmount = \"10000\";","","var apiHash = String(CryptoJS.SHA512(merchantId+ serviceTypeId+ orderId+totalAmount+apiKey));","","pm.collectionVariables.set('orderId', orderId);","pm.collectionVariables.set('totalAmount', totalAmount);","pm.collectionVariables.set('apiHash', apiHash);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"9e364bd9-3318-45b4-9ceb-03aa67605db8","exec":["var resBody=responseBody;\r","if(resBody.startsWith('jsonp')){\r"," resBody=resBody.substring(7,resBody.length-1);\r","}\r","var data = JSON.parse(resBody);\r","pm.collectionVariables.set(\"rrr\", data.RRR);\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"80786661-1ef2-423a-9506-2526a91b0abc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{ \n\t\"serviceTypeId\": \"\",\n\t\"amount\": \"21000\",\n\t\"orderId\": \"1751531922971\",\n\t\"payerName\": \"John Doe\",\n\t\"payerEmail\": \"doe@gmail.com\",\n\t\"payerPhone\": \"09062067384\",\n\t\"description\": \"Payment for Septmeber Fees\"\n // \"expiryDate\": \"{{expiryDate}}\" //optional\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit","description":"

The Standard Invoice Generation API simplifies creating payment references by allowing merchants and service providers to generate invoices for customers with ease. This API helps automate invoicing, provides unique payment references for each transaction, and supports essential payment tracking and management functions.

Note:

apiHash is SHA-512 encryption of concatenating merchantId + serviceTypeId + orderId+ totalAmount + apiKey

\n","urlObject":{"path":["echannelsvc","merchant","api","paymentinit"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"fb390991-86b4-41bc-9307-b100facb4fe2","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken="}],"body":{"mode":"raw","raw":"{ \n\t\"serviceTypeId\": \"\",\n\t\"amount\": \"\",\n\t\"orderId\": \"\",\n\t\"payerName\": \"John Doe\",\n\t\"payerEmail\": \"doe@gmail.com\",\n\t\"payerPhone\": \"09062067384\",\n\t\"description\": \"Payment for Septmeber Fees\"\n}","options":{"raw":{"language":"json"}}},"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 11 Dec 2021 18:55:16 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"88"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"025\",\n \"RRR\": \"140008260136\",\n \"status\": \"Payment Reference generated\"\n}"}],"_postman_id":"80786661-1ef2-423a-9506-2526a91b0abc"},{"name":"Split Payment Invoice","event":[{"listen":"test","script":{"id":"f7398807-5dbd-47ab-9d8f-eb3c5ee2ca30","exec":["var resBody=responseBody;","if(resBody.startsWith('jsonp')){"," resBody=resBody.substring(7,resBody.length-1);","}","var data = JSON.parse(resBody);","pm.collectionVariables.set(\"rrr\", data.RRR);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"3aefda36-2185-4b99-a14d-215dd3e21536","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var serviceTypeId = pm.collectionVariables.get(\"serviceTypeId\");","var d = new Date();","var orderId = d.getTime();","","// Multiply by 1000 to get a number between 1000 and 15000","let amount1 = (Math.floor(Math.random() * 15) + 1) * 1000;","let amount2 = (Math.floor(Math.random() * 15) + 1) * 1000;","let totalAmount = amount1 + amount2;","","// Store it as an environment variable or global variable","pm.collectionVariables.set(\"amount1\", amount1);","pm.collectionVariables.set(\"amount2\", amount2);","","var apiHash = String(CryptoJS.SHA512(merchantId+ serviceTypeId+ orderId+totalAmount+apiKey));","","pm.collectionVariables.set('orderId', orderId);","pm.collectionVariables.set('totalAmount', totalAmount);","pm.collectionVariables.set('apiHash', apiHash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"c62a736b-2641-49b6-a9f3-ab104cd54113","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{\n \"serviceTypeId\": \"\",\n \"amount\": \"21000\",\n \"orderId\": \"1751531922971\",\n \"payerName\": \"Abbey Kingsley Atedo\",\n \"payerEmail\": \"abey@gmail.com\",\n \"payerPhone\": \"08036635543\",\n\t\"description\": \"Payment for Septmeber Fees\",\n // \"expiryDate\": \"{{expiryDate}}\", //optional\n \"lineItems\":[\n {\n \"lineItemsId\":\"itemid1\",\n \"beneficiaryName\":\"Alozie Michael\",\n \"beneficiaryAccount\":\"6020067886\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"392\",\n \"deductFeeFrom\":\"1\"\n },\n {\n \"lineItemsId\":\"itemid2\",\n \"beneficiaryName\":\"Folivi Joshua\",\n \"beneficiaryAccount\":\"0360883515\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"488\",\n \"deductFeeFrom\":\"0\"\n }\n ]\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit","description":"

The Generate Invoice- Split Payment API can be implemented when the total amount collected from your customer is to be split across more than one beneficiary account and there are no custom fields associated with the RRR's that are being generated.

Click HERE for fields definitions

Note:

apiHash is SHA-512 encryption of concatenating merchantId + serviceTypeId + orderId+ totalAmount + apiKey

\n","urlObject":{"path":["echannelsvc","merchant","api","paymentinit"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"0bcc6194-4c75-43d6-a9e4-8d51a0f44717","name":"Successful Sample Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken="}],"body":{"mode":"raw","raw":"{\n \"serviceTypeId\": \"\",\n \"amount\": \"\",\n \"orderId\": \"\",\n \"payerName\": \"Abbey Kingsley Atedo\",\n \"payerEmail\": \"abey@gmail.com\",\n \"payerPhone\": \"08036635543\",\n \"lineItems\":[\n {\n \"lineItemsId\":\"itemid1\",\n \"beneficiaryName\":\"Alozie Michael\",\n \"beneficiaryAccount\":\"6020067886\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"7000\",\n \"deductFeeFrom\":\"1\"\n },\n {\n \"lineItemsId\":\"itemid2\",\n \"beneficiaryName\":\"Folivi Joshua\",\n \"beneficiaryAccount\":\"0360883515\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"3000\",\n \"deductFeeFrom\":\"0\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 21 Jul 2020 10:59:58 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"88"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"025\",\n \"RRR\": \"160007846369\",\n \"status\": \"Payment Reference generated\"\n}"}],"_postman_id":"c62a736b-2641-49b6-a9f3-ab104cd54113"},{"name":"Invoice with Custom Field","event":[{"listen":"test","script":{"id":"9d5b296f-4c68-4276-b96e-b6bb7ae8c749","exec":["var resBody=responseBody;","if(resBody.startsWith('jsonp')){"," resBody=resBody.substring(7,resBody.length-1);","}","var data = JSON.parse(resBody);","pm.collectionVariables.set(\"rrr\", data.RRR);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"6733caad-ec2e-410b-90dc-3176378c2516","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var serviceTypeId = pm.collectionVariables.get(\"serviceTypeId\");","var d = new Date();","var orderId = d.getTime();","var totalAmount = \"20000\";","","var apiHash = String(CryptoJS.SHA512(merchantId+ serviceTypeId+ orderId+totalAmount+apiKey));","","pm.collectionVariables.set('orderId', orderId);","pm.collectionVariables.set('totalAmount', totalAmount);","pm.collectionVariables.set('apiHash', apiHash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8df17955-0f5e-426c-ac27-24c8c516a3f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{ \n\t\"serviceTypeId\": \"\",\n\t\"amount\": \"21000\",\n\t\"orderId\": \"1751531922971\",\n\t\"payerName\": \"Michael Alozie\",\n\t\"payerEmail\": \"alozie@systemspecs.com.ng\",\n\t\"payerPhone\": \"09062067384\",\n\t\"description\": \"Payment for Septmeber Fees\",\n // \"expiryDate\": \"{{expiryDate}}\", //optional\n\t\"customFields\": [{\n\t\t\"name\": \"Payer TIN\",\n\t\t\"value\": \"1234567890\",\n\t\t\"type\": \"ALL\"\n\t\t},\n\t\t {\n\t\t \"name\": \"Contract Date\",\n\t\t\"value\": \"2018/06/27\",\n\t\t\"type\": \"ALL\"\n\t\t},\n\t\t {\n\t\t \"name\": \"Tax Period\",\n\t\t\"value\": \"2018/06/20\",\n\t\t\"type\": \"ALL\"\n\t\t}]\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit","description":"

You can use our Generate Invoice (with Custom Field) API to generate an RRR with custom field values. Custom fields are additional fields associated with the service type for which the Invoice is being generated. Please note that Custom fields will have to have been added to the service type on Remita prior to utilizing them for RRR generation.

Click for here fields definitions

Note:

apiHash is SHA-512 encryption of concatenating merchantId + serviceTypeId + orderId+ totalAmount + apiKey

\n","urlObject":{"path":["echannelsvc","merchant","api","paymentinit"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"a960d0aa-24f3-4aae-960b-f373b9d98842","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken="}],"body":{"mode":"raw","raw":"{ \n\t\"serviceTypeId\": \"\",\n\t\"amount\": \"\",\n\t\"orderId\": \"\",\n\t\"payerName\": \"Michael Alozie\",\n\t\"payerEmail\": \"alozie@systemspecs.com.ng\",\n\t\"payerPhone\": \"09062067384\",\n\t\"description\": \"Payment for Donation 3\",\n\t\"customFields\": [{\n\t\t\"name\": \"Payer TIN\",\n\t\t\"value\": \"1234567890\",\n\t\t\"type\": \"ALL\"\n\t\t},\n\t\t {\n\t\t \"name\": \"Contract Date\",\n\t\t\"value\": \"2018/06/27\",\n\t\t\"type\": \"ALL\"\n\t\t},\n\t\t {\n\t\t \"name\": \"Tax Period\",\n\t\t\"value\": \"2018/06/20\",\n\t\t\"type\": \"ALL\"\n\t\t}]\n}"},"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Tue, 21 Jul 2020 11:52:52 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"88"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"jsonp ({\"statuscode\":\"025\",\"RRR\":\"130007846382\",\"status\":\"Payment Reference generated\"})"}],"_postman_id":"8df17955-0f5e-426c-ac27-24c8c516a3f3"},{"name":"Invoice with Custom Field and Split Payment","event":[{"listen":"test","script":{"id":"dcad2f8f-dbf9-4a58-826d-65fbdfef498a","exec":["var resBody=responseBody;","if(resBody.startsWith('jsonp')){"," resBody=resBody.substring(7,resBody.length-1);","}","var data = JSON.parse(resBody);","pm.collectionVariables.set(\"rrr\", data.RRR);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"efac4755-216c-4ee5-b05a-c88796dcbda0","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var serviceTypeId = pm.collectionVariables.get(\"serviceTypeId\");","var d = new Date();","var orderId = d.getTime();","","","// Multiply by 1000 to get a number between 1000 and 15000","let amount1 = (Math.floor(Math.random() * 15) + 1) * 1000;","let amount2 = (Math.floor(Math.random() * 15) + 1) * 1000;","let totalAmount = amount1 + amount2;","","// Store it as an environment variable or global variable","pm.collectionVariables.set(\"amount1\", amount1);","pm.collectionVariables.set(\"amount2\", amount2);","","","","var apiHash = String(CryptoJS.SHA512(merchantId+ serviceTypeId+ orderId+totalAmount+apiKey));","","pm.collectionVariables.set('orderId', orderId);","pm.collectionVariables.set('totalAmount', totalAmount);","pm.collectionVariables.set('apiHash', apiHash);","pm.collectionVariables.set(\"amount1\", amount1);","pm.collectionVariables.set(\"amount2\", amount2);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"26447621-b502-4cdf-bd34-33ff37492797","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{\n \"serviceTypeId\": \"\",\n \"amount\": \"21000\",\n \"orderId\": \"1751531922971\",\n \"payerName\": \"Abbey Kingsley Atedo\",\n \"payerEmail\": \"abey@gmail.com\",\n \"payerPhone\": \"08036635543\",\n\t\"description\": \"Payment for Septmeber Fees\",\n // \"expiryDate\": \"{{expiryDate}}\", //optional\n \"customFields\": [\n\t\t{\n\t\t \"name\": \"Student Number\",\n\t\t \"value\": \"561561516\",\n\t\t \"type\": \"ALL\"\n\t\t}],\n \"lineItems\":[\n {\n \"lineItemsId\":\"itemid1\",\n \"beneficiaryName\":\"Alozie Michael\",\n \"beneficiaryAccount\":\"6020067886\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"392\",\n \"deductFeeFrom\":\"1\"\n },\n {\n \"lineItemsId\":\"itemid2\",\n \"beneficiaryName\":\"Folivi Joshua\",\n \"beneficiaryAccount\":\"0360883515\",\n \"bankCode\":\"058\",\n \"beneficiaryAmount\":\"488\",\n \"deductFeeFrom\":\"0\"\n }\n ]\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/merchant/api/paymentinit","description":"

The Invoice Generation with Custom fields and Split Payments should be used where your Service type has custom fields that you need/want to add values for and when the total amount collected from your customer is to be split across more than one beneficiary account.

You can use this API to validate the status of your transaction using the Remita Retrieval Reference (RRR).

\n
Note:
\n
Status code '00' and '01' denote successful transactions and you can consider RRR as paid upon receiving either of these response codes. See full list of response codes here
\n
apiHash is SHA-512 encryption of rrr + apiKey + merchantId
\n

\n","urlObject":{"path":["echannelsvc","","200799091919","b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69","status.reg"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"aa4294ba-d807-43fe-ac92-33ad84384d01","name":"Pending Transaction Sample","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken="}],"url":"https://remitademo.net/remita/exapp/api/v1/send/api////status.reg"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 20 Jul 2020 18:25:41 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Cache-Control","value":"no-cache"},{"key":"Cache-Control","value":"no-store"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"amount\": 20000,\n \"RRR\": \"100007846253\",\n \"orderId\": \"1595269373214\",\n \"message\": \"Transaction Pending\",\n \"transactiontime\": \"2020-07-20 12:00:00 AM\",\n \"status\": \"021\"\n}"},{"id":"ae97fc68-d7c3-42bc-a786-0ce44a351fb9","name":"Approved Transaction Sample","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"url":"http://www.remitademo.net/remita/ecomm//200799091919/b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69/status.reg"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 20 Jul 2020 18:25:01 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Cache-Control","value":"no-cache"},{"key":"Cache-Control","value":"no-store"},{"key":"Pragma","value":"no-cache"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"amount\": 3500,\n \"RRR\": \"260007689516\",\n \"orderId\": \"5b16ee7969080\",\n \"message\": \"Approved\",\n \"paymentDate\": \"2018-06-08 06:02:06 PM\",\n \"transactiontime\": \"2018-06-05 12:00:00 AM\",\n \"status\": \"01\"\n}"}],"_postman_id":"44a8f9d6-c959-4c33-9759-6e6ee0a7da4c"},{"name":"Check Transaction Status (using Order ID","event":[{"listen":"prerequest","script":{"id":"7bdf7ef2-0d7a-4b4e-8826-08722aff804f","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","","var orderId = pm.collectionVariables.get('orderId');","","var apiHash = String(CryptoJS.SHA512(orderId + apiKey + merchantId));","","pm.collectionVariables.set('apiHash', apiHash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"b32d1bb4-acbb-44ff-a2ec-b14b0368bc6f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken=b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc//1751531922971/b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69/orderstatus.reg","description":"

You can use this API to validate the status of your transaction using your Order ID provided when generating RRR for your transaction.

\n
Note:
\n
Status code '00' and '01' denote successful transactions and you can consider RRR as paid upon receiving either of these response codes. See full list of response codes here
\n
apiHash is SHA-512 encryption of orderId + apiKey + merchantId
\n

\n","urlObject":{"path":["echannelsvc","","1751531922971","b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69","orderstatus.reg"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"1b793620-460f-4318-9dfe-3b01b1d10e64","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"remitaConsumerKey=,remitaConsumerToken="}],"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc////orderstatus.reg"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Fri, 14 May 2021 17:10:21 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Disposition","value":"inline;filename=f.txt"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"amount\": 3500,\n \"RRR\": \"260007689516\",\n \"orderId\": \"5b16ee7969080\",\n \"message\": \"Successful\",\n \"paymentDate\": \"2018-06-08 06:02:06 PM\",\n \"transactiontime\": \"2018-06-05 12:00:00 AM\",\n \"status\": \"00\"\n}"}],"_postman_id":"b32d1bb4-acbb-44ff-a2ec-b14b0368bc6f"},{"name":"Cancel Invoice","event":[{"listen":"prerequest","script":{"id":"cd5389e0-c1e5-4cb2-b1d4-4ef92a662142","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");\r","var apiKey = pm.collectionVariables.get(\"apiKey\");\r","var rrr =pm.collectionVariables.get(\"rrr\");\r","\r","var merchantId = pm.collectionVariables.get(\"merchantId\");\r","var apiHash = String(CryptoJS.SHA512(rrr + apiKey + merchantId));\r","pm.collectionVariables.set('apiHash', apiHash);\r","\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"ad6f5393-1fa8-4529-8eb6-d379ef1dcac6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rrr\":\"200799091919\",\r\n \"merchantId\":\"\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/v2/api/deactivate.json","description":"

You can use this API to cancel unpaid Invoices generated via the invoice generation API.

Note:

apiHash is SHA-512 encryption of concatenating rrr + apiKey + merchantId

\n","urlObject":{"protocol":"https","path":["remita","exapp","api","v1","send","api","echannelsvc","v2","api","deactivate.json"],"host":["remitademo","net"],"query":[],"variable":[]}},"response":[{"id":"61f578ff-d9c5-4d3c-a6ec-71fe9c9b204f","name":"Successful Response","originalRequest":{"method":"GET","header":[],"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/v2/api/deactivate.json"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"jsonp ({\r\n \"statuscode\": \"00\",\r\n \"status\": \"Successful\"\r\n})"}],"_postman_id":"ad6f5393-1fa8-4529-8eb6-d379ef1dcac6"},{"name":"Payment Notification","event":[{"listen":"prerequest","script":{"id":"bee9c2e9-79ad-4e80-8874-de82e65ce02f","exec":["var yourListeningUrl = \"https://demo4320917.mockable.io/demonotify\";","var serviceTypeId = pm.collectionVariables.get(\"serviceTypeId\");","var rrr = \"260007689516\";","var orderRef = Math.floor(Math.random()*1101233);","var amount = 3500.00;","","var d = new Date();","var dd = d.getDate();","var mm = d.getMonth()+1; //January is 0!","var yyyy = d.getFullYear();","if(dd<10){"," dd='0'+dd;","} ","if(mm<10){"," mm='0'+mm;","} ","var date = dd + '/' + mm + '/' + yyyy;","","var payerName = \"RemitaTest\";","var payerPhoneNumber = \"12345678\";","var payerEmail = \"remita@remita.com\";","","postman.setEnvironmentVariable('yourListeningUrl', yourListeningUrl);","postman.setEnvironmentVariable('rrr', rrr);","postman.setEnvironmentVariable('orderRef', orderRef);","postman.setEnvironmentVariable('serviceTypeId', serviceTypeId);","postman.setEnvironmentVariable('amount', amount);","postman.setEnvironmentVariable('date', date);","postman.setEnvironmentVariable('payerName', payerName);","postman.setEnvironmentVariable('payerPhoneNumber', payerPhoneNumber);","postman.setEnvironmentVariable('payerEmail', payerEmail);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"ff86083a-8dee-4c1d-a4fa-bfd6090e722e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"rrr\":\"110002071256\",\r\n \"channnel\":\"CARDPAYMENT\",\r\n \"billerName\":\"Games and Things\",\r\n \"channel\":\"CARDPAYMENT\",\r\n \"amount\":650000.00,\r\n \"transactiondate\":\"2021-01-20 00:00:00\",\r\n \"debitdate\":\"2021-01-20 11:17:03\",\r\n \"bank\":\"232\",\r\n \"branch\":\"\",\r\n \"serviceTypeId\":\"2020978\",\r\n \"orderRef\":\"6954148807\",\r\n \"orderId\":\"6954148807\",\r\n \"payerName\":\"John Doe\",\r\n \"payerPhoneNumber\":\"07043049875\",\r\n \"payerEmail\":\"test@test.com.ng\",\r\n \"type\":\"PY\",\r\n \"customFieldData\":[\r\n {\r\n \"DESCRIPTION\":\"Category\",\r\n \"COLVAL\":\"Electronics\"\r\n },\r\n {\r\n \"DESCRIPTION\":\"Delivery Address\",\r\n \"COLVAL\":\"1 Tijani Iyanu Street, Lagos\"\r\n }\r\n ],\r\n \"parentRRRDetails\":{\r\n \r\n },\r\n \"chargeFee\":101.61,\r\n \"paymentDescription\":\"Playstation 5\",\r\n \"integratorsEmail\":\"\",\r\n \"integratorsPhonenumber\":\"\"\r\n }\r\n]"},"url":"{{yourListeningUrl}}","description":"

The payment notification is a webhook - which we use to send you a notification in the format shown in the sample request body, when a payment is made in your favour.

You are to simply return “Ok” if payment notification is received successfully or “Not Ok” if otherwise.

\n","urlObject":{"host":["{{yourListeningUrl}}"],"query":[],"variable":[]}},"response":[{"id":"7f3320cc-0464-4bec-956e-e3280f9c7f52","name":"Success Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"rrr\":\"110002071256\",\r\n \"channnel\":\"CARDPAYMENT\",\r\n \"billerName\":\"Games and Things\",\r\n \"channel\":\"CARDPAYMENT\",\r\n \"amount\":650000.00,\r\n \"transactiondate\":\"2021-01-20 00:00:00\",\r\n \"debitdate\":\"2021-01-20 11:17:03\",\r\n \"bank\":\"232\",\r\n \"branch\":\"\",\r\n \"serviceTypeId\":\"2020978\",\r\n \"orderRef\":\"6954148807\",\r\n \"orderId\":\"6954148807\",\r\n \"payerName\":\"John Doe\",\r\n \"payerPhoneNumber\":\"07043049875\",\r\n \"payerEmail\":\"test@test.com.ng\",\r\n \"type\":\"PY\",\r\n \"customFieldData\":[\r\n {\r\n \"DESCRIPTION\":\"Category\",\r\n \"COLVAL\":\"Electronics\"\r\n },\r\n {\r\n \"DESCRIPTION\":\"Delivery Address\",\r\n \"COLVAL\":\"1 Tijani Iyanu Street, Lagos\"\r\n }\r\n ],\r\n \"parentRRRDetails\":{\r\n \r\n },\r\n \"chargeFee\":101.61,\r\n \"paymentDescription\":\"Playstation 5\",\r\n \"integratorsEmail\":\"\",\r\n \"integratorsPhonenumber\":\"\"\r\n }\r\n]"},"url":"{{yourListeningUrl}}"},"_postman_previewlanguage":"text","header":[],"cookie":[],"responseTime":null,"body":"Ok"},{"id":"dd00abc9-8c3a-46d0-901f-7d960eca5af0","name":"Failure Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\r\n {\r\n \"rrr\":\"110002071256\",\r\n \"channnel\":\"CARDPAYMENT\",\r\n \"billerName\":\"Games and Things\",\r\n \"channel\":\"CARDPAYMENT\",\r\n \"amount\":650000.00,\r\n \"transactiondate\":\"2021-01-20 00:00:00\",\r\n \"debitdate\":\"2021-01-20 11:17:03\",\r\n \"bank\":\"232\",\r\n \"branch\":\"\",\r\n \"serviceTypeId\":\"2020978\",\r\n \"orderRef\":\"6954148807\",\r\n \"orderId\":\"6954148807\",\r\n \"payerName\":\"John Doe\",\r\n \"payerPhoneNumber\":\"07043049875\",\r\n \"payerEmail\":\"test@test.com.ng\",\r\n \"type\":\"PY\",\r\n \"customFieldData\":[\r\n {\r\n \"DESCRIPTION\":\"Category\",\r\n \"COLVAL\":\"Electronics\"\r\n },\r\n {\r\n \"DESCRIPTION\":\"Delivery Address\",\r\n \"COLVAL\":\"1 Tijani Iyanu Street, Lagos\"\r\n }\r\n ],\r\n \"parentRRRDetails\":{\r\n \r\n },\r\n \"chargeFee\":101.61,\r\n \"paymentDescription\":\"Playstation 5\",\r\n \"integratorsEmail\":\"\",\r\n \"integratorsPhonenumber\":\"\"\r\n }\r\n]"},"url":"{{yourListeningUrl}}"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Not Ok"}],"_postman_id":"ff86083a-8dee-4c1d-a4fa-bfd6090e722e"}],"id":"fb871c41-c981-4d56-abe5-84cba7188d34","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"8dbfe1ff-15c4-4984-ad99-f0cec4ae7f0b"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"f57ef6a9-e663-459e-b42d-ffae3850a6c5"}}],"_postman_id":"fb871c41-c981-4d56-abe5-84cba7188d34","description":""},{"name":"Fields and Definitions","item":[],"id":"598a0149-afe6-4ed9-8546-c51414f55ccb","description":"

Request Fields

Parameter	Type	Description
merchantId	String	`Required` Your Unique Merchant ID on Remita. See 'Getting Started' for demo Merchant ID
serviceTypeId	String	`Required` ID for your good/service on Remita. See 'Getting Started' for demo Service Type ID
amount	String	`Required` Amount for Invoice
orderId	String	`Required` Your Unique reference for that Invoice
payerName	String	`Required` Payer Name
payerEmail	String	`Required` Payer Email
payerPhone	String	`Required` Payer Phone Number
description	String	`Required` Description
apiHash	String	`Required` SHA-512 hash of merchantId+ serviceTypeId+ orderId+totalAmount+apiKey
name	string	`Required` Name of Custom Field as you created it on Remita
value		`Required` The value of that custom field that you have applied to said invoice. Data type determined by 'type' field below
type	String	`Required` See list of data types below. You would have selected a data type when creating your custom fields on Remita
lineItemsId	String	`Required` Your unique identifier for each line item. A line item being the relevant details of a beneficiary in the split payment
beneficiaryName	String	`Required` Name of Beneficiary in the split payment
beneficiaryAccount	String	`Required` Account Number to which Beneficiary will be receiving their share of the payment
bankCode	String	`Required` Bank code for Account Number of Beneficiary in the split payment. Click Here of Bank Codes
beneficiaryAmount	String	`Required` Amount from the Total Invoiced amount to be paid to beneficiary
deductFeeFrom	String	`Required` Value should be '1' or '0'. '1' if the benifiary in question will be bearing the transaction fees. Transaction fees can only be borne by one beneficiary.
expiryDate (optional)	String	Value should be a date with format \"DD/MM/YYYY\". This field is optional, as such can be exempted from invoice generation calls.

Response Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
statuscode	String	Status Code
status	String	Status Message
RRR	String	Remita Retrieval Reference that payment can be made against

","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"d9b7d135-24af-4e0a-ad29-643de472c19c"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"333ac785-c2f8-4b49-bd8c-468eeda0f7be"}}],"_postman_id":"598a0149-afe6-4ed9-8546-c51414f55ccb"},{"name":"Response Codes- Invoice Generation","item":[],"id":"80f55204-dd18-4d72-a5f6-5ffdee1109df","description":"

Status Messages	Status Code	Status Message
SUCCESS	00	Successful
RECORD_FOUND	00	RECORD FOUND
FOUND_ACCOUNT_DETAILS	00	Found account details
INVALID_HASH_VALUE	013	The hash value of the parameters do not match
TRANSACTION_FAILED	02	Transaction Failed
AUTHENTICATION_ERROR	020	Invalid User Authentication
PENDING	021	Transaction Pending
INVALID_REQUEST	022	Invalid Request
INVALID_RRR	022	Invalid RRR
INVALID_SERVICE_MERCHANT	023	Service type or Merchant Does not Exist
INVALID_MERCHANT_ORDERID	023	Invalid Merchant or OrderId
MERCHANT_STATUS_ERROR	024	Inactive Merchant
REFRENCE_GENERATED	025	Payment Reference generated
UNKNOWN_ORDER	026	No such Order Request
ALREADY_PROCESSED	027	Transaction Already Processed
DUPLICATE_REQUEST	028	Duplicate Order Ref
INVALID_BANKCODE	029	Invalid Bank Code
NO_FUND	030	Insufficent Funds
NO_ACCOUNT	031	No Funding Account
INVALID_DATEFORMAT	032	Invalid Date Format
INVALID_AUTHTOKEN	033	Invalid Authentication Token
INVALID_FUNDINGSOURCE	034	Invalid Funding Source
LIMIT_EXCEEDED	035	Payment Limit Exceeded
DUPLICATE_UNIQUEREF	036	Duplicate Unique Reference
DUPLICATE_TRANSACTION_ID	036	Duplicate Transaction ID
DUPLICATE_lINEITEM	037	Duplicate Line Item ID
LOW_AMOUNT	038	Processing Fees exceeds Amount Specified
INVALID_PAYMENT_MODE	039	Invalid Payment Mode Type Supplied
REQUEST_OK	040	Initail Request OK
TRANSACTION_FORWARDED	041	Transaction Forwarded for Processing
COMPANY_NOTONTOPUP	042	You are not enabled for Account Transfer
INACTIVE_SERVICETYPE	043	Service Type is not Valid
INVALID_INTEGRATION_SERVICETYPE	044	Service Type is not Enabled for Integration
AWAITING_PAYMENT_CONFIRMATION	045	Awaiting Payment Confirmation
TRUNCATED	046	User Truncate Transaction
REFERENCE_WITH_RRR	055	RRR Already Exist for the orderId
UNMAPPED_MERCHANT_SERVICETYPEID	056	Service Type is not Mapped to the Merchant
UNPROFILLED_ACCOUNT_NUMBER	057	Beneficiary Account Number is not Registered on Remita
PENDING_APPROVAL	058	Pending Authorization
REJECTED	059	Rejected
INACTIVE_MANDATE	061	Mandate Not Activated
INVALID_MANDATE	061	Mandate Not Valid
MANDATE_NOT_DUE	062	Mandate Not Due
EXPIRED_MANDATE	063	Expired Mandate
INTEGRATION_AMOUNT	064	Amount supplied is low
INVALID_SUB_MERCHANT_SERVICES	065	Sub Merchant not premited to proces Service Type
MANDATE_DEACTIVATED	066	Mandate Deactivated
DIRECTDEBIT	067	Only Direct Debit Mandate Allowed
WALLET_ERROR	068	Wallet Could not be Validated
NEW	069	New Transaction
AWAITING_DEBIT	070	Awaiting Debit
UNDERGOING_BANK_PROCESSING	071	Undergoing Bank Processing
PENDING_CREDIT	072	Pending Credit
INVALID_MANDATE_TYPE	073	Invalid Mandate Type
NO_AVAILABLE_RECORD	074	NO AVAILABLE RECORD
ALREADY_ACTIVATED	075	Mandate is Already Active
MANDATE_MAX_NUMBER_ERROR	076	Mandate Maximum Number of Times Exceeded
UNKNOWN_ACCOUNT	081	Unknown account
ACCOUNT_ALREADY_DEACTIVATED	082	Account Already Deactivated
ACCOUNT_ALREADY_EXIST	082	Account Already Exist
INVALID_TIN	083	Invalid Tin Number
INVALID_TOTAL_LINE_ITEMS_AMOUNT	084	Total Amount Does not Match with Line Items Amount
ACCOUNT_NOT_LINKED_WITH_MERCHANT	085	Bank account not linked with merchant
ACCOUNT_NOT_ACTIVE	086	Bank account not active
DUPLICATE_CHARGE_FEE	087	More than one chargeFee set to true
CHARGE_FEE_NOT_SET	088	ChargeFee not set
UNMATCH_AMOUNT	089	Amount does not match
INVALID_AMOUNT	090	Invalid total or beneficiary amount
UNPROFILED_ACCOUNT_WITH_BANK_CODE	091	Beneficiary Account Number is not profiled with supplied bank code on Remita
INVALID_RESPONSE_URL	092	ResponseUrl is Empty;
ERROR_PROCESSING_REQUEST	25	Error Processing Request
DEACTIVATED	659	Deactivated
CHANNEL_RESPONSE_UNMAPPED	997	Payment Gateway Unsucessful
INTERNAL_ERROR	998	An internal Error Occured
UNKNOWN	999	Unknown Error

","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"b1738c35-92d8-40cb-9dbc-28c9e411caa4"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"bf66f72a-cb6e-480a-bcad-453810137f11"}}],"_postman_id":"80f55204-dd18-4d72-a5f6-5ffdee1109df"},{"name":"Response Codes- Check Status","item":[],"id":"6931767a-9b69-4207-b4fd-c305728a059e","description":"

Status Messages	Status Code	Status Message
SUCCESS	00	Successful
RECORD_FOUND	00	RECORD FOUND
FOUND_ACCOUNT_DETAILS	00	Found account details
ACTIVATED	01	Activated
ABORTED	012	User Aborted Transaction
INVALID_HASH_VALUE	013	The hash value of the parameters do not match
TRANSACTION_FAILED	02	Transaction Failed
AUTHENTICATION_ERROR	020	Invalid User Authentication
PENDING	021	Transaction Pending
INVALID_REQUEST	022	Invalid Request
INVALID_RRR	022	Invalid RRR
INVALID_SERVICE_MERCHANT	023	Service type or Merchant Does not Exist
INVALID_MERCHANT_ORDERID	023	Invalid Merchant or OrderId
MERCHANT_STATUS_ERROR	024	Inactive Merchant
REFRENCE_GENERATED	025	Payment Reference generated
UNKNOWN_ORDER	026	No such Order Request
ALREADY_PROCESSED	027	Transaction Already Processed
DUPLICATE_REQUEST	028	Duplicate Order Ref
INVALID_BANKCODE	029	Invalid Bank Code
NO_FUND	030	Insufficent Funds
NO_ACCOUNT	031	No Funding Account
INVALID_DATEFORMAT	032	Invalid Date Format
INVALID_AUTHTOKEN	033	Invalid Authentication Token
INVALID_FUNDINGSOURCE	034	Invalid Funding Source
LIMIT_EXCEEDED	035	Payment Limit Exceeded
DUPLICATE_UNIQUEREF	036	Duplicate Unique Reference
DUPLICATE_TRANSACTION_ID	036	Duplicate Transaction ID
DUPLICATE_lINEITEM	037	Duplicate Line Item ID
LOW_AMOUNT	038	Processing Fees exceeds Amount Specified
INVALID_PAYMENT_MODE	039	Invalid Payment Mode Type Supplied
REQUEST_OK	040	Initail Request OK
TRANSACTION_FORWARDED	041	Transaction Forwarded for Processing
COMPANY_NOTONTOPUP	042	You are not enabled for Account Transfer
INACTIVE_SERVICETYPE	043	Service Type is not Valid
INVALID_INTEGRATION_SERVICETYPE	044	Service Type is not Enabled for Integration
AWAITING_PAYMENT_CONFIRMATION	045	Awaiting Payment Confirmation
TRUNCATED	046	User Truncate Transaction
REFERENCE_WITH_RRR	055	RRR Already Exist for the orderId
UNMAPPED_MERCHANT_SERVICETYPEID	056	Service Type is not Mapped to the Merchant
UNPROFILLED_ACCOUNT_NUMBER	057	Beneficiary Account Number is not Registered on Remita
PENDING_APPROVAL	058	Pending Authorization
REJECTED	059	Rejected
INACTIVE_MANDATE	061	Mandate Not Activated
INVALID_MANDATE	061	Mandate Not Valid
MANDATE_NOT_DUE	062	Mandate Not Due
EXPIRED_MANDATE	063	Expired Mandate
INTEGRATION_AMOUNT	064	Amount supplied is low
INVALID_SUB_MERCHANT_SERVICES	065	Sub Merchant not premited to proces Service Type
MANDATE_DEACTIVATED	066	Mandate Deactivated
DIRECTDEBIT	067	Only Direct Debit Mandate Allowed
WALLET_ERROR	068	Wallet Could not be Validated
NEW	069	New Transaction
AWAITING_DEBIT	070	Awaiting Debit
UNDERGOING_BANK_PROCESSING	071	Undergoing Bank Processing
PENDING_CREDIT	072	Pending Credit
INVALID_MANDATE_TYPE	073	Invalid Mandate Type
NO_AVAILABLE_RECORD	074	NO AVAILABLE RECORD
ALREADY_ACTIVATED	075	Mandate is Already Active
MANDATE_MAX_NUMBER_ERROR	076	Mandate Maximum Number of Times Exceeded
UNKNOWN_ACCOUNT	081	Unknown account
ACCOUNT_ALREADY_DEACTIVATED	082	Account Already Deactivated
ACCOUNT_ALREADY_EXIST	082	Account Already Exist
INVALID_TIN	083	Invalid Tin Number
INVALID_TOTAL_LINE_ITEMS_AMOUNT	084	Total Amount Does not Match with Line Items Amount
ACCOUNT_NOT_LINKED_WITH_MERCHANT	085	Bank account not linked with merchant
ACCOUNT_NOT_ACTIVE	086	Bank account not active
DUPLICATE_CHARGE_FEE	087	More than one chargeFee set to true
CHARGE_FEE_NOT_SET	088	ChargeFee not set
UNMATCH_AMOUNT	089	Amount does not match
INVALID_AMOUNT	090	Invalid total or beneficiary amount
UNPROFILED_ACCOUNT_WITH_BANK_CODE	091	Beneficiary Account Number is not profiled with supplied bank code on Remita
INVALID_RESPONSE_URL	092	ResponseUrl is Empty;
ERROR_PROCESSING_REQUEST	25	Error Processing Request
DEACTIVATED	659	Deactivated
CHANNEL_RESPONSE_UNMAPPED	997	Payment Gateway Unsucessful
INTERNAL_ERROR	998	An internal Error Occured
UNKNOWN	999	Unknown Error

","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"542f2e2e-204e-4112-9b27-2fd9f8e6d065"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"b989129a-e884-4818-bae5-b65d088c5fd0"}}],"_postman_id":"6931767a-9b69-4207-b4fd-c305728a059e"}],"id":"7a9076fe-230c-41d9-b15f-fdbfcb086de2","description":"

Target Audience: Merchants

Authentication: Click HERE

Our Invoice Generation APIs allow you create payment references that can be sent to users to make payments in your favor.

We usually call these payment reference a Remita Retrieval Reference (RRR). The RRR created will contain all the necessary information as regards the invoice- The name of the payer and their contact details, what they are paying for, for how much etc.

\n","_postman_id":"7a9076fe-230c-41d9-b15f-fdbfcb086de2"},{"name":"Direct Debit (For Non-Financial Institutions)","item":[{"name":"Generate Mandates","item":[{"name":"Generate Fixed Debit Mandate","event":[{"listen":"test","script":{"id":"aa29c82b-567a-4739-ac0e-b80009312630","exec":["var resBody=responseBody;","if(resBody.startsWith('jsonp')){"," resBody=resBody.substring(7,resBody.length-1);","}","var data = JSON.parse(resBody);","","pm.collectionVariables.set(\"mandateId_DD\",data.mandateId);","pm.collectionVariables.set(\"requestId_DD\",data.requestId);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"5b8d5a65-71ab-47be-a3e6-9f2777ed9aab","exec":["const CryptoJS = require('crypto-js');","","","var startDate = new Date(); // Current date","var startDay = startDate.getDate();","var startMonth = startDate.getMonth() + 1; // Months are zero-based","var startYear = startDate.getFullYear();","","// Set the end date 6 months later","var endDate = new Date(startYear, startMonth - 1 + 6, startDay); // Adding 6 months to the start date","var endDay = endDate.getDate();","var endMonth = endDate.getMonth() + 1; // Months are zero-based","var endYear = endDate.getFullYear();","","// Format the dates as \"dd/mm/yyyy\" with leading zeros for single-digit months and days","var formattedStartDate = `${startDay.toString().padStart(2, '0')}/${startMonth.toString().padStart(2, '0')}/${startYear}`;","var formattedEndDate = `${endDay.toString().padStart(2, '0')}/${endMonth.toString().padStart(2, '0')}/${endYear}`;","","","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var serviceTypeId_DD = pm.collectionVariables.get(\"serviceTypeId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var amount = \"10000\";","var d = new Date();","var requestId = d.getTime();","//var requestId = 739981774;","var hash = CryptoJS.SHA512(merchantId_DD + serviceTypeId_DD + requestId + amount + apiKey_DD).toString(CryptoJS.enc.Hex);","","","pm.collectionVariables.set('merchantId_DD', merchantId_DD);","pm.collectionVariables.set('serviceTypeId_DD', serviceTypeId_DD);","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('hash', hash);","pm.collectionVariables.set('amount', amount);","pm.collectionVariables.set(\"startDate\", formattedStartDate);","pm.collectionVariables.set(\"endDate\", formattedEndDate);","pm.collectionVariables.set(\"apiKey_DD\", apiKey_DD);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"97f65ec3-2c70-4a7e-ad9a-0da9ec2e0713","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"serviceTypeId\":\"\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"payerName\":\"John Doe\",\r\n \"payerEmail\":\"john.doe@mailinator.com\",\r\n \"payerPhone\":\"08082278899\",\r\n \"payerBankCode\":\"057\",\r\n \"payerAccount\":\"0100034932\",\r\n \"requestId\":\"1751533484929\",\r\n \"amount\":\"10000\",\r\n \"startDate\":\"03/07/2025\",\r\n \"endDate\":\"03/01/2026\",\r\n \"mandateType\":\"SO\",\r\n \"frequency\": \"Month\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/setup","description":"

In this scenario, the payer will be debited a pre-defined fixed amount on a fixed interval. For instance, the payer could be debited ₦15,000 on a monthly basis.

Request Body

merchantId (text): The ID of the merchant initiating the mandate setup.
\n
serviceTypeId (text): The type of service for the mandate setup.
\n
hash (text): The SHA-512 encryption of merchantId + serviceTypeId + requestId + mandateAmount + apiKey.
\n
payerName (text): The name of the payer.
\n
payerEmail (text): The email address of the payer.
\n
payerPhone (text): The phone number of the payer.
\n
payerBankCode (text): The bank code of the payer.
\n
payerAccount (text): The account number of the payer.
\n
requestId (text): The unique ID for the request.
\n
amount (text): The amount to be debited from the payer's account.
\n
startDate (text): The start date for the mandate.
\n
endDate (text): The end date for the mandate.
\n
mandateType (text): The type of mandate.
\n
frequency (text): The frequency of the mandate.
\n

Response

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"statuscode\": {\n      \"type\": \"string\"\n    },\n    \"requestId\": {\n      \"type\": \"string\"\n    },\n    \"mandateId\": {\n      \"type\": \"string\"\n    },\n    \"status\": {\n      \"type\": \"string\"\n    }\n  }\n}\n\n

See Field Definitions Here

\n","urlObject":{"path":["echannelsvc","echannel","mandate","setup"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"f07561e1-ee2c-4c49-92eb-1bdbc61ae0e7","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"serviceTypeId\":\"\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"payerName\":\"John Doe\",\r\n \"payerEmail\":\"john.doe@mailinator.com\",\r\n \"payerPhone\":\"08082278899\",\r\n \"payerBankCode\":\"057\",\r\n \"payerAccount\":\"0100034932\",\r\n \"requestId\":\"1751533484929\",\r\n \"amount\":\"10000\",\r\n \"startDate\":\"03/07/2025\",\r\n \"endDate\":\"03/01/2026\",\r\n \"mandateType\":\"SO\",\r\n \"frequency\": \"Month\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/setup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sat, 26 Oct 2024 16:37:01 GMT"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"8d8bde56beb25351-LOS"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"040\",\n \"requestId\": \"1729960619854\",\n \"mandateId\": \"130798919021\",\n \"status\": \"Initail Request OK\"\n}"}],"_postman_id":"97f65ec3-2c70-4a7e-ad9a-0da9ec2e0713"},{"name":"Generate Variable Debit Mandate","event":[{"listen":"test","script":{"id":"aa29c82b-567a-4739-ac0e-b80009312630","exec":["var resBody=responseBody;","if(resBody.startsWith('jsonp')){"," resBody=resBody.substring(7,resBody.length-1);","}","var data = JSON.parse(resBody);","","pm.collectionVariables.set(\"mandateId_DD\",data.mandateId);","pm.collectionVariables.set(\"requestId_DD\",data.requestId);",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"5b8d5a65-71ab-47be-a3e6-9f2777ed9aab","exec":["const CryptoJS = require('crypto-js');","","","var startDate = new Date(); // Current date","var startDay = startDate.getDate();","var startMonth = startDate.getMonth() + 1; // Months are zero-based","var startYear = startDate.getFullYear();","","// Set the end date 6 months later","var endDate = new Date(startYear, startMonth - 1 + 6, startDay); // Adding 6 months to the start date","var endDay = endDate.getDate();","var endMonth = endDate.getMonth() + 1; // Months are zero-based","var endYear = endDate.getFullYear();","","// Format the dates as \"dd/mm/yyyy\" with leading zeros for single-digit months and days","var formattedStartDate = `${startDay.toString().padStart(2, '0')}/${startMonth.toString().padStart(2, '0')}/${startYear}`;","var formattedEndDate = `${endDay.toString().padStart(2, '0')}/${endMonth.toString().padStart(2, '0')}/${endYear}`;","","","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var serviceTypeId_DD = pm.collectionVariables.get(\"serviceTypeId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var amount = \"10000\";","var d = new Date();","var requestId = d.getTime();","//var requestId = 739981774;","var hash = CryptoJS.SHA512(merchantId_DD + serviceTypeId_DD + requestId + amount + apiKey_DD).toString(CryptoJS.enc.Hex);","","","pm.collectionVariables.set('merchantId_DD', merchantId_DD);","pm.collectionVariables.set('serviceTypeId_DD', serviceTypeId_DD);","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('hash', hash);","pm.collectionVariables.set('amount', amount);","pm.collectionVariables.set(\"startDate\", formattedStartDate);","pm.collectionVariables.set(\"endDate\", formattedEndDate);","pm.collectionVariables.set(\"apiKey_DD\", apiKey_DD);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"a2bf3ee6-0a86-4c22-96b1-302067ecc1a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"serviceTypeId\": \"\",\r\n \"hash\": \"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"payerName\": \"John Doe\",\r\n \"payerEmail\": \"john.doe@mailinator.com\",\r\n \"payerPhone\": \"08082278899\",\r\n \"payerBankCode\": \"057\",\r\n \"payerAccount\": \"0100034932\",\r\n \"requestId\": \"1751533484929\",\r\n \"amount\": \"10000\",\r\n \"startDate\": \"03/07/2025\",\r\n \"endDate\": \"03/01/2026\",\r\n \"mandateType\": \"DD\",\r\n \"maxNoOfDebits\": \"6\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/setup","description":"

This endpoint is used to set up a mandate for direct debit. The request body should be in JSON format and include the following parameters:

merchantId (String): The ID of the merchant.
\n
serviceTypeId (String): The ID of the service type.
\n
hash (String): The SHA-512 encryption of merchantId + serviceTypeId + requestId + mandateAmount + apiKey.
\n
payerName (String): The name of the payer.
\n
payerEmail (String): The email of the payer.
\n
payerPhone (String): The phone number of the payer.
\n
payerBankCode (String): The code of the payer's bank.
\n
payerAccount (String): The account number of the payer.
\n
requestId (String): The ID of the request.
\n
amount (String): The amount of the mandate.
\n
startDate (String): The start date of the mandate.
\n
endDate (String): The end date of the mandate.
\n
mandateType (String): The type of mandate, in this case, \"DD\".
\n
maxNoOfDebits (String): The maximum number of debits allowed.
\n

Response

The response of this request is a JSON schema with the following properties:

statuscode (String): The status code of the response.
\n
requestId (String): The ID of the request.
\n
mandateId (String): The ID of the generated mandate.
\n
status (String): The status message of the request.
\n

Example

{\n  \"statuscode\": \"\",\n  \"requestId\": \"\",\n  \"mandateId\": \"\",\n  \"status\": \"\"\n}\n\n

In this scenario, the amount and frequency that the payer will be debited may vary, but will be bound by a maximum amount that the payer can be debited in a calendar month and a maximum number of times that the payer is debited in a calendar month. Please note that a Mandate ID would be mapped to the generated mandate for reference.

For more details, refer to the Field Definitions.

A mandate is generated to define the terms of the debit. There are two types of mandates that can be created- a fixed debit mandate and a variable debit mandate.

\n","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"65a365be-a275-447f-9c1a-142a16d61ff6"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"6d3ac9d4-cb13-433f-8d0d-329f160975dd"}}],"_postman_id":"8a00129d-00f3-437a-bc31-1fbc6be58948"},{"name":"Activate Mandate","item":[{"name":"Self Activation","item":[{"name":"OTP Activation [Initiate]","event":[{"listen":"test","script":{"id":"2339e235-b454-44d2-bec1-65b16616310f","exec":["var resBody=responseBody;\r","if(resBody.startsWith('jsonp')){\r"," resBody=resBody.substring(7,resBody.length-1);\r","}\r","var data = JSON.parse(resBody);\r","pm.collectionVariables.set(\"remitaTransRef\",data.remitaTransRef);\r",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"35f81360-4ff2-4a14-b1f8-b15798a58bf2","exec":["const CryptoJS = require('crypto-js');","","","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var apiToken = pm.collectionVariables.get(\"apiToken\");","","var d = new Date();","var requestId = d.getTime();","var apiHash = CryptoJS.SHA512(apiKey_DD + requestId + apiToken).toString(CryptoJS.enc.Hex);","","var dd = d.getDate();","var mm = d.getMonth() + 1; //January is 0!","var yyyy = d.getFullYear();","if (dd < 10) {"," dd = '0' + dd;","}","if (mm < 10) {"," mm = '0' + mm;","}","var hours = d.getUTCHours();","var minutes = d.getUTCMinutes();","var seconds = d.getUTCSeconds();","var timeStamp = yyyy + '-' + mm + '-' + dd + 'T' + hours + ':' + minutes + ':' + seconds + '+000000';","","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('apiHash', apiHash);","pm.collectionVariables.set('timeStamp', timeStamp);","","console.log(apiKey_DD);","console.log(apiToken);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"86528f5b-1ddf-4a01-b3c9-4578bd7ed1ab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"MERCHANT_ID","value":""},{"key":"API_KEY","value":""},{"key":"REQUEST_ID","value":"1751533484929"},{"key":"REQUEST_TS","value":"2025-07-03T8:46:45+000000"},{"key":"API_DETAILS_HASH","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\":\"180799091923\",\r\n \"requestId\":\"1751532065837\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/requestAuthorization","description":"

Request Description

This HTTP POST request is used to trigger the Payer's bank to send their requirements for automated mandate activation. The payload is sent in the raw request body type with the following parameters:

{\n  \"mandateId\": \"180799091923\",\n  \"requestId\": \"1751532065837\"\n}\n\n

The apiHash is the SHA-512 encryption of the concatenation of apiKey + requestId + apiToken.

Response

The response of this request is in the form of a JSON schema:

{\n  \"statuscode\": \"00\",\n  \"authParams\": [\n    {\n      \"description2\": \"Please specify the last 4 digits of your bank card\",\n      \"label1\": \"One Time Password\",\n      \"param1\": \"OTP\",\n      \"label2\": \"Card\",\n      \"description1\": \"Please enter your Bank OTP\",\n      \"param2\": \"CARD\"\n    }\n  ],\n  \"requestId\": \"1729968521795\",\n  \"mandateId\": \"200798919034\",\n  \"remitaTransRef\": \"1729968531931\",\n  \"status\": \"SUCCESS\"\n}\n\n

For more details and field definitions, refer to the Field Definitions Here.

\n","urlObject":{"path":["echannelsvc","echannel","mandate","requestAuthorization"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"49b030eb-0b9e-4a1b-9d87-ed6a0fa93a5c","name":"MandateActivateRequestOtp","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"MERCHANT_ID","value":""},{"key":"API_KEY","value":""},{"key":"REQUEST_ID","value":"1751533484929"},{"key":"REQUEST_TS","value":"2025-07-03T8:46:45+000000"},{"key":"API_DETAILS_HASH","value":"{{hash_OTPREQ}}"}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\":\"180799091923\",\r\n \"requestId\":\"1751533484929\"\r\n}"},"url":"{{baseUrl_Post}}/requestAuthorization"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:02:24 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"67"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"jsonp({\r\n \"statuscode\":\"00\",\r\n \"authParams\":[{\r\n \"description2\":\"Please specify the last 4 digits of your bank card\",\r\n \"label1\":\"One Time Password\",\r\n \"param1\":\"OTP\",\r\n \"label2\":\"Card\",\r\n \"description1\":\"Please enter your Bank OTP\",\r\n \"param2\":\"CARD\"\r\n }],\r\n \"requestId\":\"1665010268868\",\r\n \"mandateId\":\"210009070624\",\r\n \"remitaTransRef\":\"1674447469506\",\r\n \"status\":\"SUCCESS\"})"}],"_postman_id":"86528f5b-1ddf-4a01-b3c9-4578bd7ed1ab"},{"name":"OTP Activation [Validate]","event":[{"listen":"prerequest","script":{"id":"dfca6bb3-eccb-4c11-9bba-877cd11066dc","exec":["const CryptoJS = require('crypto-js');","","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var apiToken = pm.collectionVariables.get(\"apiToken\");","","var d = new Date();","var requestId = d.getTime();","var apiHash = CryptoJS.SHA512(apiKey_DD + requestId + apiToken).toString(CryptoJS.enc.Hex);","","var dd = d.getDate();","var mm = d.getMonth() + 1; //January is 0!","var yyyy = d.getFullYear();","if (dd < 10) {"," dd = '0' + dd;","}","if (mm < 10) {"," mm = '0' + mm;","}","var hours = d.getUTCHours();","var minutes = d.getUTCMinutes();","var seconds = d.getUTCSeconds();","var timeStamp = yyyy + '-' + mm + '-' + dd + 'T' + hours + ':' + minutes + ':' + seconds + '+000000';","","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('apiHash', apiHash);","pm.collectionVariables.set('timeStamp', timeStamp);","","console.log(apiKey_DD);","console.log(apiToken);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"d400ea19-e93c-4a1d-a92a-debab4a9e050","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"MERCHANT_ID","value":""},{"key":"API_KEY","value":""},{"key":"REQUEST_ID","value":"1751533484929"},{"key":"REQUEST_TS","value":"2025-07-03T8:46:45+000000"},{"key":"API_DETAILS_HASH","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{\r\n \"remitaTransRef\": \"1751532401042\",\r\n \"authParams\": [\r\n {\r\n \"param1\": \"OTP\",\r\n \"value\": \"1234\"\r\n },\r\n {\r\n \"param2\": \"CARD\",\r\n \"value\": \"0441234567890\"\r\n }\r\n ]\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/validateAuthorization","description":"

Validate Authorization

This endpoint is used to validate the authorization for an automated mandate activation.

Request Body

remitaTransRef (string): The Remita transaction reference.
\n
authParams (array):
\n
- param1 (string): The type of authorization parameter (e.g., OTP).
  \n
- value (string): The value of the authorization parameter.
  \n
\n

Response

statuscode (string): The status code of the response.
\n
mandateId (string): The ID of the mandate.
\n
status (string): The status message indicating the result of the mandate activation.
\n

Example

Request Body:

{\n  \"remitaTransRef\": \"1751532401042\",\n  \"authParams\": [\n    {\n      \"param1\": \"OTP\",\n      \"value\": \"1234\"\n    }\n  ]\n}\n\n

Response:

{\n  \"statuscode\": \"00\",\n  \"mandateId\": \"200798919034\",\n  \"status\": \"Mandate Activated Successfully\"\n}\n\n

Additional Information

The apiHash mentioned in the existing description is the SHA-512 encryption of the concatenation of apiKey + requestId + apiToken. For field definitions, refer to the API Documentation.

\n","urlObject":{"path":["echannelsvc","echannel","mandate","validateAuthorization"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"263ea049-546f-4715-89eb-043e9e75b025","name":"MandateActivateValidateOtp","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"MERCHANT_ID","value":""},{"key":"API_KEY","value":""},{"key":"REQUEST_ID","value":"1751533484929"},{"key":"REQUEST_TS","value":"2025-07-03T8:46:45+000000"},{"key":"API_DETAILS_HASH","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"}],"body":{"mode":"raw","raw":"{\r\n \"remitaTransRef\": \"1751532401042\", \r\n \"authParams\": [\r\n { \r\n \"param1\": \"OTP\",\r\n \"value\": \"1234\"\r\n },\r\n { \r\n \"param2\": \"CARD\",\r\n \"value\": \"0441234567890\"\r\n }\r\n ]\r\n}"},"url":"{{baseUrl_Post}}/validateAuthorization"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:06:41 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"67"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\r\n\"statuscode\":\"00\", \r\n\"mandateId\":\"320007740693\",\r\n\"status\":\"Mandate Activated Successfully\"\r\n}\r\n"}],"_postman_id":"d400ea19-e93c-4a1d-a92a-debab4a9e050"}],"id":"43f5ea00-27e5-41ac-892b-23e96c643307","description":"

This method means that the payer can activate the mandate through through your application. You will be able to initiate and validate an OTP request between the payer and their bank on your platform.

This method is only available for

Personal Bank Accounts, and
\n
For a select number of banks
\n

List of banks that allow self activation are as follows

First City Monument Bank (FCMB)
\n
Zenith Bank
\n
Fidelity Bank
\n
Keystone Bank
\n
Jaiz Bank
\n
Providus Bank
\n
Heritage Bank
\n
Unity Bank
\n

\n","_postman_id":"43f5ea00-27e5-41ac-892b-23e96c643307"},{"name":"PrintMandate","event":[{"listen":"prerequest","script":{"id":"1fca6e26-2f1b-4c1d-a10c-4c67b90c6f6d","exec":["const CryptoJS = require('crypto-js');","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var requestId_Mandate = pm.collectionVariables.get(\"requestId_DD\");","var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","var hash = CryptoJS.SHA512(merchantId_DD + apiKey_DD + requestId_Mandate).toString(CryptoJS.enc.Hex);","","pm.collectionVariables.set('merchantID_DD', merchantId_DD);","pm.collectionVariables.set('mandateId_DD', mandateId);","pm.collectionVariables.set('requestId_DD', requestId_Mandate);","pm.collectionVariables.set('hash', hash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"75fb9430-feb6-443e-9cf4-e1cfea5c88b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json"}],"url":"https://demo.remita.net/remita/ecomm/mandate/form//b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69/180799091923/1751532065837/rest.reg","description":"

This endpoint is used to generate a mandate form for customers to authorize the generated mandate.

The mandate form can be used by customers in the following categories:

Payers whose funding bank is domiciled in all commercial and some enabled microfinance banks.
\n
Payers whose funding account is a corporate account.
\n

Such payers will need to take a printed and signed mandate to their bank branch (or send through their account manager) for activation before direct debit instructions on the mandate can be issued successfully.

The URL in this GET request will return a form that the payer can print and sign for use by their bank in activating the mandate.

Request Body

This request does not contain a request body.

Response Body

{\n    \"status\": \"200\",\n    \"content-type\": \"text/html\",\n    \"html\": \"<!DOCTYPE html>\\n<html>\\n<head>\\n<link href=\\\"/remita/res/app-resources/custom/css/poster.css\\\" rel=\\\"stylesheet\\\" type=\\\"text/css\\\" />\\n</head>\\n<body>\\n\\t<div class=&#x27;preserveHtml&#x27; class=\\\"container-fluid\\\">\\n\\t\\t<div class=&#x27;preserveHtml&#x27; class=\\\"row\\\">\\n\\t\\t\\t<div class=&#x27;preserveHtml&#x27; class=\\\"col-xs-12 col-lg-4 col-lg-offset-4 col-md-6 col-md-offset-3 col-sm-8 col-sm-offset-2\\\">\\n\\t\\t\\t\\t<div class=&#x27;preserveHtml&#x27; id=\\\"content\\\">\\n\\t\\t\\t\\t\\t<h1 class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>Loading Payment Mandate Form. Please wait...</h1>\\n\\t\\t\\t\\t\\t<div class=&#x27;preserveHtml&#x27; id=\\\"dvLoading\\\"></div>\\n\\t\\t\\t\\t\\t<span class=\\\"plan-b\\\"> If this Page does not redirect In 5 Seconds, click the <strong class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;>button</b> below.\\n\\t\\t\\t\\t\\t</span>\\n\\t\\t\\t\\t\\t<form id=\\\"redirectpay\\\" action=\\\"https://demo.remita.net/remita/onepage/api/v1/so.spa\\\" method=\\\"post\\\">\\n\\t\\t\\t\\t\\t\\t\\n\\t\\t\\t\\t\\t\\t\\t<input type=\\\"hidden\\\" name=\\\"rrr\\\" value=\\\"200798919034\\\" />\\n\\t\\t\\t\\t\\t\\t\\n\\t\\t\\t\\t\\t\\t<input type=\\\"submit\\\" class=\\\"poster-btn poster-btn-warning\\\" value=&#x27;Send For Payment&#x27; onclick=\\\"myfunc()\\\" />\\n\\t\\t\\t\\t\\t</form>\\n\\n\\t\\t\\t\\t</div>\\n\\t\\t\\t</div>\\n\\t\\t</div>\\n\\t</div>\\n</body>\\n<script type=\\\"text/javascript\\\" src=\\\"/remita/res/app-resources/custom/js/poster.js\\\">\\n\\t\\n</script>\\n<script type=\\\"text/javascript\\\">\\n\\twindow.onload = posterObj.postForm(\\\"redirectpay\\\");\\n</script>\\n</html>\"\n}\n\n

For field definitions, refer to the API documentation.

\n","urlObject":{"path":["mandate","form","","b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69","180799091923","1751532065837","rest.reg"],"host":["https://demo.remita.net/remita/ecomm"],"query":[],"variable":[]}},"response":[],"_postman_id":"75fb9430-feb6-443e-9cf4-e1cfea5c88b8"}],"id":"329c3b08-41eb-43ec-bbcb-2c7c5a2ac98f","description":"

Mandate activation can presently be done via one of two methods- Self Activation and Bank Activation

Bank Activation: This method means that a mandate form will be printed and shared with the payer to present to their bank for activation.

\n","_postman_id":"329c3b08-41eb-43ec-bbcb-2c7c5a2ac98f"},{"name":"Mandate Operations","item":[{"name":"Debit Instruction","event":[{"listen":"test","script":{"id":"f6ea7450-fe57-4e47-a0ee-ac7d4b828694","exec":["var resBody=responseBody;\r","if(resBody.startsWith('jsonp')){\r"," resBody=resBody.substring(7,resBody.length-1);\r","}\r","var data = JSON.parse(resBody);\r","pm.collectionVariables.set(\"transactionRef\",data.transactionRef);\r","pm.collectionVariables.set(\"requestId_debit\",data.requestId);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"a1b8a2a2-c5c6-426e-a4b5-e33686cb8350","exec":["const CryptoJS = require('crypto-js');","","var debitAmount = \"200\";","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var serviceTypeId_DD = pm.collectionVariables.get(\"serviceTypeId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var d = new Date();","var requestId = d.getTime();","var hash = CryptoJS.SHA512(merchantId_DD + serviceTypeId_DD + requestId + debitAmount + apiKey_DD).toString(CryptoJS.enc.Hex);","","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('debitAmount', debitAmount);","pm.collectionVariables.set('apiHash', hash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"b373c481-1b0e-4de4-91a3-633717b13971","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"serviceTypeId\":\"\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"requestId\":\"1751533484929\",\r\n \"totalAmount\":\"200\",\r\n \"mandateId\":\"180799091923\",\r\n \"fundingAccount\":\"0100034932\",\r\n \"fundingBankCode\":\"057\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/payment/send","description":"

This API endpoint allows you to send debit instructions within the agreed mandate once a payer's mandate has been activated.

Request Body

merchantId (string): The ID of the merchant.
\n
serviceTypeId (string): The ID of the service type.
\n
hash (string): SHA-512 encryption of the concatenation of merchnatId + serviceTypeId + requestId + debitAmount + apiKey.
\n
requestId (string): The ID of the request.
\n
totalAmount (string): The total amount for the debit.
\n
mandateId (string): The ID of the mandate.
\n
fundingAccount (string): The funding account for the debit.
\n
fundingBankCode (string): The bank code for the funding account.
\n

Response (JSON Schema)

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"statuscode\": { \"type\": \"string\" },\n    \"RRR\": { \"type\": \"string\" },\n    \"requestId\": { \"type\": \"string\" },\n    \"mandateId\": { \"type\": \"string\" },\n    \"transactionRef\": { \"type\": \"number\" },\n    \"status\": { \"type\": \"string\" }\n  }\n}\n\n

See Field Definitions Here

\n","urlObject":{"path":["echannelsvc","echannel","mandate","payment","send"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"d621498f-27d2-4ae8-9a5a-4971c84b4592","name":"SendDebitInstruction","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"serviceTypeId\":\"\",\r\n \"hash\":\"{{hash_debitGo}}\",\r\n \"requestId\":\"73298\",\r\n \"totalAmount\":\"200\",\r\n \"mandateId\":\"180799091923\",\r\n \"fundingAccount\":\"1245125478\",\r\n \"fundingBankCode\":\"057\"\r\n} "},"url":"{{baseUrl_Post}}/payment/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:16:15 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"156"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"069\",\n \"RRR\": \"270007740695\",\n \"requestId\": \"1554718571377\",\n \"mandateId\": \"320007740693\",\n \"transactionRef\": 7740695,\n \"status\": \"New Transaction\"\n}"}],"_postman_id":"b373c481-1b0e-4de4-91a3-633717b13971"},{"name":"Stop Mandate","event":[{"listen":"prerequest","script":{"id":"62504085-1986-41b2-9513-bbc207a23464","exec":["const CryptoJS = require('crypto-js');","","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","","var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","var requestId_Mandate = pm.collectionVariables.get(\"requestId_DD\");","var hash = String(CryptoJS.SHA512(mandateId + merchantId_DD + requestId_Mandate + apiKey_DD)).toString(CryptoJS.enc.Hex);","","pm.collectionVariables.set('apiHash', hash);","","","console.log(merchantId_DD);","console.log(mandateId);","console.log(requestId_Mandate);","console.log(apiKey_DD);","","// \"mandateId\": \"200798919034\",","// \"requestId\": \"1729968521795\",",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"f49b5392-0a82-4956-b879-b0911b50f50b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"mandateId\":\"180799091923\",\r\n \"requestId\":\"1751532065837\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/stop","urlObject":{"path":["echannelsvc","echannel","mandate","stop"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"05d7a765-ca87-4de2-9179-2eec739d6911","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"hash\":\"{{hash_mandateStop}}\",\r\n \"mandateId\":\"180799091923\",\r\n \"requestId\":\"{{requestId_mandate}}\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/stop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 24 Jan 2021 00:36:26 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"104"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"00\",\n \"requestId\": \"1611447139190\",\n \"mandateId\": \"280008103474\",\n \"status\": \"Successful\"\n}"}],"_postman_id":"f49b5392-0a82-4956-b879-b0911b50f50b"}],"id":"bef61489-af96-4934-9c7d-9c3bac2f7920","description":"

To operate a mandate, the Merchant can initiate debit (where the mandate is for a Variable Debit arrangement), or Stop the Mandate if needs be

\n","_postman_id":"bef61489-af96-4934-9c7d-9c3bac2f7920"},{"name":"Check Status and Webhook Notifications","item":[{"name":"MandateStatus","event":[{"listen":"prerequest","script":{"id":"7f998d23-b2fa-49ff-8e2b-57839e88d054","exec":["const CryptoJS = require('crypto-js');","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","","var requestId_Mandate = pm.collectionVariables.get(\"requestId_DD\");","var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","var hash = CryptoJS.SHA512(mandateId + merchantId_DD + requestId_Mandate + apiKey_DD).toString(CryptoJS.enc.Hex);","","pm.collectionVariables.set(\"merchantId_DD\", merchantId_DD);","pm.collectionVariables.set(\"mandateId\", mandateId);","pm.collectionVariables.set(\"requestId_Mandate\", requestId_Mandate);","pm.collectionVariables.set(\"hash\", hash);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"b01628e2-1928-4aac-ac57-890bc73c3264","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"mandateId\":\"180799091923\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"requestId\":\"1751532065837\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/status","description":"

Request

This API endpoint is used to check the status of a Payer's mandate. It is particularly useful when the mandate is not being activated immediately via OTP.

Request Body

merchantId (string): The ID of the merchant.
\n
mandateId (string): The ID of the mandate.
\n
hash (string): The SHA-512 encryption of the concatenation of mandateId + merchantId + requestId + apiKey.
\n
requestId (string): The unique ID of the request.
\n

Response

The API returns a JSON response with the following schema:

{\n    \"type\": \"object\",\n    \"properties\": {\n        \"statuscode\": {\n            \"type\": \"string\"\n        },\n        \"endDate\": {\n            \"type\": \"string\"\n        },\n        \"requestId\": {\n            \"type\": \"string\"\n        },\n        \"mandateId\": {\n            \"type\": \"string\"\n        },\n        \"registrationDate\": {\n            \"type\": \"string\"\n        },\n        \"isActive\": {\n            \"type\": \"boolean\"\n        },\n        \"startDate\": {\n            \"type\": \"string\"\n        },\n        \"status\": {\n            \"type\": \"string\"\n        }\n    }\n}\n\n

Field Definitions

\n","urlObject":{"path":["echannelsvc","echannel","mandate","status"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"33567709-f6e6-4639-bf4f-6d08f418a28e","name":"MandateStatus","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","type":"text"}],"url":"https://remitademo.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:13:46 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"Content-Length","value":"189"},{"key":"Set-Cookie","value":"JSESSIONID=ipOo47PB-GLbCUf30NMFgMY_.remngapp1; path=/remita"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"jsonp ({\n \"statuscode\": \"00\",\n \"endDate\": \"18/01/2023\",\n \"requestId\": \"1660827670301\",\n \"mandateId\": \"340008773344\",\n \"registrationDate\": \"18/08/2022\",\n \"isActive\": true,\n \"startDate\": \"18/08/2022\",\n \"status\": \"Successful\"\n})"}],"_postman_id":"b01628e2-1928-4aac-ac57-890bc73c3264"},{"name":"Debit Status","event":[{"listen":"prerequest","script":{"id":"28679929-491b-4f42-b9a2-31fb0dca1df4","exec":["const CryptoJS = require('crypto-js');","","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","var requestId_debit = pm.environment.get(\"requestId_debit\");","var d = new Date();","//var requestId = d.getTime();","var hash = CryptoJS.SHA512(mandateId + merchantId_DD + requestId_debit + apiKey_DD).toString(CryptoJS.enc.Hex);","","pm.collectionVariables.set('requestId_debit',requestId_debit);","pm.collectionVariables.set('apiHash', hash);","","// var merchantId_DD = pm.environment.get(\"merchantId_DD\");","// var apiKey_DD = pm.environment.get(\"apiKey_DD\");","// var requestId_Mandate = pm.collectionVariables.get(\"requestId_DD\");","// var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","// var hash = CryptoJS.SHA512(merchantId_DD + apiKey_DD + requestId_Mandate).toString(CryptoJS.enc.Hex);","","// pm.environment.set('merchantID_DD', merchantId_DD);","// pm.collectionVariables.set('mandateId_DD', mandateId);","// pm.collectionVariables.set('requestId_DD', requestId_Mandate);","// pm.environment.set('hash', hash);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"6d5e7fb2-b621-4dc6-a50b-ee461a23b898","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"mandateId\":\"180799091923\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"requestId\":\"73298\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/payment/status","description":"

This API endpoint allows you to check the status of a specific debit instruction.

Request Body

merchantId (string): The ID of the merchant.
\n
mandateId (string): The ID of the mandate.
\n
hash (string): The SHA-512 encryption of the concatenation of mandateId + merchantId + requestId + apiKey.
\n
requestId (string): The ID of the request.
\n

Response

statuscode (string): The status code of the response.
\n
amount (string): The amount information.
\n
RRR (string): The RRR (Remita Retrieval Reference) information.
\n
requestId (string): The ID of the request.
\n
mandateId (string): The ID of the mandate.
\n
transactionRef (number): The transaction reference.
\n
lastStatusUpdateTime (string): The date and time of the last status update.
\n
status (string): The status of the instruction.
\n

Example Response

{\n    \"statuscode\": \"\",\n    \"amount\": \"\",\n    \"RRR\": \"\",\n    \"requestId\": \"\",\n    \"mandateId\": \"\",\n    \"transactionRef\": 0,\n    \"lastStatusUpdateTime\": \"\",\n    \"status\": \"\"\n}\n\n

For more details, refer to the Field Definitions Here.

\n","urlObject":{"path":["echannelsvc","echannel","mandate","payment","status"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"6baf893c-e5c6-4a9c-a107-be9e1e89a6e0","name":"Debit Status","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"mandateId\":\"180799091923\",\r\n \"hash\":\"{{hash_debitStatus}}\",\r\n \"requestId\":\"73298\"\r\n} "},"url":"{{baseUrl_Post}}/payment/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:17:00 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"216"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"070\",\n \"amount\": \"3000\",\n \"RRR\": \"270007740695\",\n \"requestId\": \"1554718571377\",\n \"mandateId\": \"320007740693\",\n \"transactionRef\": 7740695,\n \"lastStatusUpdateTime\": \"2019-04-08 10:16:15\",\n \"status\": \"Awaiting Debit\"\n}"}],"_postman_id":"6d5e7fb2-b621-4dc6-a50b-ee461a23b898"},{"name":"MandatePaymentHistory","event":[{"listen":"prerequest","script":{"id":"9ed049b6-fce2-483a-afc1-75941bdbfbdd","exec":["var mandateId = pm.collectionVariables.get(\"mandateId_DD\");","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","var requestId = pm.collectionVariables.get(\"requestId_DD\");","var hash = String(CryptoJS.SHA512(mandateId + merchantId_DD + requestId + apiKey_DD));","","pm.collectionVariables.set('apiHash', hash);","",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"ae96d261-ff6f-445a-8f1e-8fa582a33918","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"mandateId\":\"180799091923\",\r\n \"hash\":\"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69\",\r\n \"requestId\":\"1751532065837\"\r\n} "},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/echannelsvc/echannel/mandate/payment/history","description":"

This operation retrieves the payment history for a specific mandate, including details of individual transactions such as amounts, statuses, and timestamps. The response lists the transactions under the mandate, indicating a successful query.

Request Body

The request body should be in raw format and include the following parameters:

merchantId: (string) The ID of the merchant.
\n
mandateId: (string) The ID of the mandate for which the payment history is being retrieved.
\n
hash: (string) The SHA-512 encryption of the concatenation of mandateId + merchantId + requestId + apiKey.
\n
requestId: (string) The ID of the request.
\n

Response

The response for this request provides the payment history for the specified mandate in the form of a JSON schema. It includes the following properties:

statuscode: (string) The status code of the response.
\n
requestId: (string) The ID of the request.
\n
mandateId: (string) The ID of the mandate for which the payment history is provided.
\n
paymentDetails: (array) An array of objects containing details of individual transactions, including amount, last status update time, status, status code, transaction reference, and RRR.
\n
status: (string) The status of the response.
\n

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": {\n      \"type\": \"string\"\n    },\n    \"message\": {\n      \"type\": \"string\"\n    },\n    \"_meta\": {\n      \"type\": \"null\"\n    },\n    \"_links\": {\n      \"type\": \"null\"\n    },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"statuscode\": {\n          \"type\": \"string\"\n        },\n        \"requestId\": {\n          \"type\": \"string\"\n        },\n        \"mandateId\": {\n          \"type\": \"string\"\n        },\n        \"paymentDetails\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"amount\": {\n                \"type\": \"number\"\n              },\n              \"lastStatusUpdateTime\": {\n                \"type\": \"string\"\n              },\n              \"status\": {\n                \"type\": \"string\"\n              },\n              \"statuscode\": {\n                \"type\": \"string\"\n              },\n              \"transactionRef\": {\n                \"type\": \"string\"\n              },\n              \"rrr\": {\n                \"type\": \"string\"\n              }\n            }\n          }\n        },\n        \"status\": {\n          \"type\": \"string\"\n        }\n      }\n    }\n  }\n}\n\n

\n","urlObject":{"path":["echannelsvc","echannel","mandate","payment","history"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"731e9e58-9cbf-49e2-b344-c629d0d44ee4","name":"MandatePaymentHistory","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\":\"\",\r\n \"mandateId\":\"180799091923\",\r\n \"hash\":\"{{hash_mandateHistory}}\",\r\n \"requestId\":\"{{requestId_mandate}}\"\r\n} "},"url":"{{baseUrl_Post}}/payment/history"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 08 Apr 2019 10:19:39 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"text/plain;charset=UTF-8"},{"key":"Content-Length","value":"660"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"}],"cookie":[],"responseTime":null,"body":"{\n \"statuscode\": \"00\",\n \"data\": {\n \"data\": {\n \"totalTransactionCount\": 3,\n \"totalAmount\": 18000,\n \"paymentDetails\": [\n {\n \"amount\": \"3000\",\n \"lastStatusUpdateTime\": \"2019-04-08 10:16:15\",\n \"status\": \"Awaiting Debit\",\n \"statuscode\": \"070\",\n \"RRR\": \"270007740695\",\n \"transactionRef\": \"7740695\"\n },\n {\n \"amount\": \"5000\",\n \"lastStatusUpdateTime\": \"2019-04-08 10:19:18\",\n \"status\": \"Awaiting Debit\",\n \"statuscode\": \"070\",\n \"RRR\": \"290007740696\",\n \"transactionRef\": \"7740696\"\n },\n {\n \"amount\": \"10000\",\n \"lastStatusUpdateTime\": \"2019-04-08 10:19:26\",\n \"status\": \"Awaiting Debit\",\n \"statuscode\": \"070\",\n \"RRR\": \"310007740697\",\n \"transactionRef\": \"7740697\"\n }\n ]\n }\n },\n \"requestId\": \"1554717652141\",\n \"mandateId\": \"320007740693\",\n \"status\": \"RECORD FOUND\"\n}"}],"_postman_id":"ae96d261-ff6f-445a-8f1e-8fa582a33918"},{"name":"Notification on Mandate Activation","id":"d64ed71a-cc4b-4fe2-be6b-77f473eeec9a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"notificationType\": \"ACTIVATION\",\n \"lineItems\": [\n {\n \"mandateId\": \"180799091923\",\n \"activationDate\": \"19/01/2015\",\n \"requestId\": \"{{requestId_DD_Mandate}}\",\n \"startDate\":\"14/07/2021\",\n\t\t\t\"endDate\":\"31/07/2021\",\n \"amount\": \"10000\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{yourListeningUrl}}","description":"

This endpoint is used to activate a direct debit/standing order mandate or a customer's account in your favor. It sends a notification with the specified payload.

Request Body

notificationType (string): Type of notification, in this case, \"ACTIVATION\"
\n
lineItems (array):
\n
- mandateId (string): ID of the mandate to be activated
  \n
- activationDate (string): Date of activation
  \n
- requestId (string): ID of the request
  \n
- startDate (string): Start date of the activation period
  \n
- endDate (string): End date of the activation period
  \n
- amount (string): Amount to be activated
  \n
\n

Example:

{\n  \"notificationType\": \"ACTIVATION\",\n  \"lineItems\": [\n    {\n      \"mandateId\": \"180799091923\",\n      \"activationDate\": \"19/01/2015\",\n      \"requestId\": \"{{requestId_DD_Mandate}}\",\n      \"startDate\": \"14/07/2021\",\n      \"endDate\": \"31/07/2021\",\n      \"amount\": \"10000\"\n    }\n  ]\n}\n\n

Response Body

The response body contains the result of the activation notification.

Example:

{\n  \"status\": \"success\",\n  \"message\": \"Activation notification received and processed successfully\"\n}\n\n

\n","urlObject":{"host":["{{yourListeningUrl}}"],"query":[],"variable":[]}},"response":[{"id":"1a6746b6-c397-47a0-8504-46facc4ebdf5","name":"Expected Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"notificationType\": \"ACTIVATION\",\n \"lineItems\": [\n {\n \"mandateId\": \"180799091923\",\n \"activationDate\": \"19/01/2015\",\n \"requestId\": \"{{requestId_DD_Mandate}}\",\n \"startDate\": \"03/07/2025\",\n \"endDate\": \"03/01/2026\",\n \"amount\": \"20000\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{Your URL}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"OK"}],"_postman_id":"d64ed71a-cc4b-4fe2-be6b-77f473eeec9a"},{"name":"Notification on Debit","id":"87910574-defb-4fe0-9083-7b8e6f143b3e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"notificationType\": \"DEBIT\",\n \"lineItems\": [\n {\n \"mandateId\": \"180799091923\",\n \"debitDate\": \"03/05/2017\",\n \"requestId\": \"73298\",\n \"amount\": \"10000\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{yourListeningUrl}}","description":"

This HTTP POST request is used to send a notification when a debit occurs on one of the mandates. The request body is in raw format and includes the following payload:

{\n  \"notificationType\": \"DEBIT\",\n  \"lineItems\": [\n    {\n      \"mandateId\": \"180799091923\",\n      \"debitDate\": \"03/05/2017\",\n      \"requestId\": \"73298\",\n      \"amount\": \"10000\"\n    }\n  ]\n}\n\n

Response

The response to this request will depend on the specific implementation and the endpoint being used. It may include information confirming the receipt of the notification or any relevant error messages.

\n","urlObject":{"host":["{{yourListeningUrl}}"],"query":[],"variable":[]}},"response":[{"id":"4ae4cd12-05ad-40ae-8016-219ee09628e0","name":"Expected Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"notificationType\": \"DEBIT\",\n \"lineItems\": [\n {\n \"mandateId\": \"180799091923\",\n \"debitDate\": \"03/05/2017\",\n \"requestId\": \"73298\",\n \"amount\": \"20000\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{Your URL}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"OK"}],"_postman_id":"87910574-defb-4fe0-9083-7b8e6f143b3e"}],"id":"bbf5198a-469e-4fee-90ab-c280440efd99","description":"

We have a number of methods through which a user can check the status of their mandates or related transactions.

\n","_postman_id":"bbf5198a-469e-4fee-90ab-c280440efd99"},{"name":"Fields and Descriptions","item":[],"id":"158564ed-4603-4bf4-8087-0a33a1033b44","description":"

Parameter	Type	Description
amount (SetupMandate API)	String	`Required` This is the maximum amount that is to be debited in the Mandate
API_KEY	String	`Required` This is your token for authentication to Remita
authParams Description	String	A Description of the label of the requirement from the Payer's bank for automated mandate activation.
authParams label	String	The label of the requirement from the Payer's bank for automated mandate activation.
customFields name	String	`Optional` This is the name of a Custom field you may have on the service type for which you are colecting on. Read more on Custom fields here
customFields type	String	`Optional` This is represents the data type of said Custom field. You would have selected a data type when creating your cutom field on Remita. Read more on Custom fields here
customFields value	String	`Optional` This is a specific value to a Custom field you may have on the service type for which you are collecting on, e.g. the customer's number with you in a 'Customer Number' custom field. Read more on Custom fields here
endDate	String	`Required` This is when the mandate expires. Direct debit instructions are no longer issuable on it. (Format: DD/MM/YYYY)
fundingAccount	String	`Required` This is the Payer Account Number (this must be same account used to set up the mandate)
fundingBankCode	String	`Required` This is the Payer Bank Code [see Appendix] (this must be same account used to set up the mandate)
hash (CancelDebitInstruction API)	String	`Required` SHA512 hashing of (transactionRef + merchantId + requestId + apiKey)
hash (DebitStatus API)	String	`Required` SHA512 hashing of (mandateId + merchantId + requestId + apiKey)
hash (GenerateMandate API)	String	`Required` SHA512 hashing of (merchantId+serviceTypeId+requestId+amt+api_key)
hash (MandatePaymentHistory API)	String	`Required` SHA512 hashing of (mandateId + merchantId + requestId + apiKey)
hash (MandateStatus API)	String	`Required` SHA512 hashing of (requestId + apiKey + merchantId)
hash (OTPMandateActivation-Request API)	String	`Required` SHA512 hashing of (apiKey + requestId + apiToken)
hash (OTPMandateActivation-Validate API)	String	`Required` SHA512 hashing of (apiKey + requestId + apiToken)
hash (PrintMandate API)	String	`Required` SHA512 hashing of (merchantId + apiKey + requestId)
hash (SendDebitInstruction API)	String	`Required` SHA512 hashing of (merchantId + serviceTypeId + requestId + debitAmount + apiKey)
hash (StopMandate API)	String	`Required` SHA512 hashing of (mandateId + merchantId + requestId + apiKey)
MANDATE_ID	String	`Required` This is the Mandate Id provided by Remita in response to the mandate Setup request
mandateId	String	`Required` ID of the Mandate
mandatetype	String	`Required` This specifies the type of mandate being generated (DD is for Direct Debit).
maxNoOfDebits	String	`Required` This is the Maximum Number of Debits permitted in a calendar month.
MERCHANT_ID	String	`Required` This is the biller identifier
merchantId	String	`Required` This is a unique identifier for the Biller. See credentials section to retrieve
payerAccount	String	`Required` This is the Payer Account Number
payerBankCode	String	`Required` This is the Payer Bank Code (see Bank Codes)
payerEmail	String	`Required` This is the Payer’s Email Address
payerName	String	`Required` This is the name of the customer to be displayed on the payment page.
payerPhone	String	`Required` This is the Payer’s Phone Number
REQUEST_ID	String	`Required` This uniquely identifies a POST request
REQUEST_TS	String	`Required` Request Timestamp in format yyyy-mm-ddThh:mm:ss+000000
requestId	String	`Required` This is your Request Id for the Mandate (for Mandate APIs) or your request ID for Debits (for Debit Instruction APIs)
serviceTypeId	String	`Required` This is a unique identifier for service type receiving the payment. See credentials section to retrieve
startDate	String	`Required` This is when the biller can start to issue direct debit instructions on an active mandate. (Format: DD/MM/YYYY)
status	String	`Required` Status Message
statuscode	String	`Required` Status Code
totalAmount (SendDebitInstruction API)	String	`Required` Amount being debited
transactionRef	String	`Required` This is the Transaction Reference returned by Remita in response to the Debit Instruction request

","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"4bcc4f92-dfad-43ba-ba12-f2c2ecb69965"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"06ab37fb-66e9-4a3e-be47-883022ee7635"}}],"_postman_id":"158564ed-4603-4bf4-8087-0a33a1033b44"},{"name":"Status Codes- Direct Debit","item":[],"id":"df6dc6a1-b230-4ee6-b5ca-ef916f7894d4","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description
00	Transaction Completed Successfully (Record Found)
01	Approved (Direct Debit Instruction Successful)
013	Invalid Hash Value
020	Authentication Error (Invalid User Authentication)
034	Invalid funding Source
035	Payment Limit Exceeded
040	Initail Request OK (Mandate Setup Completed Successfully)
051	No sufficient funds
061	Mandate Not Activated
062	Mandate Not Due
063	Expired Mandate
066	Mandate Deactivated
067	Only Direct Debit Mandate Allowed
069	New Transaction
070	Awaiting Debit
071	Undergoing Bank Processing
072	Pending Credit
073	Invalid Mandate Type
074	No Available Record
075	Mandate Already Active
107	Insufficent Funds

","_postman_id":"df6dc6a1-b230-4ee6-b5ca-ef916f7894d4"}],"id":"4523487b-9338-4d37-84c4-f69423e0bc5e","description":"

Target Audience: Merchants

Authentication: Click HERE

Our Direct Debit mandates will allow you collect repayments from your customers automatically and recurrently for as long as the agreed terms of collections last. To define the terms of collections, you will need to create a mandate- which your customer will have activated to commence the collection arrangement.

Our Direct Debit APIs can be divided into 4 key sections

Genereate Mandate
\n
Activate Mandate
\n
Mandate Operations
\n
Check Status and Webhook Notifications
\n

\n","_postman_id":"4523487b-9338-4d37-84c4-f69423e0bc5e"},{"name":"Direct Debit (For Financial Institutions)","item":[{"name":"Name Inquiry","item":[{"name":"Name Inquiry (Payer)","event":[{"listen":"prerequest","script":{"id":"568e9d18-ea87-4f6a-b1ee-1942202b2e5e","exec":["function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","let bankCode = '035';","let accountNumber = bankCode + randomIntFromInterval(1000000, 9999999);","","pm.collectionVariables.set(\"bankCode\", bankCode);","pm.collectionVariables.set(\"accountNumber\", accountNumber);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"9fa2194f-c2f1-49da-8f8e-de7f750d9ff3","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"payerAccountEnquiryRef\", getResponseValue.data.accountEnquiryReference);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"7f2cd11d-5115-4b4e-83cb-e7d63f08cca0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\",\n \"accountType\": \"PAYER\"\n}\n ","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/name-enquiry","description":"

API Request Description

This endpoint allows users to perform a name enquiry to verify the account details of the payer. The accountEnquiryReference value from the API response will be passed in the request to setup a mandate.

Request Body

accountNumber (string): The account number for which the name enquiry is being performed.
\n
bankCode (string): The bank code of the bank where the account is held.
\n
accountType (string): The type of account, in this case, this will be PAYER.
\n

Response

The response will be in JSON format and will include the following fields:

status (string): The status of the response.
\n
message (string): A message related to the response status.
\n
_meta (null): Additional metadata, if available.
\n
_links (null): Links related to the response, if available.
\n
data (object): An object containing the following fields:
\n
- accountNumber (string): The account number for which the name enquiry was performed.
  \n
- bankCode (string): The bank code of the bank where the account is held.
  \n
- accountName (string): The name associated with the bank account.
  \n
- accountEnquiryReference (string): A reference related to the account enquiry.
  \n
\n

Example Response

{\n  \"status\": \"\",\n  \"message\": \"\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {\n    \"accountNumber\": \"\",\n    \"bankCode\": \"\",\n    \"accountName\": \"\",\n    \"accountEnquiryReference\": \"\"\n  }\n}\n\n

JSON Schema for Response

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": { \"type\": \"string\" },\n    \"message\": { \"type\": \"string\" },\n    \"_meta\": { \"type\": \"null\" },\n    \"_links\": { \"type\": \"null\" },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"accountNumber\": { \"type\": \"string\" },\n        \"bankCode\": { \"type\": \"string\" },\n        \"accountName\": { \"type\": \"string\" },\n        \"accountEnquiryReference\": { \"type\": \"string\" }\n      }\n    }\n  }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","name-enquiry"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"56ffeb2c-6a4a-47c8-b4ff-ca0afd5851ae","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\",\n \"accountType\": \"PAYER\"\n}\n ","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/name-enquiry"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:44:33 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Name enquiry request is successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"accountNumber\": \"0358257510\",\n \"bankCode\": \"035\",\n \"accountName\": \"Willard Allen\",\n \"accountEnquiryReference\": \"1719956673603\"\n }\n}"}],"_postman_id":"7f2cd11d-5115-4b4e-83cb-e7d63f08cca0"},{"name":"Name Inquiry (Beneficiary)","event":[{"listen":"prerequest","script":{"id":"3c48125f-1866-4b08-a64c-f2702c17e8af","exec":["function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","let bankCode = '035';","let accountNumber = bankCode + randomIntFromInterval(1000000, 9999999);","","pm.collectionVariables.set(\"bankCode\", bankCode);","pm.collectionVariables.set(\"accountNumber\", accountNumber);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"9643943d-122e-4d4d-ab75-15373b12c963","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"benAccountEnquiryRef\", getResponseValue.data.accountEnquiryReference);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"33a01a1d-9f75-4891-900f-d2ef16c30f8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"accountNumber\": \"5012284010\",\n \"accountType\": \"BENEFICIARY\"\n}\n ","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/name-enquiry","description":"

Name Enquiry API

This API endpoint is used to perform a name enquiry for the benefeciary account. The accountEnquiryReference value from the API response will be passed in the request to setup a mandate.

There will be no need to pass the Bank code for this request as the bank code will be

the Financial Institutions CBN Bank Code (for Financial Institutions where CBN is their corresponsding bank)
\n
The CBN Bank Code of the Financial Institutions corresponding bank (for Financial Institutions where CBN is not their corresponsding bank)
\n

Request Body

accountNumber (string): The account number for which the name enquiry is to be performed.
\n
accountType (string): The type of account, in this case, this will be BENEFICIARY.
\n

Response

status (string): The status of the name enquiry request.
\n
message (string): Additional information or message related to the name enquiry.
\n
data (object): The object containing the details of the account enquiry response.
\n
- accountNumber (string): The account number for which the name enquiry was performed.
  \n
- bankCode (string): The bank code associated with the account.
  \n
- accountName (string): The name associated with the account.
  \n
- accountEnquiryReference (string): The reference ID for the account enquiry.
  \n
\n

Example Response

{\n    \"status\": \"\",\n    \"message\": \"\",\n    \"_meta\": null,\n    \"_links\": null,\n    \"data\": {\n        \"accountNumber\": \"\",\n        \"bankCode\": \"\",\n        \"accountName\": \"\",\n        \"accountEnquiryReference\": \"\"\n    }\n}\n\n

These endpoints are used to verify the identity of the payer and the beneficiary by retrieving their account names. This helps ensure the correctness of account details before proceeding with transactions or mandate setups.

• Name Enquiry (Payer): Verifies the account name of the payer.

• Name Enquiry (Beneficiary): Verifies the account name of the beneficiary.

\n","_postman_id":"f0f90edc-cd98-4495-843e-5f2b7c728793"},{"name":"Mandate Management","item":[{"name":"Setup Mandate- Fixed Amount","event":[{"listen":"prerequest","script":{"id":"97abc6be-02f9-45c4-b631-22926f1ad008","exec":["// See bottom for sample Sub-Merchant Credentials","function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","let append0 = randomIntFromInterval(10000000000, 99999999999);","let accountNumber = randomIntFromInterval(1000000000, 9999999999);","let append = randomIntFromInterval(10000000, 99999999);","let bvn = randomIntFromInterval(10000000000, 99999999999);","let dob = '03-11-2000';","","","let firstName = pm.variables.replaceIn(\"Percival\")+\"-Test\";","let lastName = pm.variables.replaceIn(\"Douglas\");","let payerName = firstName+\" \"+lastName;","let userName = firstName+\".\"+lastName;","let payerEmail = userName+\"@mailinator.com\";","let payerPhone = \"010\" + append;","","","//Manual Variables","var payerBankCode = \"011\";","var payerAccount = randomIntFromInterval(1000000000, 9999999999);","var mandateAmount = \"96000\";","var mandateType = \"DD\";","var maxNoOfDebits = \"40\";","","var d = new Date();","var transactionId = d.getTime();","var today = d.toDateString();","var day = d.getDate().toString().padStart(2, '0');","var startMonth = (d.getMonth() + 1).toString().padStart(2, '0'); // Months are 0-based, so add 1","var Year = d.getFullYear();","","// Start date in DD/MM/YYYY format","var startDate = day + \"/\" + startMonth + \"/\" + Year;","","// Calculate end date by adding 6 months","var endD = new Date(d);","endD.setMonth(d.getMonth() + 6);","var endDay = endD.getDate().toString().padStart(2, '0');","var endMonth = (endD.getMonth() + 1).toString().padStart(2, '0'); // Months are 0-based, so add 1","var endYear = endD.getFullYear();","","// End date in DD/MM/YYYY format","var endDate = endDay + \"/\" + endMonth + \"/\" + endYear;","","//Auto Variables","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var serviceTypeId_DD = pm.collectionVariables.get(\"serviceTypeId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","","var d = new Date();","var requestId = d.getTime();","var hashMandate = CryptoJS.SHA512(merchantId_DD + serviceTypeId_DD + requestId + mandateAmount + apiKey_DD);","","pm.collectionVariables.set('payerName', payerName);","pm.collectionVariables.set('payerEmail', payerEmail);","pm.collectionVariables.set('payerPhone', payerPhone);","pm.collectionVariables.set('payerBankCode', payerBankCode);","pm.collectionVariables.set('beneficiaryAccountNumber', payerAccount);","pm.collectionVariables.set('payerAccount', payerAccount);","pm.collectionVariables.set('payerBankCode', payerBankCode);","pm.collectionVariables.set('mandateAmount', mandateAmount);","pm.collectionVariables.set('startDate', startDate);","pm.collectionVariables.set('endDate', endDate);","pm.collectionVariables.set('mandateType', mandateType);","pm.collectionVariables.set('maxNoOfDebits', maxNoOfDebits);","pm.collectionVariables.set(\"requestId\", requestId);","pm.collectionVariables.set('hashMandate', hashMandate);","pm.collectionVariables.set(\"variable_key\", \"variable_value\");",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"df626a07-bb00-4733-8c94-d5a2b2cf62c3","exec":["let getResponseValue = pm.response.json();","pm.collectionVariables.set(\"paymentIdentifier\", getResponseValue.data.paymentIdentifier);","pm.collectionVariables.set(\"mandateId\", getResponseValue.data.mandateId);","pm.collectionVariables.set(\"requestId\", getResponseValue.data.requestId);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"95b0d57a-d56c-4fff-9bab-e7a950fc5853","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"beneficiaryAccountReference\": \"{{benAccountEnquiryRef}}\",\n \"useBeneficiaryNameFromLookup\": false,\n \"payerAccountReference\": \"{{payerAccountEnquiryRef}}\",\n \"payerEmail\": \"info@mailnator.com\",\n \"payerPhoneNumber\": \"08012345678\",\n \"description\": \"Mandate system for recurrent pay\",\n \"amount\": 3000,\n \"mandateType\": \"SO\",\n \"frequency\": \"Day\",\n \"startDate\": \"03/07/2025\",\n \"endDate\": \"03/01/2026\"\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/setup","description":"

API Request Description

This endpoint enables the setup of a mandate allowing the Financial Institution to debit a fixed amount from the payer’s account at regular, predetermined intervals, as specified in the Direct Debit agreement established on the mandate. It is designed for situations where the amount to be debited is consistent and occurs at a fixed frequency.

Request Body

requestId (string): Identifier for the request
\n
beneficiaryAccountReference (string): Reference for the beneficiary account from the Name Inquiry API
\n
useBeneficiaryNameFromLookup (boolean): Indicates whether to use beneficiary name as the Beneficiary of the mandate. If the value is false, the name of the Financial Institution will be used as the beneficiary
\n
payerAccountReference (string): Reference for the payer account from the Name Inquiry API
\n
payerEmail (string, required): The email of the payer.
\n
payerPhoneNumber (string, required): The phone number of the payer.
\n
description (string, required): Description of the mandate setup.
\n
amount (number, required): The fixed amount to be debited at the specified interval
\n
mandateType (string): Type of the mandate. In the case of a variable mandate, this should be SO
\n
frequency (string, required): The frequency of the mandate setup. See Frequency Values below.
\n
startDate (string): Start date for the mandate in the format dd/mm/yyyy
endDate (string): End date for the mandate in the format dd/mm/yyyy
\n

Frequency Values

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Value
Day	Daily - Debit customer once every day
Week	Weekly – Debit customer once every week
Month	Monthly – Debit customer once every month
Quarter	Quarterly – Debit customer once in 3 months
HalfYear	Bi-Annually – Debit customer once in 6 months (Half Year)
Year	Yearly – Debit customer once in 12 months (Year)

Response

The response is in JSON format and follows the schema below:

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": { \"type\": \"string\" },\n    \"message\": { \"type\": \"string\" },\n    \"_meta\": { \"type\": \"null\" },\n    \"_links\": { \"type\": \"null\" },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"paymentIdentifier\": { \"type\": \"string\" },\n        \"mandateId\": { \"type\": \"string\" },\n        \"requestId\": { \"type\": \"string\" }\n      }\n    }\n  }\n}\n\n

Example Response

{\n  \"status\": \"\",\n  \"message\": \"\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {\n    \"paymentIdentifier\": \"\",\n    \"mandateId\": \"\",\n    \"requestId\": \"\"\n  }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","setup"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"c7fc1a54-6f82-4547-abfb-1f17cce925aa","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"beneficiaryAccountReference\": \"{{benAccountEnquiryRef}}\",\n \"useBeneficiaryNameFromLookup\": false,\n \"payerAccountReference\": \"{{payerAccountEnquiryRef}}\",\n \"payerEmail\": \"info@mailnator.com\",\n \"payerPhoneNumber\": \"08012345678\",\n \"description\": \"Mandate system for recurrent pay\",\n \"amount\": 3000,\n \"mandateType\": \"SO\",\n \"frequency\": \"Day\",\n \"startDate\": \"03/07/2025\",\n \"endDate\": \"03/01/2026\"\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/setup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:44:52 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"paymentIdentifier\": \"24070222445255\",\n \"mandateId\": \"180798756390\",\n \"requestId\": \"1719956690877\"\n }\n}"}],"_postman_id":"95b0d57a-d56c-4fff-9bab-e7a950fc5853"},{"name":"Setup Mandate- Variable Amount","event":[{"listen":"prerequest","script":{"id":"f13359a8-4c34-4096-a94e-3b15a41acdde","exec":["// See bottom for sample Sub-Merchant Credentials","function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","let append0 = randomIntFromInterval(10000000000, 99999999999);","let accountNumber = randomIntFromInterval(1000000000, 9999999999);","let append = randomIntFromInterval(10000000, 99999999);","let bvn = randomIntFromInterval(10000000000, 99999999999);","let dob = '03-11-2000';","","","let firstName = pm.variables.replaceIn(\"Lyric\")+\"-Test\";","let lastName = pm.variables.replaceIn(\"McGlynn\");","let payerName = firstName+\" \"+lastName;","let userName = firstName+\".\"+lastName;","let payerEmail = userName+\"@mailinator.com\";","let payerPhone = \"010\" + append;","","","//Manual Variables","var payerBankCode = \"044\";","var payerAccount = randomIntFromInterval(1000000000, 9999999999);","var mandateAmount = \"96000\";","var mandateType = \"DD\";","var maxNoOfDebits = \"40\";","","var d = new Date();","var transactionId = d.getTime();","var today = d.toDateString();","var day = d.getDate().toString().padStart(2, '0');","var startMonth = (d.getMonth() + 1).toString().padStart(2, '0'); // Months are 0-based, so add 1","var Year = d.getFullYear();","","// Start date in DD/MM/YYYY format","var startDate = day + \"/\" + startMonth + \"/\" + Year;","","// Calculate end date by adding 6 months","var endD = new Date(d);","endD.setMonth(d.getMonth() + 6);","var endDay = endD.getDate().toString().padStart(2, '0');","var endMonth = (endD.getMonth() + 1).toString().padStart(2, '0'); // Months are 0-based, so add 1","var endYear = endD.getFullYear();","","// End date in DD/MM/YYYY format","var endDate = endDay + \"/\" + endMonth + \"/\" + endYear;","","//Auto Variables","var merchantId_DD = pm.collectionVariables.get(\"merchantId_DD\");","var serviceTypeId_DD = pm.collectionVariables.get(\"serviceTypeId_DD\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey_DD\");","","var d = new Date();","var requestId = d.getTime();","var hashMandate = CryptoJS.SHA512(merchantId_DD + serviceTypeId_DD + requestId + mandateAmount + apiKey_DD);","","pm.collectionVariables.set('payerName', payerName);","pm.collectionVariables.set('payerEmail', payerEmail);","pm.collectionVariables.set('payerPhone', payerPhone);","pm.collectionVariables.set('payerBankCode', payerBankCode);","pm.collectionVariables.set('beneficiaryAccountNumber', payerAccount);","pm.collectionVariables.set('payerAccount', payerAccount);","pm.collectionVariables.set('payerBankCode', payerBankCode);","pm.collectionVariables.set('mandateAmount', mandateAmount);","pm.collectionVariables.set('startDate', startDate);","pm.collectionVariables.set('endDate', endDate);","pm.collectionVariables.set('mandateType', mandateType);","pm.collectionVariables.set('maxNoOfDebits', maxNoOfDebits);","pm.collectionVariables.set(\"requestId\", requestId);","pm.collectionVariables.set('hashMandate', hashMandate);","pm.collectionVariables.set(\"variable_key\", \"variable_value\");",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"test","script":{"id":"e9353d51-49c9-4a3c-b49f-f591e0afc376","exec":["let getResponseValue = pm.response.json();","pm.collectionVariables.set(\"paymentIdentifier\", getResponseValue.data.paymentIdentifier);","pm.collectionVariables.set(\"mandateId\", getResponseValue.data.mandateId);","pm.collectionVariables.set(\"requestId\", getResponseValue.data.requestId);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"5bc9775a-2034-4b0c-9c94-b0e36852939c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"beneficiaryAccountReference\": \"{{benAccountEnquiryRef}}\",\n \"useBeneficiaryNameFromLookup\": false,\n \"payerAccountReference\": \"{{payerAccountEnquiryRef}}\",\n \"payerEmail\": \"info@mailnator.com\",\n \"payerPhoneNumber\": \"08012345678\",\n \"description\": \"Mandate system for recurrent pay\",\n \"amount\": 30000,\n \"mandateType\": \"DD\",\n \"maxNoOfDebits\": 3,\n \"startDate\": \"03/07/2025\",\n \"endDate\": \"03/01/2026\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/setup","description":"

API Request Description

This endpoint enables the setup of a mandate allowing the Financial Institution to debit a varying amount from the payer’s account, as specified in the Direct Debit agreement established on the mandate. It is designed for situations where the amount to be debited is not fixed and does not occur at a fixed frequency.

The request should include the following parameters in the raw request body:

requestId (string): Identifier for the request
\n
beneficiaryAccountReference (string): Reference for the beneficiary account from the Name Inquiry API
\n
useBeneficiaryNameFromLookup (boolean): Indicates whether to use beneficiary name as the Beneficiary of the mandate. If the value is false, the name of the Financial Institution will be used as the beneficiary
\n
payerAccountReference (string): Reference for the payer account from the Name Inquiry API
\n
payerEmail (string): Email of the payer
\n
payerPhoneNumber (string): Phone number of the payer
\n
description (string): Berief description of the mandate
\n
amount (number): The maximum amount that can be debited on the mandate in a calendar month
\n
mandateType (string): Type of the mandate. In the case of a variable mandate, this should be DD
\n
maxNoOfDebits (number): Maximum number of debits that can be passed in a calendar month on the mandate
\n
startDate (string): Start date for the mandate in the format dd/mm/yyyy
\n
endDate (string): End date for the mandate in the format dd/mm/yyyy
\n

API Response (JSON Schema)

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": { \"type\": \"string\" },\n    \"message\": { \"type\": \"string\" },\n    \"_meta\": { \"type\": \"null\" },\n    \"_links\": { \"type\": \"null\" },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"paymentIdentifier\": { \"type\": \"string\" },\n        \"mandateId\": { \"type\": \"string\" },\n        \"requestId\": { \"type\": \"string\" }\n      }\n    }\n  }\n}\n\n

Retrieve Mandate Status

This endpoint allows you to retrieve the current status of a specific mandate.

Request Body

mandateId (string): The ID of the mandate for which the status is to be retrieved.
\n
requestId (string): The ID of the request.
\n

Response

status (string): The status of the mandate.
\n
message (string): Additional message related to the status.
\n
_meta (null): Meta information.
\n
_links (null): Links related to the status.
\n
data (array):
\n
- statuscode (string): The status code of the mandate.
  \n
- startDate (string): The start date of the mandate.
  \n
- endDate (string): The end date of the mandate.
  \n
- mandateId (string): The ID of the mandate.
  \n
- requestId (string): The ID of the request.
  \n
- registrationDate (string): The registration date of the mandate.
  \n
- status (string): The status of the mandate.
  \n
- active (boolean): Indicates whether the mandate is active.
  \n
\n

Example Response

{\n  \"status\": \"\",\n  \"message\": \"\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": [\n    {\n      \"statuscode\": \"\",\n      \"startDate\": \"\",\n      \"endDate\": \"\",\n      \"mandateId\": \"\",\n      \"requestId\": \"\",\n      \"registrationDate\": \"\",\n      \"status\": \"\",\n      \"active\": true\n    }\n  ]\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","status"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"c4d7cec5-ec47-43b2-b2ed-20e6c2323f24","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\",\r\n \"requestId\": \"1751533484929\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:45:21 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate status request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": [\n {\n \"statuscode\": \"00\",\n \"startDate\": \"2024-07-02 00:00:00\",\n \"endDate\": \"2024-07-03 00:00:00\",\n \"mandateId\": \"180798756390\",\n \"requestId\": \"1719956690877\",\n \"registrationDate\": \"2024-07-02 21:44:52\",\n \"status\": \"Successful\",\n \"active\": false\n }\n ]\n}"}],"_postman_id":"debbb384-89f7-458a-9d31-6692c7470562"},{"name":"Get Mandate History","id":"059687f9-b218-4b90-936c-c3cf6db31000","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"mandateId\": \"180799091923\",\n \"requestId\": \"1751533484929\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/payment/history","description":"

API Request Description

Request Body

The request body should be in raw format and include the following parameters:

mandateId: (string) The ID of the mandate for which the payment history is being retrieved.
\n
requestId: (string) The ID of the request.
\n

Response

The response for this request is in the form of a JSON schema:

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": {\n      \"type\": \"string\"\n    },\n    \"message\": {\n      \"type\": \"string\"\n    },\n    \"_meta\": {\n      \"type\": \"null\"\n    },\n    \"_links\": {\n      \"type\": \"null\"\n    },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"statuscode\": {\n          \"type\": \"string\"\n        },\n        \"requestId\": {\n          \"type\": \"string\"\n        },\n        \"mandateId\": {\n          \"type\": \"string\"\n        },\n        \"paymentDetails\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"amount\": {\n                \"type\": \"number\"\n              },\n              \"lastStatusUpdateTime\": {\n                \"type\": \"string\"\n              },\n              \"status\": {\n                \"type\": \"string\"\n              },\n              \"statuscode\": {\n                \"type\": \"string\"\n              },\n              \"transactionRef\": {\n                \"type\": \"string\"\n              },\n              \"rrr\": {\n                \"type\": \"string\"\n              }\n            }\n          }\n        },\n        \"status\": {\n          \"type\": \"string\"\n        }\n      }\n    }\n  }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","payment","history"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"00c3da28-141e-4135-b603-70a0e1b43d43","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"mandateId\": \"180799091923\",\n \"requestId\": \"1751533484929\"\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/payment/history"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:52:46 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate payment history request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"statuscode\": \"00\",\n \"requestId\": \"1719963775380\",\n \"mandateId\": \"150798756416\",\n \"paymentDetails\": [\n {\n \"amount\": 3000,\n \"lastStatusUpdateTime\": \"2024-01-30 07:36:26\",\n \"status\": \"Awaiting Debit\",\n \"statuscode\": \"070\",\n \"transactionRef\": \"223222519\",\n \"rrr\": \"250223222519\"\n },\n {\n \"amount\": 3000,\n \"lastStatusUpdateTime\": \"2024-01-30 07:43:52\",\n \"status\": \"Awaiting Debit\",\n \"statuscode\": \"070\",\n \"transactionRef\": \"223222520\",\n \"rrr\": \"170223222520\"\n }\n ],\n \"status\": \"RECORD FOUND\"\n }\n}"}],"_postman_id":"059687f9-b218-4b90-936c-c3cf6db31000"},{"name":"Stop Mandate","id":"2d94fee4-e2dc-4388-9c63-44601d047f78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/stop","description":"

API Request Description

This request is used to terminate an existing mandate, preventing any further debits under it.

Request Body

mandateId (string, required): The ID of the mandate to be terminated.

Response

status (string): The status of the response.
\n
message (string): A message providing additional information.
\n
_meta (object): Additional metadata related to the response.
\n
_links (object): Links related to the response.
\n
data (object): The data related to the termination of the mandate.
\n

Example

Request Body:

{\n  \"mandateId\": \"example_mandate_id\"\n}\n\n

Response:

{\n  \"status\": \"example_status\",\n  \"message\": \"example_message\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": null\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","stop"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"6b55cd19-fd29-45f7-83ef-5fe722ead7c4","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/stop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 23:38:59 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Stop mandate request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": null\n}"}],"_postman_id":"2d94fee4-e2dc-4388-9c63-44601d047f78"},{"name":"Webhook: Mandate Stopped","id":"cceac15b-f528-4dba-b912-8547b92b73b7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"STOP_MANDATE\",\r\n \"data\": {\r\n \"mandateId\": \"190798756437\",\r\n \"debitDate\": null,\r\n \"requestId\": \"1719968291872\",\r\n \"amount\": null,\r\n \"activationDate\": null,\r\n \"mandateStartDate\": null,\r\n \"mandateEndDate\": null,\r\n \"debitReference\": null,\r\n \"cancellationDate\": \"2024-07-03T02:02:29.284986Z\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{notificationUrl}}","description":"

API Request Description

This webhook sends a notification to your specified listening URL when one of your mandates has been stopped.

Request Body

notificationType (string): Type of the notification.
\n
data (object):
\n
- mandateId (string, required): The ID of the mandate to be terminated.
  \n
- debitDate (null): Date for the debit. Always null for this notification type as not applicable.
  \n
- requestId (string): ID of the request.
  \n
- amount (null): The amount related to the mandate. Always null for this notification type as not applicable.
  \n
- activationDate (null): The activation date of the mandate. Always null for this notification type as not applicable.
  \n
- mandateStartDate (null): The start date of the mandate. Always null for this notification type as not applicable.
  \n
- mandateEndDate (null): The end date of the mandate. Always null for this notification type as not applicable.
  \n
- debitReference (null): Reference related to the debit. Always null for this notification type as not applicable.
  \n
- cancellationDate (string): The date of cancellation.
  \n
\n

Response

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": {\n      \"type\": \"string\"\n    },\n    \"message\": {\n      \"type\": \"string\"\n    },\n    \"_meta\": {\n      \"type\": \"object\"\n    },\n    \"_links\": {\n      \"type\": \"object\"\n    },\n    \"data\": {\n      \"type\": \"object\"\n    }\n  }\n}\n\n

\n","urlObject":{"host":["{{notificationUrl}}"],"query":[],"variable":[]}},"response":[{"id":"2f300cec-3de5-4335-9d8a-218f370cdb76","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"STOP_MANDATE\",\r\n \"data\": {\r\n \"mandateId\": \"190798756437\",\r\n \"debitDate\": null,\r\n \"requestId\": \"1719968291872\",\r\n \"amount\": null,\r\n \"activationDate\": null,\r\n \"mandateStartDate\": null,\r\n \"mandateEndDate\": null,\r\n \"debitReference\": null,\r\n \"cancellationDate\": \"2024-07-03T02:02:29.284986Z\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{notificationUrl}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 Jul 2024 00:37:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"5c-eHvutKGLAW1DCPEbI0Y+DxZTtfg\""},{"key":"x-do-app-origin","value":"f77de891-6b13-48db-bbec-64857731bd2c"},{"key":"Cache-Control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Set-Cookie","value":"__cf_bm=C2HUNbUs9A_LKblpKE98xuXK8zFE0zGSLbnHsXBJiL4-1719967069-1.0.1.1-qq_Ue2Dx1eZIYYuy_XsqWbNJHtArtVAf.Cn1BtTGcRu7jdCSlfVJgS3vtUwrWLHhpGb_77HvnGK7Y8xPCTESZw; path=/; expires=Wed, 03-Jul-24 01:07:49 GMT; domain=.api.mockfly.dev; HttpOnly; Secure; SameSite=None"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"89d2cf26ff925351-LOS"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Notification was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {}\n}"}],"_postman_id":"cceac15b-f528-4dba-b912-8547b92b73b7"}],"id":"80931715-17e7-4df5-a39f-7a37f92c7f33","description":"

These endpoints manage the lifecycle of direct debit mandates. They allow you to set up, monitor, print, and stop mandates, as well as retrieve mandate history.

\n","_postman_id":"80931715-17e7-4df5-a39f-7a37f92c7f33"},{"name":"Mandate Activation","item":[{"name":"Request OTP Activation","event":[{"listen":"test","script":{"id":"62febde8-c357-4503-9ea6-9d2a6c116f82","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"mandateId\", getResponseValue.data.mandateId);","","pm.collectionVariables.set(\"paymentIdentifier\", getResponseValue.data.paymentIdentifier);"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"19f93020-7e86-4877-8483-2aca02d2131f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\",\r\n \"requestId\": \"1751533484929\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/activation/otp/request","description":"

API Request Description

This endpoint triggers a request to generate a One-Time Password (OTP) for mandate activation.

This operation requests a One-Time Password (OTP) for activating a mandate, specifying the mandate ID. The response includes details for the user to provide, such as the OTP and the last 4 digits of their bank card. The OTP will be sent by the payer’s bank.

This activation method is only available for personal accounts and for banks that have integrated Remita’s OTP service for mandates. The banks currently offering this service to personal account holders are:

• First City Monument Bank (FCMB)

• Zenith Bank

• Fidelity Bank

• Keystone Bank

• Jaiz Bank

• Providus Bank

• Heritage Bank

• Unity Bank

Request Body

mandateId (string): The ID of the mandate for which the OTP is being requested.
\n
requestId (string): The ID of the request.
\n

Response

The response to this request will be a JSON object with the following schema:

{\n  \"type\": \"object\",\n  \"properties\": {\n    \"status\": {\n      \"type\": \"string\"\n    },\n    \"message\": {\n      \"type\": \"string\"\n    },\n    \"_meta\": {\n      \"type\": \"null\"\n    },\n    \"_links\": {\n      \"type\": \"null\"\n    },\n    \"data\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"mandateId\": {\n          \"type\": \"string\"\n        },\n        \"paymentIdentifier\": {\n          \"type\": \"string\"\n        },\n        \"authDetails\": {\n          \"type\": \"array\",\n          \"items\": {\n            \"type\": \"object\",\n            \"properties\": {\n              \"description1\": {\n                \"type\": \"string\"\n              },\n              \"label1\": {\n                \"type\": \"string\"\n              },\n              \"param1\": {\n                \"type\": \"string\"\n              },\n              \"description2\": {\n                \"type\": \"string\"\n              },\n              \"label2\": {\n                \"type\": \"string\"\n              },\n              \"param2\": {\n                \"type\": \"string\"\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}\n\n

The response will contain the following properties:

status (string): The status of the response.
\n
message (string): A message related to the response.
\n
data (object): An object containing the following properties:
\n
- mandateId (string): The ID of the mandate for which the OTP was requested.
  \n
- paymentIdentifier (string): The payment identifier.
  \n
- authDetails (array): An array of objects containing details for user authentication, including descriptions, labels, and parameters. this section provides the items that the payer's bank requires to be validated prior to activating the mandate. Note that the value of the 'labell' field reprsents what you should show to the customer on your interface as regards the field required.
  \n
\n

\n","urlObject":{"path":["api","v1","mandate","activation","otp","request"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"1cb494d1-b0d5-4515-8912-103975c3efbf","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\",\r\n \"requestId\": \"1751533484929\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/activation/otp/request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:50:56 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate activation otp request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"mandateId\": \"260798756394\",\n \"paymentIdentifier\": \"24070222505143\",\n \"authDetails\": [\n {\n \"description2\": \"Please specify the 6 digits of your bank card\",\n \"label1\": \"One Time Password\",\n \"param1\": \"OTP\",\n \"label2\": \"PAN\",\n \"description1\": \"Please enter your Bank OTP\",\n \"param2\": \"PAN\"\n }\n ]\n }\n}"}],"_postman_id":"19f93020-7e86-4877-8483-2aca02d2131f"},{"name":"Validate OTP Request","id":"d0d1d255-c202-4f2b-aa82-4629378f26e1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\",\r\n \"paymentIdentifier\": \"000078250827083739963869306492\",\r\n \"authParams\": [\r\n {\r\n \"param1\": \"OTP\",\r\n \"value\": \"1234\"\r\n },\r\n {\r\n \"param2\": \"PAN\",\r\n \"value\": \"0441234567890\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/activation/otp/validation","description":"

Validate OTP for Mandate Activation

This endpoint validates the information provided by the payer in response to the required fields specified by their bank.

Note that the fields that the payer's bank requires from them to authenticate their request would have been returned in the authDetails array in the response of the 'Request OTP Activation' API.

Request Body

mandateId (string): The ID of the mandate.
\n
paymentIdentifier (string): The identifier for the payment.
\n
authParams (array of objects): This will be as many authentication paramaeters as would have been returned in the authDetails array in the response of the 'Request OTP Activation' API.
\n
- param1 (string): Description of the authentication parameter.
  \n
- value (string): Value of the authentication parameter.
  \n
\n

Response

status (string): The status of the response.
\n
message (string): Additional information or message.
\n
_meta (null): Meta information of the response.
\n
_links (null): Links related to the response.
\n
data (object):
\n
- mandateId (string): The ID of the mandate.
  \n
- responseMessage (string): Message related to the response.
  \n
\n

Example of response body:

{\n  \"status\": \"\",\n  \"message\": \"\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {\n    \"mandateId\": \"\",\n    \"responseMessage\": \"\"\n  }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","activation","otp","validation"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"79984fae-19b9-40dc-87c5-a189e41991a1","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"mandateId\": \"180799091923\",\r\n \"paymentIdentifier\": \"000078250827083739963869306492\",\r\n \"authParams\": [\r\n {\r\n \"param1\": \"OTP\",\r\n \"value\": \"1234\"\r\n },\r\n {\r\n \"param2\": \"PAN\",\r\n \"value\": \"0441234567890\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/activation/otp/validation"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:50:59 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate activation otp validate request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"mandateId\": \"260798756394\",\n \"responseMessage\": \"Mandate Activated Successfully\"\n }\n}"}],"_postman_id":"d0d1d255-c202-4f2b-aa82-4629378f26e1"},{"name":"Print Mandate","id":"2766fd49-c277-4010-804a-c3f9204a9728","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/merchant/print/180799091923","description":"

Get Mandate Print Details

For payers who canot authentiacte their mandates automatically, they will have to print a mandate and take to their bank to initiate the authentication process that is necessary for the mandate to be activated. This API provides you with the URL for the form that should be printed by the payer

Request

Endpoint

GET /api/v1/mandate/merchant/print/180799091923

Response Body

status (string): The status of the mandate print details.
\n
message (string): Additional information or message related to the mandate print details.
\n
_meta (object): Meta information about the mandate print details.
\n
_links (object): Links related to the mandate print details.
\n
data (object): The main data object containing the following details:
\n
- beneficiaryName (string): The name of the beneficiary associated with the mandate.
  \n
- merchantId (string): The ID of the merchant associated with the mandate.
  \n
- payerName (string): The name of the payer associated with the mandate.
  \n
- mandateReceiptUrl (string): The URL to access the mandate receipt.
  \n
\n

Example Response

{\n  \"status\": \"\",\n  \"message\": \"\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {\n    \"beneficiaryName\": \"\",\n    \"merchantId\": \"\",\n    \"payerName\": \"\",\n    \"mandateReceiptUrl\": \"\"\n  }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","merchant","print","180799091923"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"2fce6500-2a60-4418-bd7b-853e87fef748","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/merchant/print/180799091923"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 23:44:51 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Print mandate request is successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"beneficiaryName\": \"Mustafa Kasapo??????lu\",\n \"merchantId\": \"18\",\n \"payerName\": \"Lillian Chapman\",\n \"mandateReceiptUrl\": \"https://receipt-core-platform-test.systemspecsng.com/rrr/view/444479627157456941306a61685462414a5856326f656a747a766f6d324167476243653773413d3d\"\n }\n}"}],"_postman_id":"2766fd49-c277-4010-804a-c3f9204a9728"},{"name":"Webhook: Mandate Activated","id":"90b980d1-6ea7-4d5c-b95d-dc1c17cdc4c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"MANDATE_ACTIVATION\",\r\n \"data\": {\r\n \"mandateId\": \"210798756419\",\r\n \"debitDate\": null,\r\n \"requestId\": \"1719964173972\",\r\n \"amount\": null,\r\n \"activationDate\": \"2024-07-02T23:49:56.406442Z\",\r\n \"mandateStartDate\": \"03/07/2024\",\r\n \"mandateEndDate\": \"03/01/2025\",\r\n \"debitReference\": null,\r\n \"cancellationDate\": null\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{notificationUrl}}","description":"

API Request Description

This webhook sends a notification to your specified listening URL when one of your mandates has been activated.

Request Body

notificationType (string): Type of notification.
\n
data (object):
\n
- mandateId (string): The ID of the mandate to be terminated.
  \n
- debitDate (null): Date of debit.
  \n
- requestId (string): ID of the request.
  \n
- amount (null): The amount.
  \n
- activationDate (string): Date of activation.
  \n
- mandateStartDate (string): Start date of the mandate.
  \n
- mandateEndDate (string): End date of the mandate.
  \n
- debitReference (null): Reference for debit. Always null for this notification type as not applicable.
  \n
- cancellationDate (null): Date of cancellation. Always null for this notification type as not applicable.
  \n
\n

Response

status (string): The status of the response.
\n
message (string): A message providing additional information.
\n
_meta (object): Additional metadata related to the response.
\n
_links (object): Links related to the response.
\n
data (object): The data related to the termination of the mandate.
\n

Example

Request Body:

{\n  \"notificationType\": \"example_notification_type\",\n  \"data\": {\n    \"mandateId\": \"example_mandate_id\",\n    \"debitDate\": null,\n    \"requestId\": \"example_request_id\",\n    \"amount\": null,\n    \"activationDate\": \"example_activation_date\",\n    \"mandateStartDate\": \"example_start_date\",\n    \"mandateEndDate\": \"example_end_date\",\n    \"debitReference\": null,\n    \"cancellationDate\": null\n  }\n}\n\n

Response:

{\n  \"status\": \"example_status\",\n  \"message\": \"example_message\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {}\n}\n\n

\n","urlObject":{"host":["{{notificationUrl}}"],"query":[],"variable":[]}},"response":[{"id":"4f2a4600-1987-4ab2-b44f-b1253632503d","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"MANDATE_ACTIVATION\",\r\n \"data\": {\r\n \"mandateId\": \"210798756419\",\r\n \"debitDate\": null,\r\n \"requestId\": \"1719964173972\",\r\n \"amount\": null,\r\n \"activationDate\": \"2024-07-02T23:49:56.406442Z\",\r\n \"mandateStartDate\": \"03/07/2024\",\r\n \"mandateEndDate\": \"03/01/2025\",\r\n \"debitReference\": null,\r\n \"cancellationDate\": null\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{notificationUrl}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 Jul 2024 00:38:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"5c-eHvutKGLAW1DCPEbI0Y+DxZTtfg\""},{"key":"x-do-app-origin","value":"f77de891-6b13-48db-bbec-64857731bd2c"},{"key":"Cache-Control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"89d2d0935a045351-LOS"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Notification was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {}\n}"}],"_postman_id":"90b980d1-6ea7-4d5c-b95d-dc1c17cdc4c2"}],"id":"07f2a32e-9899-401a-888c-a6707645a337","description":"

These endpoints handle the activation of mandates, which can be done through electronic authentication by the payer with their bank or manual authentication. For manual authentication, the payer is required to take a printed mandate form to their bank.

\n","_postman_id":"07f2a32e-9899-401a-888c-a6707645a337"},{"name":"Debit Operations","item":[{"name":"Send Debit Instruction","event":[{"listen":"test","script":{"id":"8b328f32-33b4-4ea6-9e52-987083cacc00","exec":["let getResponseValue = pm.response.json();","pm.collectionVariables.set(\"paymentIdentifier\", getResponseValue.data.paymentIdentifier);","pm.collectionVariables.set(\"mandateId\", getResponseValue.data.mandateId);","pm.collectionVariables.set(\"requestId\", getResponseValue.data.requestId);","pm.collectionVariables.set(\"rrr\", getResponseValue.data.rrr);",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"f945335e-80b5-4f7c-b8a4-b4f3bcc6daab","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"amount\": 500,\n \"mandateId\": \"180799091923\",\n \"description\": \"Mandate setup\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/debit/send","description":"

API Request Description

This endpoint allows you to send a debit request on a mandate. It is specifically required for Variable Direct Debit Mandates, where a debit request must be sent to initiate the debit.

Request Body

requestId (string): The unique identifier for the request.
\n
amount (number): The amount being requested to be debitted.
\n
mandateId (string): The identifier for the mandate.
\n
description (string): A description for the mandate debit request.
\n

Response

status (string): The status of the request.
\n
message (string): A message related to the request.
\n
data (object): The data object containing the following:
\n
- requestId (string): The unique identifier for the request.
  \n
- mandateId (string): The identifier for the mandate.
  \n
- paymentIdentifier (string): The identifier for the payment.
  \n
- status (string): The status of the request.
  \n
- statuscode (string): The status code for the request.
  \n
- rrr (string): The reference code for the request.
  \n
\n

Example Response

{\n    \"status\": \"\",\n    \"message\": \"\",\n    \"_meta\": null,\n    \"_links\": null,\n    \"data\": {\n        \"requestId\": \"\",\n        \"mandateId\": \"\",\n        \"paymentIdentifier\": \"\",\n        \"status\": \"\",\n        \"statuscode\": \"\",\n        \"rrr\": \"\"\n    }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","debit","send"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"e06df7fa-1831-41ca-a5f4-f6a3bb21888d","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"amount\": 300,\n \"mandateId\": \"180799091923\",\n \"description\": \"Mandate setup\"\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/debit/send"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:51:06 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Send debit instruction request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"requestId\": \"1719957050261\",\n \"mandateId\": \"260798756394\",\n \"paymentIdentifier\": \"798756396\",\n \"status\": \"New Transaction\",\n \"statuscode\": \"069\",\n \"rrr\": \"210798756396\"\n }\n}"}],"_postman_id":"f945335e-80b5-4f7c-b8a4-b4f3bcc6daab"},{"name":"Get Debit Status","id":"9e20d074-f549-454e-88c1-79fb06d75233","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"mandateId\": \"180799091923\",\n \"rrr\": \"200799091919\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/mandate/debit/status","description":"

API Request Description

This endpoint allows you to retrieve the status of a mandate debit by providing the request ID, mandate ID, and RRR (Remita Retrieval Reference).

Request Body

requestId (string): The ID of the request.
\n
mandateId (string): The ID of the mandate.
\n
rrr (string): The Remita Retrieval Reference.
\n

Response

status (string): The status of the mandate debit.
\n
message (string): Additional information or message related to the status.
\n
data
\n
- status (string): The status of the mandate debit.
  \n
- mandateId (string): The ID of the mandate.
  \n
- requestId (string): The ID of the request.
  \n
- rrr (string): The Remita Retrieval Reference.
  \n
- paymentIdentifier (string): Identifier for the payment.
  \n
\n

Example Response:

{\n    \"status\": \"\",\n    \"message\": \"\",\n    \"_meta\": null,\n    \"_links\": null,\n    \"data\": {\n        \"status\": null,\n        \"statuscode\": null,\n        \"mandateId\": \"\",\n        \"requestId\": \"\",\n        \"amount\": null,\n        \"lastStatusUpdateTime\": null,\n        \"rrr\": \"\",\n        \"paymentIdentifier\": \"\"\n    }\n}\n\n

\n","urlObject":{"path":["api","v1","mandate","debit","status"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"a7da3bf8-5333-47a4-96c8-6793e75b9a31","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"requestId\": \"1751533484929\",\n \"mandateId\": \"180799091923\",\n \"rrr\": \"200799091919\"\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/api/v1/mandate/debit/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data: https://pay.google.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com https://pay.google.com/gp/p/js/pay.js https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data: https://www.gstatic.com https://pay.google.com; font-src 'self' https://fonts.gstatic.com data:;"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Tue, 02 Jul 2024 21:51:15 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"1; mode=block"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate debit status request was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {\n \"status\": null,\n \"statuscode\": null,\n \"mandateId\": \"260798756394\",\n \"requestId\": \"1719957050261\",\n \"amount\": null,\n \"lastStatusUpdateTime\": null,\n \"rrr\": \"210798756396\",\n \"paymentIdentifier\": \"798756396\"\n }\n}"}],"_postman_id":"9e20d074-f549-454e-88c1-79fb06d75233"},{"name":"Webhook: Debit","id":"e57bb4cd-7b6d-4ca5-8c37-53cec43645bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"DEBIT\",\r\n \"data\": {\r\n \"mandateId\": \"160798755752\",\r\n \"debitDate\": \"2024-07-03T01:50:43.161157Z\",\r\n \"requestId\": \"5468790900\",\r\n \"amount\": 37400,\r\n \"activationDate\": null,\r\n \"mandateStartDate\": null,\r\n \"mandateEndDate\": null,\r\n \"debitReference\": \"798756432\",\r\n \"cancellationDate\": null\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{notificationUrl}}","description":"

API Request Description

This webhook sends a notification to your specified listening URL when a debit occurs on one of your mandates.

Request Body

notificationType (string): Type of notification.
\n
data (object):
\n
- mandateId (string): The ID of the mandate to be terminated.
  \n
- debitDate (null): Date of debit.
  \n
- requestId (string): ID of the request.
  \n
- amount (null): The amount.
  \n
- activationDate (string): Date of activation. Always null for this notification type as not applicable.
  \n
- mandateStartDate (string): Start date of the mandate. Always null for this notification type as not applicable.
  \n
- mandateEndDate (string): End date of the mandate. Always null for this notification type as not applicable.
  \n
- debitReference (null): Reference for debit. Always null for this notification type as not applicable.
  \n
- cancellationDate (null): Date of cancellation. Always null for this notification type as not applicable.
  \n
\n

Response

status (string): The status of the response.
\n
message (string): A message providing additional information.
\n
_meta (object): Additional metadata related to the response.
\n
_links (object): Links related to the response.
\n
data (object): The data related to the termination of the mandate.
\n

Example

Request Body:

{\n  \"notificationType\": \"example_notification_type\",\n  \"data\": {\n    \"mandateId\": \"example_mandate_id\",\n    \"debitDate\": null,\n    \"requestId\": \"example_request_id\",\n    \"amount\": null,\n    \"activationDate\": \"example_activation_date\",\n    \"mandateStartDate\": \"example_start_date\",\n    \"mandateEndDate\": \"example_end_date\",\n    \"debitReference\": null,\n    \"cancellationDate\": null\n  }\n}\n\n

Response:

{\n  \"status\": \"example_status\",\n  \"message\": \"example_message\",\n  \"_meta\": null,\n  \"_links\": null,\n  \"data\": {}\n}\n\n

\n","urlObject":{"host":["{{notificationUrl}}"],"query":[],"variable":[]}},"response":[{"id":"7adc30b5-a19d-4fde-9463-7f59c6ccd0e9","name":"Successful Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"notificationType\": \"DEBIT\",\r\n \"data\": {\r\n \"mandateId\": \"160798755752\",\r\n \"debitDate\": \"2024-07-03T01:50:43.161157Z\",\r\n \"requestId\": \"5468790900\",\r\n \"amount\": 37400,\r\n \"activationDate\": null,\r\n \"mandateStartDate\": null,\r\n \"mandateEndDate\": null,\r\n \"debitReference\": \"798756432\",\r\n \"cancellationDate\": null\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.mockfly.dev/mocks/54d31e0d-0cee-4e8a-8aa5-a26c57a67e45/testmandate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 03 Jul 2024 00:52:39 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"x-powered-by","value":"Express"},{"key":"access-control-allow-origin","value":"*"},{"key":"etag","value":"W/\"5c-eHvutKGLAW1DCPEbI0Y+DxZTtfg\""},{"key":"x-do-app-origin","value":"f77de891-6b13-48db-bbec-64857731bd2c"},{"key":"Cache-Control","value":"private"},{"key":"x-do-orig-status","value":"200"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"89d2e4e28e926926-LIS"},{"key":"Content-Encoding","value":"br"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Notification was successful\",\n \"_meta\": null,\n \"_links\": null,\n \"data\": {}\n}"}],"_postman_id":"e57bb4cd-7b6d-4ca5-8c37-53cec43645bc"}],"id":"6d246cbc-33c1-40e6-bd79-c08c2a464258","description":"

These endpoints manage the process of sending and tracking debit instructions on mandates.

\n","_postman_id":"6d246cbc-33c1-40e6-bd79-c08c2a464258"},{"name":"Status Codes","item":[],"id":"442bb54d-901f-4d20-8c47-8f22fe02bf47","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Code	Description
00	Transaction Completed Successfully (Record Found)
01	Approved (Direct Debit Instruction Successful)
013	Invalid Hash Value
020	Authentication Error (Invalid User Authentication)
034	Invalid funding Source
035	Payment Limit Exceeded
040	Initail Request OK (Mandate Setup Completed Successfully)
051	No sufficient funds
061	Mandate Not Activated
062	Mandate Not Due
063	Expired Mandate
066	Mandate Deactivated
067	Only Direct Debit Mandate Allowed
069	New Transaction
070	Awaiting Debit
071	Undergoing Bank Processing
072	Pending Credit
073	Invalid Mandate Type
074	No Available Record
075	Mandate Already Active
107	Insufficent Funds

","_postman_id":"442bb54d-901f-4d20-8c47-8f22fe02bf47"}],"id":"99dade1d-12ec-48eb-bd84-a79c38ffa0b2","description":"

Overview

Our Direct Debit service facilitates a seamless and automated process for financial institutions to establish and manage recurrent payment agreements with their customers. This service simplifies the collection of payments according to the terms of the agreement, enhancing efficiency and reliability.

Objectives

The primary goal of our Direct Debit service is to empower Merchants and Financial Institutions with the capability to:

Create and stop mandates
\n
Activate mandates through payer bank authentication
\n
Issue debit requests for variable amounts under specific mandates
\n
Monitor transactions and mandate statuses
\n
Enforce payer's terms and conditions
\n

Actions and Events

Financial Institutions can execute the following actions through our API:

Mandate Management: This lets you create, activate, deactivate, and check the status of mandates.
\n
Transaction Management: This lets you send debit instructions, check transaction status, and cancel or stop transactions.
\n

Authentication: Activate mandates via the payer's bank authentication service.

API Endpoints

Below are the key endpoints for the Direct Debit Mandate Service:

\n","_postman_id":"99dade1d-12ec-48eb-bd84-a79c38ffa0b2"}],"id":"9efb94a4-eeb6-4922-8d89-feff455b4fdc","description":"

Remita offers a plethora of ways to receive funds

Would you like to use a payment gateway on your website with a plethora of payment options? You can use our Checkout Solutions
\n
Do you want to create an invoice reference that can be paid by your customer's across a multitude of payment channels or tie a Remita reference to a third-party invoice? You can use our Invoice Generation APIs.
\n
Do you want to collect recurring payments? You can use our Direct Debit APIs
\n
We also have Webhooks to help notify you when payments are made in your favor
\n

\n","_postman_id":"9efb94a4-eeb6-4922-8d89-feff455b4fdc"},{"name":"Funds Transfer","item":[{"name":"Rest Interface","item":[{"name":"BankList","event":[{"listen":"test","script":{"id":"f5b5374a-744f-4a62-a2e9-39ec09664143","exec":["// https://api-core-platform-test.systemspecsng.com/services/remita-api-gateway"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"3a854cad-6f2a-4f21-aea6-6051f1ea88e6","exec":[""],"type":"text/javascript","packages":{}}}],"id":"b5dd2696-3a9c-4a96-9be1-748d294b41f1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/transaction/bank/list","description":"

Authentication: Click HERE

This endpoint retrieves a list of banks.

\n","urlObject":{"path":["api","v1","interbank","transaction","bank","list"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"e2ec64bc-2a02-4c6c-af10-22f2053b40ff","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/transaction/bank/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Tue, 28 Oct 2025 10:01:56 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"data\": {\n \"banks\": [\n {\n \"bankCode\": \"044\",\n \"bankName\": \"Access Bank Nigeria Plc\"\n },\n {\n \"bankCode\": \"011\",\n \"bankName\": \"First Bank of Nigeria Plc\"\n },\n {\n \"bankCode\": \"301\",\n \"bankName\": \"Jaiz Bank\"\n },\n {\n \"bankCode\": \"232\",\n \"bankName\": \"Sterling Bank Plc\"\n },\n {\n \"bankCode\": \"035\",\n \"bankName\": \"WEMA Bank Plc\"\n },\n {\n \"bankCode\": \"050\",\n \"bankName\": \"Ecobank Plc\"\n },\n {\n \"bankCode\": \"023\",\n \"bankName\": \"Citibank\"\n },\n {\n \"bankCode\": \"000\",\n \"bankName\": \"Central Bank of Nigeria\"\n },\n {\n \"bankCode\": \"559\",\n \"bankName\": \"Coronation Merchant Bank\"\n },\n {\n \"bankCode\": \"057\",\n \"bankName\": \"Zenith Bank PLC\"\n },\n {\n \"bankCode\": \"076\",\n \"bankName\": \"Polaris Bank Ltd\"\n },\n {\n \"bankCode\": \"007\",\n \"bankName\": \"Universal Exports\"\n },\n {\n \"bankCode\": \"215\",\n \"bankName\": \"Unity Bank Plc\"\n },\n {\n \"bankCode\": \"058\",\n \"bankName\": \"GTBank\"\n },\n {\n \"bankCode\": \"033\",\n \"bankName\": \"United Bank of Africa\"\n },\n {\n \"bankCode\": \"107\",\n \"bankName\": \"Optimus Bank Ltd\"\n },\n {\n \"bankCode\": \"070\",\n \"bankName\": \"Fidelity Bank\"\n },\n {\n \"bankCode\": \"515150400\",\n \"bankName\": \"Opay Digital Services Limited\"\n },\n {\n \"bankCode\": \"5250\",\n \"bankName\": \"Kolomoni MFB\"\n }\n ],\n \"totalBanks\": 19\n }\n}"}],"_postman_id":"b5dd2696-3a9c-4a96-9be1-748d294b41f1"},{"name":"Name Enquiry","event":[{"listen":"test","script":{"id":"da8c9edf-bcd8-477e-8648-76673c6678d6","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"destAccountNumber\", getResponseValue.data.accountNumber);","pm.collectionVariables.set(\"destAccountName\", getResponseValue.data.nameOnAccount);","pm.collectionVariables.set(\"destBankCode\", getResponseValue.data.bankCode);"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"5ec8c6b0-af21-4726-a33f-603ff0dc3189","exec":["function randomIntFromInterval(min, max) {"," // Returns a random integer between min and max (inclusive)"," return Math.floor(Math.random() * (max - min + 1) + min);","}","","let destBankCodes = [\"011\", \"070\", \"058\"]; // Simplified array","","// Select a random bank code from the array","let randomDestBankCode = destBankCodes[randomIntFromInterval(0, destBankCodes.length - 1)];","","// Generate a random 7-digit number","let append1 = randomIntFromInterval(1000000, 9999999);","","// Concatenate the bank code and the 7-digit number","let destBankCode = randomDestBankCode;","let destAccountNo = destBankCode + append1;","","// Set the values as collection variables","pm.collectionVariables.set(\"destBankCode\", destBankCode);","pm.collectionVariables.set(\"destAccountNo\", destAccountNo);"],"type":"text/javascript","packages":{}}}],"id":"219074cf-3289-4e2c-8ab3-af113903684c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"destinationBankCode\": \"058\",\r\n \"destinationAccountNumber\": \"0587851521\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/name/enquiry","description":"

Interbank Name Enquiry

Performs a name enquiry for interbank funds transfer.

Important Note:

On our staging environment, any string can be used for a valid account number as long as the bank code that it is being validated with precedes the account number.
\n
For example, 0334033939 is a valid account number paired with the bank codes 033. It will not be valid if paired with the bank code 011 for instance.
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
destinationBankCode	string	Bank code of the destination institution.
destinationAccountNumber	string	Account number of the recipient.

","urlObject":{"path":["api","v1","interbank","name","enquiry"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"03f08276-5bde-4879-9ef3-1fa9f67d34e4","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"destinationBankCode\": \"058\",\r\n \"destinationAccountNumber\": \"0586957398\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/name/enquiry"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Wed, 20 Aug 2025 14:58:30 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"status\": \"00\",\n \"statusMessage\": \"Account found\",\n \"nameOnAccount\": \"Paul Reed\",\n \"accountNumber\": \"0586957398\",\n \"bankCode\": \"058\",\n \"bvn\": \"1749237620268\",\n \"bvnAccountNo\": \"0586957398\",\n \"bvnPhoneNo\": null,\n \"phoneNumber\": null,\n \"valid\": true\n }\n}"}],"_postman_id":"219074cf-3289-4e2c-8ab3-af113903684c"},{"name":"Single Payment","event":[{"listen":"prerequest","script":{"id":"2bee8bbf-741b-4cbd-adc1-d3f9d74c0f14","exec":["//","","function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","function randomAmount(min, max) {"," return (Math.random() * (max - min) + min).toFixed(2);","}","","let randomNum = randomAmount(1000, 15000); // Example range","console.log(randomNum); ","","","let sourceAccount = ["," {"," sourceAccountName: \"Cândida Martins\","," sourceBankCode: \"070\","," sourceBankAccount: \"0709521456\""," },"," {"," sourceAccountName: \"Akhil Bansal\","," sourceBankCode: \"070\","," sourceBankAccount: \"0701739651\""," },"," {"," sourceAccountName: \"Claire Fitzsimmons\","," sourceBankCode: \"070\","," sourceBankAccount: \"0703441111\""," }","];","","// Select a random product from the array","let randomSourceAccount = sourceAccount[randomIntFromInterval(0, sourceAccount.length - 1)];","","console.log(randomSourceAccount);","","","","","","pm.environment.set(\"amount\", randomNum);","pm.environment.set(\"sourceAccountName\", randomSourceAccount.sourceAccountName);","pm.environment.set(\"sourceBankCode\", randomSourceAccount.sourceBankCode);","pm.environment.set(\"sourceBankAccount\", randomSourceAccount.sourceBankAccount);","","","let d = new Date();"," ","let dd = d.getDate();","let mm = d.getMonth()+1; //January is 0!","var yyyy = d.getFullYear();","let hh = d.getHours();","let mn = d.getMinutes();","let ss = d.getSeconds();","let yyyyToString = String(yyyy);","let yy = yyyyToString.substring(2);"," ","if(dd<10){"," dd='0'+dd;","}","if(mm<10){"," mm='0'+mm;","}","if(hh<10){"," hh='0'+hh;","}","if(mn<10){"," mn='0'+mn;","}","if(ss<10){"," ss='0'+ss;","}"," ","function randomIntFromInterval(min, max) { // min and max included"," return Math.floor(Math.random() * (max - min + 1) + min)","}"," "," ","let institutionCode = \"000078\";","let transactionDate = yy + mm + dd + hh + mn + ss;","let customerRef = randomIntFromInterval(10000000000, 999999999999);",""," ","pm.environment.set(\"customerReference\",customerRef);","","","pm.environment.set(\"paymentReference\", (institutionCode + transactionDate + customerRef));","",""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"19e2f3ef-697e-4322-bdc9-1d1cec67cb06","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"paymentIdentifier\", getResponseValue.data.paymentIdentifier);"],"type":"text/javascript","packages":{}}}],"id":"9d206f26-1161-4c96-9f22-b5c393e36538","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"sourceBankCode\": \"599\",\n \"sourceAccountNumber\": \"2102911828\",\n \"sourceAccountName\": \"Omoregi John\",\n \"destinationAccountNumber\": \"0586957398\",\n \"destinationBankCode\": \"058\",\n \"destinationAccountName\": \"Paul Reed\",\n \"amount\": \"10000\",\n \"transactionDescription\": \"Test transaction\",\n \"paymentIdentifier\": \"4175554\",\n \"channel\": \"1\",\n \"isApproval\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/fund/transfer","description":"

Interbank Fund Transfer

Initiates a single interbank funds transfer.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
destinationAccountNumber	string	Recipient’s account number.
destinationBankCode	string	Bank code of the recipient.
destinationAccountName	string	Account name of the recipient.
amount	number	Amount to be transferred.
transactionDescription	string	Narration for the transaction.
paymentIdentifier	string	Unique payment reference.
channel	string	Originating channel.
isApproval	boolean	Approval flag. This is currently not in use and should always be set to false.

","urlObject":{"path":["api","v1","interbank","fund","transfer"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"7ffe4dfc-ba57-4935-b9e0-aae47666b8ac","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"destinationAccountNumber\": \"0586957398\",\n \"destinationBankCode\": \"058\",\n \"destinationAccountName\": \"Paul Reed\",\n \"amount\": \"10000\",\n \"transactionDescription\": \"Test transaction\",\n \"paymentIdentifier\": \"4175554\",\n \"channel\": \"1\",\n \"isApproval\": false\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/fund/transfer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Wed, 20 Aug 2025 15:00:29 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"104\",\n \"message\": \"Transaction Failed\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"amount\": 11912.14,\n \"paymentIdentifier\": \"000078250820160031801468554954\",\n \"narration\": null,\n \"authorizationId\": \"d642b99a-093f-4d6d-922e-ace35bd2bae5\",\n \"destinationAccount\": \"0586957398\",\n \"transactionState\": \"FAILED\",\n \"sourceAccountNumber\": \"4566195462\",\n \"sourceBankCode\": \"070\",\n \"responseCode\": \"92\",\n \"responseMessage\": \"Routing error\"\n }\n}"}],"_postman_id":"9d206f26-1161-4c96-9f22-b5c393e36538"},{"name":"Query Transaction (Single Payment)","id":"4ee8fd7f-23ce-4adb-84e4-6a00f09c7b1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/query-transaction/000078250827083739963869306492","description":"

Retrieve Interbank Transaction Details

Retrieves the status of a single payment transaction.

Path Parameters

paymentIdentifier — The reference of the transaction.

\n","urlObject":{"path":["api","v1","interbank","query-transaction","000078250827083739963869306492"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"bbffd58f-09b2-46a4-9831-3e9106c63bc0","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/query-transaction/000078250827083739963869306492"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Wed, 20 Aug 2025 15:01:18 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"amount\": 11912.14,\n \"paymentIdentifier\": \"000078250820160031801468554954\",\n \"narration\": null,\n \"authorizationId\": \"d642b99a-093f-4d6d-922e-ace35bd2bae5\",\n \"destinationAccount\": \"0586957398\",\n \"transactionState\": \"FAILED\",\n \"sourceAccountNumber\": \"4566195462\",\n \"sourceBankCode\": \"070\",\n \"responseCode\": \"41\",\n \"responseMessage\": \"Condition check failed for transaction TRX2025082016002900013762\",\n \"debitCompleted\": false,\n \"debitCompletionTime\": null,\n \"reversed\": false,\n \"reversalTime\": null\n }\n}"}],"_postman_id":"4ee8fd7f-23ce-4adb-84e4-6a00f09c7b1d"},{"name":"Bulk Payment","event":[{"listen":"prerequest","script":{"id":"fe344491-a004-4a59-a01e-8cb9280f112e","exec":["// Helper function to generate random digits of specified length","function generateRandomDigits(length) {"," let digits = '';"," for (let i = 0; i < length; i++) {"," digits += Math.floor(Math.random() * 10);"," }"," return digits;","}","","// Generate and set variables","pm.collectionVariables.set(\"batchPaymentIdentifier\", generateRandomDigits(10));","pm.collectionVariables.set(\"customReference\", generateRandomDigits(12));","pm.collectionVariables.set(\"paymentIdentifier\", generateRandomDigits(12));","pm.collectionVariables.set(\"paymentIdentifier1\", generateRandomDigits(12));","pm.collectionVariables.set(\"paymentIdentifier2\", generateRandomDigits(12));","pm.collectionVariables.set(\"paymentIdentifier3\", generateRandomDigits(12));","pm.collectionVariables.set(\"paymentIdentifier4\", generateRandomDigits(12));"," "],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"349f29a1-4c14-4f1c-9cc6-9774138c14d8","exec":[""],"type":"text/javascript","packages":{}}}],"id":"f3089cc9-f951-485a-9bce-0652b896f73e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"batchPaymentIdentifier\": \"8851722306\",\n \"totalAmount\": 8000,\n \"sourceAccount\": \"0119288291\",\n \"sourceBankCode\": \"011\",\n \"sourceAccountName\": \"John Nomel\",\n \"currency\": \"NGN\",\n \"sourceNarration\": \"Payment for invoice #12345;RESPCODE:USE_CUSTOM_CODE,00;TIMEOUT:USE_CUSTOM_TIMEOUT,2\",\n \"customReference\":\"768050709347\",\n \"approval\": false,\n \"payByTransfer\": false, // false for normal transactions\n \"transactions\": [\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"205650600765\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Sam Alkinson\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"032880622374\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"915153140422\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"227962290455\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/fund-transfer","description":"

Bulk Payment API

Initiates multiple transfers in a single batch request. This API is essential for users looking to manage large-scale fund transfers efficiently, ensuring that all transactions are processed in a single batch.

This endpoint allows users to initiate a bulk fund transfer between accounts in different banks. It accepts a payload containing details about the payment batch and returns information about the transaction.

Main Request Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
batchPaymentIdentifier	string	Unique reference for this batch of transactions.
totalAmount	number	Total sum of all individual transactions in the batch.
sourceAccount	string	The account number initiating the bulk transfer.
sourceBankCode	string	Bank code for the source account.
currency	string	Currency of the transaction (typically “NGN”).
sourceNarration	string	Narration for the entire batch payment.
customReference	string	Optional unique reference for internal tracking.
approval	boolean	Indicates whether approval is required before processing.
transactions	array	List of individual transaction objects (see below).

Transaction Object (inside transactions)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
amount	number	Amount to transfer in this specific transaction.
paymentIdentifier	string	Unique reference for this transaction.
destinationAccount	string	Account number receiving the funds.
destinationAccountName	string	Name on the destination account.
destinationBankCode	string	Bank code of the receiving bank.
destinationNarration	string	Narration for this specific transaction.
originalPayerAccountNumber	string	Original payer’s account number (for reconciliation/audit).
originalPayerBankCode	string	Original payer’s bank code.
originalPayerName	string	Name of the original payer.

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
totalAmount	number	Total amount processed.
batchPaymentIdentifier	string	Reference identifier for the entire batch.
authorizationId	string	ID tied to the approval or auth for the transaction.
transactionState	string	State of the batch (e.g., INITIATED, COMPLETED).
totalTransactions	number	Total number of transactions in the batch.
sourceAccountNumber	string	The source account number.
sourceBankCode	string	Bank code for the source account.
batchNarration	string	Narration provided for the batch.

","urlObject":{"path":["api","v1","interbank","bulk","fund-transfer"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"036ff1cd-4820-4be8-ad5a-cf41772fd5b5","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"batchPaymentIdentifier\": \"8851722306\",\n \"totalAmount\": 8000,\n \"sourceAccount\": \"8909090989\",\n \"sourceBankCode\": \"058\",\n \"sourceAccountName\": \"John Nomel\",\n \"currency\": \"NGN\",\n \"sourceNarration\": \"Payment for invoice #12345;RESPCODE:USE_CUSTOM_CODE,00;TIMEOUT:USE_CUSTOM_TIMEOUT,2\",\n \"customReference\":\"768050709347\",\n \"approval\": false,\n \"payByTransfer\": false, // false for normal transactions\n \"transactions\": [\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"205650600765\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Sam Alkinson\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"032880622374\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"915153140422\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n },\n {\n \"amount\": 2000,\n \"paymentIdentifier\": \"227962290455\",\n \"destinationAccount\": \"0037475942\",\n \"destinationAccountName\": \"Kelvin John\",\n \"destinationBankCode\": \"058\",\n \"destinationNarration\": \"Bulk Transfer\",\n \"originalPayerAccountNumber\": \"2903948931\",\n \"originalPayerBankCode\": \"058\",\n \"originalPayerName\": \"Lanre Ogunseye\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/fund-transfer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"Date","value":"Wed, 20 Aug 2025 15:10:54 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"totalAmount\": 8000,\n \"batchPaymentIdentifier\": \"3261112856\",\n \"authorizationId\": \"3261112856\",\n \"transactionState\": \"INITIATED\",\n \"totalTransactions\": 4,\n \"sourceAccountNumber\": \"4566195462\",\n \"sourceBankCode\": \"070\",\n \"batchNarration\": \"Payment for invoice #12345;RESPCODE:USE_CUSTOM_CODE,00;TIMEOUT:USE_CUSTOM_TIMEOUT,2\"\n }\n}"}],"_postman_id":"f3089cc9-f951-485a-9bce-0652b896f73e"},{"name":"Query Transaction (Bulk Payment)- Get Batch Status","event":[{"listen":"prerequest","script":{"id":"187ce34f-5e88-43ed-907f-318e44f95995","exec":["let bulkReference = pm.collectionVariables.get(\"batchPaymentIdentifier\");","","pm.collectionVariables.set(\"bulkReference\", bulkReference);"],"type":"text/javascript","packages":{}}}],"id":"b8e14acd-b8bf-4c2a-8dd3-0d341070ad93","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/query-transaction/8851722306","description":"

This API checks the overall batch status of a bulk transfer.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
bulkReference	string	The unique identifier of the bulk batch

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
batchPaymentIdentifier	string	The batch reference used to initiate the bulk transfer
status	string	Current status of the batch (e.g., INITIATED, COMPLETED)
totalDebitAmount	number	Total amount that has been debited from the source account
totalCreditedAmount	number	Total amount credited to beneficiaries (so far)
transactionCount	number	Total number of transactions in the batch
successfulTransactions	number	Number of transactions successfully processed
failedTransactions	number	Number of transactions that failed

","urlObject":{"path":["api","v1","interbank","bulk","query-transaction","8851722306"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"603a9cd9-d0aa-4a54-8f06-05c39cab6ab4","name":"Sample Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/query-transaction/8851722306"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 08 Jun 2025 12:39:31 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"batchPaymentIdentifier\": \"479611\",\n \"status\": \"INITIATED\",\n \"totalDebitAmount\": 1477,\n \"totalCreditedAmount\": 0,\n \"transactionCount\": 5,\n \"successfulTransactions\": 0,\n \"failedTransactions\": 4\n }\n}"}],"_postman_id":"b8e14acd-b8bf-4c2a-8dd3-0d341070ad93"},{"name":"Query Transaction (Bulk Payment)- Get Transaction Details","event":[{"listen":"prerequest","script":{"id":"bc994dda-7fe1-43ef-8cc4-afe1a51df0fb","exec":["let bulkReference = pm.collectionVariables.get(\"batchPaymentIdentifier\");","","pm.collectionVariables.set(\"bulkReference\", bulkReference);"],"type":"text/javascript","packages":{}}}],"id":"bd22e3dd-5ba5-4ea6-b5d4-b18a3a2196d8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/transaction/detail/8851722306","description":"

Fetches all transaction-level records under a bulk transaction reference. Useful for tracking the status of each individual transfer in the batch.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
bulkReference	string	The unique identifier of the bulk batch.

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
transactions	array	List of individual transactions in the batch
transactions[].paymentIdentifier	string	Reference ID of the transaction
transactions[].status	string	Current status of the transaction (e.g., INITIATED, SUCCESS)
pagination.currentPage	number	Current page in paginated results
pagination.pageSize	number	Number of items per page
pagination.totalPages	number	Total number of pages
pagination.totalItems	number	Total number of transactions in the result set

","urlObject":{"path":["api","v1","interbank","bulk","transaction","detail","8851722306"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"920c5347-da68-44a4-9cb7-865455632765","name":"Sample Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/transaction/detail/8851722306"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 08 Jun 2025 12:40:09 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"transactions\": [\n {\n \"paymentIdentifier\": \"479612\",\n \"status\": \"INITIATED\"\n },\n {\n \"paymentIdentifier\": \"479613\",\n \"status\": \"INITIATED\"\n },\n {\n \"paymentIdentifier\": \"479614\",\n \"status\": \"INITIATED\"\n },\n {\n \"paymentIdentifier\": \"479615\",\n \"status\": \"INITIATED\"\n }\n ],\n \"pagination\": {\n \"currentPage\": 0,\n \"pageSize\": 4,\n \"totalPages\": 1,\n \"totalItems\": 4\n }\n }\n}"}],"_postman_id":"bd22e3dd-5ba5-4ea6-b5d4-b18a3a2196d8"},{"name":"Query Transaction (Bulk Payment)- Get Single Transaction Details","event":[{"listen":"prerequest","script":{"id":"6c006e87-3c8d-4139-9497-199b6ea7b561","exec":["let bulkReference = pm.collectionVariables.get(\"batchPaymentIdentifier\");","let transRef1 = pm.collectionVariables.get(\"paymentIdentifier1\");","","pm.collectionVariables.set(\"bulkReference\", bulkReference);","pm.collectionVariables.set(\"transRef1\", transRef1);"],"type":"text/javascript","packages":{}}}],"id":"25678a09-338f-410f-9164-0632ed99f9cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/single-transaction/status/8851722306/205650600765","description":"

Retrieves full details of a specific transaction within a bulk batch using its paymentIdentifier.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
bulkReference	string	Unique identifier for the batch transaction
paymentIdentifier	string	Unique identifier for the individual transaction

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
paymentIdentifier	string	Unique ID for the individual transaction
status	string	Status of the transaction (e.g., INITIATED, SUCCESS, FAILED)
destinationAccount	string	Destination account number
amount	number	Amount transferred
narration	string	Narration for this specific transaction
responseCode	string	Response status code (e.g., 00 for success)
responseMessage	string	Response message describing the result

","urlObject":{"path":["api","v1","interbank","bulk","single-transaction","status","8851722306","205650600765"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"b31bb484-79e3-4ead-80db-07582978982b","name":"Sample Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/interbank/bulk/single-transaction/status/8851722306/205650600765"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 08 Jun 2025 12:40:35 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"paymentIdentifier\": \"479612\",\n \"status\": \"INITIATED\"\n }\n}"}],"_postman_id":"25678a09-338f-410f-9164-0632ed99f9cd"}],"id":"b174ec03-da75-4a6e-a3a3-44f1bcfb5747","description":"

Getting Started

Follow the steps below to start using the REST Interface:

Register on RemitaConnect using the invitation link sent to you by Remita.
\n
Retrieve your Secret Key: Navigate to the API Credentials page to copy your secret key.
\n

Important Note:

Whilsting your IP is not necessary for use of the API on the Test Environment but is required on the production environment

\n","_postman_id":"b174ec03-da75-4a6e-a3a3-44f1bcfb5747"},{"name":"SOAP Interface","item":[{"name":"Name Inquiry","event":[{"listen":"test","script":{"id":"dd4d35ef-f20c-4b88-96e5-c79c0e01a754","exec":["// Get the XML response body","let responseBody = pm.response.text();","","// Use regex to extract the value inside the tag","let match = responseBody.match(/(.*?)<\\/return>/);","","if (match && match[1]) {"," let returnValue = match[1].trim(); // Trim whitespace if any"," "," // Save the extracted value as a collection variable"," pm.collectionVariables.set(\"encryptedResponseBody\", returnValue);"," "," console.log(\"Extracted return value:\", returnValue);","} else {"," console.log(\"No tag found in the response.\");","}"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"799917eb-d27f-4e04-bddb-f569233caa7b","exec":[""],"type":"text/javascript","packages":{}}}],"id":"a42430f6-1c6e-450e-a9f1-44e90d8907e6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc","type":"text"},{"key":"Content-Type","value":"text/xml","type":"text"}],"body":{"mode":"raw","raw":"\n \n \n \n \n {{encryptedResponseBody}}\n \n \n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService","description":"

To send a Name Inquiry request via the SOAP Interface, kindly encrypt the below XML request body using the encryption method using the Remita PGP Public Key (the security section above).

<?xml version=\"1.0\" encoding=\"UTF-8\"?><NESingleRequest><SessionID>00007825030714244120834541293</SessionID><DestinationInstitutionCode>000013</DestinationInstitutionCode><ChannelCode>1</ChannelCode><AccountNumber>0589207929</AccountNumber></NESingleRequest>\n\n

The encrypted response should be passed in the request tag in the Name Inquiry request

\n","urlObject":{"path":["FUSION","FUSION","BankFusionService"],"host":["http://192.168.104.21:8323"],"query":[],"variable":[]}},"response":[{"id":"a2aae20e-05c8-405c-8acd-4d5d46bc333a","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc","type":"text"},{"key":"Content-Type","value":"text/xml","type":"text"}],"body":{"mode":"raw","raw":"\n \n \n \n \n {{encryptedResponseBody}}\n \n \n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Accept","value":"text/xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2"},{"key":"Expires","value":"0"},{"key":"SOAPAction","value":"\"\""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Fri, 07 Mar 2025 13:01:41 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"text/xml;charset=utf-8"},{"key":"Content-Length","value":"1409"}],"cookie":[],"responseTime":null,"body":"\n \n \n \n 85010C03274675693BF15FEA0107FB05A6D76A4E187688C61522FD8CD7C43583825EA584839ABBC0633A207B7041914EE3059A28ECE706410015C6965A1D147DDE3A7DD177256CED385E1CE0F4FCA7E63D75C9C4216D1AF5C105DAC99B0C95AC7FDD5C89C7B96B4F4F0FDAD2DA9145538AF743467C63E3A27AA58887308C3FB008EDA07175925E1326C92E940D37014B72C75258C766B94C47B836E4C6D84341647E1EA95899B790513BDA9B4E9B821101462E3E4C49916435E3F2C24E2DAD9D398AE32AE7732FAD1E4ADEE2C618D46818475B43997575E3CC13D6DC2817FA9775EEE486A73ED641894766F02B144068E89AC15B9BCF669DB184E8BF4D4A4D0EEB71B69A4986929732DD4F53C2AFB9C9C063B4216961BCB2ED509F1E4D57467D798FBE8449410452F3596536CA12522DA6787ECB7CBAC50E08A94D33D3937F7E6C71D88491AF681D285BCFB81A872731AA0E7655461BF480E3C74131A31D74A13ABC203156986B10F6C832D8CCD2A74CE3450B36F79E5C397B3B6BEB4EAA89E548211532B0CADF3F0313BCE283061547618A67FF6D85B72CDCD718831A69ED1DE9017ADD8C30586293D558237A735E2C77C2E2A0D434A5703F06C14D146AEC0E0910125A34454C7C8F296C69A26E72D602C03EBAD39236A0072680BA2D5440B92755BFEB955F8DA513EAA1FBA16F99C6D24FA4420B87A4A5E376C10507C9C630E38772CE166DBAFBE82AC45E6C881C9467A1887091D30E87CAF9EE390B270131FCB51307357164387B1B14C74C1904765D5C1D019A;\n \n \n"}],"_postman_id":"a42430f6-1c6e-450e-a9f1-44e90d8907e6"},{"name":"Funds Transfer","event":[{"listen":"test","script":{"id":"729901eb-17e8-4f52-a275-42f327564191","exec":["// Get the XML response body","let responseBody = pm.response.text();","","// Use regex to extract the value inside the tag","let match = responseBody.match(/(.*?)<\\/return>/);","","if (match && match[1]) {"," let returnValue = match[1].trim(); // Trim whitespace if any"," "," // Save the extracted value as a collection variable"," pm.collectionVariables.set(\"encryptedResponseBody\", returnValue);"," "," console.log(\"Extracted return value:\", returnValue);","} else {"," console.log(\"No tag found in the response.\");","}"],"type":"text/javascript","packages":{}}}],"id":"d11021f7-ddec-45ce-a729-c02f5da61435","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc"},{"key":"Content-Type","value":"text/xml"}],"body":{"mode":"raw","raw":"\n\n\n\n\n{{encryptedResponseBody}}\n\n\n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService","description":"

To send a Funds Transfer request via the SOAP Interface, kindly encrypt the below request body using the encryption method using the Remita PGP Public Key (the security section above).

<?xml version=\"1.0\" encoding=\"UTF-8\"?><FTSingleCreditRequest><SessionID>00007825030714244120834541293</SessionID><NameEnquiryRef>00007825030714244120834541293</NameEnquiryRef><DestinationInstitutionCode>000013</DestinationInstitutionCode><ChannelCode>1</ChannelCode><BeneficiaryAccountName>Aniceto Farias</BeneficiaryAccountName><BeneficiaryAccountNumber>0589207929</BeneficiaryAccountNumber><BeneficiaryBankVerificationNumber>1741353888151</BeneficiaryBankVerificationNumber><BeneficiaryKYCLevel>1</BeneficiaryKYCLevel><OriginatorAccountName>Aniceto Farias</OriginatorAccountName><OriginatorAccountNumber>0586957398</OriginatorAccountNumber><OriginatorBankVerificationNumber>1741353888151</OriginatorBankVerificationNumber><OriginatorKYCLevel>1</OriginatorKYCLevel><TransactionLocation>6.4300747,3.4110715</TransactionLocation><Narration>Payment for invoice #12345;RESPCODE:USE_CUSTOM_CODE,00;TIMEOUT:USE_CUSTOM_TIMEOUT,1;TQSCODES:[00:1]</Narration><PaymentReference>00007825030714244120834541293</PaymentReference><Amount>2906.17</Amount></FTSingleCreditRequest>\n\n

The encrypted response should be passed in the request tag in the Funds Transfer request

\n","urlObject":{"path":["FUSION","FUSION","BankFusionService"],"host":["http://192.168.104.21:8323"],"query":[],"variable":[]}},"response":[{"id":"3a1261ef-e3cf-426b-b0bf-b2e25e303c34","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc"},{"key":"Content-Type","value":"text/xml"}],"body":{"mode":"raw","raw":"\n\n\n\n\n{{encryptedResponseBody}}\n\n\n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Accept","value":"text/xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2"},{"key":"Expires","value":"0"},{"key":"SOAPAction","value":"\"\""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Fri, 07 Mar 2025 13:48:32 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"text/xml;charset=utf-8"},{"key":"Content-Length","value":"2692"}],"cookie":[],"responseTime":null,"body":"\n \n \n \n 85010C03274675693BF15FEA0107FF58D216F0C337AF67E4A0B41AFC458269FD686A4644863DC3D9B7A29F629EA8B4278E55FBA85E3C2CBFF726F2561979D895057DCF4A9025732CC88F7FE9037EE76E4BDE323B008206753B65E74BFCB8D50934A6C81C67A19E9D9B139BD9B12A0A490E70E501B2A6344604EC9CA4CCC5C16E26A2CEE8B92D21E40DEDF24C79EAC8D1986BBEBAE92B6573F830B4EB07CFECF28FA6E01E1935B000402CB65475AEF1CE74A5F45BFA6AFFCC80B5E7702B9CA0C9BE3EA8D0F27F8C7FE9A2DD571A0CDD9559865F4C236E8436A4077F60AFEDC84A99F0162301F846591F8310A6BC6DB87D5414DFED254D98FAA17019F9E954A123101729D854BC26ED75C6586596D767C9C11260E9CD9B6A71358927DDF3E312E3220057DAC808B7BF0E427D2477DA75267C575F0B37FD1AA35A1ACAD8A477A1EAF6ACB71D63A0031C0A60BCB35205A1512D8F07A4BE2ACC9903604981C0E0D9A9EC7FA70EA8412E68E81B38C51BF304886F288BE5426DC694FA119894B8BAEAFE30BB2F055BA22E649B206ABD7B2DE3DD47202C7D21C0B2A116D7F6594DAD829B13DF78AA5B723E297B78952E7BF16810FCCFD275BC638B26042F38DC3F0678F24C781F6A752725047DE8A6080239C1D33A643F1B749737753990F8F63CC590FC788698FE19AC6537DBFF096828C7A9348C4851F60DDCF0FB8FFA5FEA38E9097DA4333169665743C5C7F36138F492FDDA0AC9C8F3D5A72983289B22CAF741653445B706E07A2529F0EB9264AC3310DA5F9AC5CCCDD9E298608E4B6B35002EC9AE1593A6546816822D8FEEA1222B1590BF03631875D975DA90C67BD9205FEA9052CF195FEFC3EAE8E0685A2D8D6E6F1304D17F12D18C94D26BA0C4B56322DD994419198A4E95802AC82F0C10396825816F6D21CBFE7AEA68B0238DFFFA53D98E30D4D9D0F0B5D65E30567686716FDC38764A52F3ADCD41E233D53211573DBFB6D82E77C0DC3186B45BFB7C63BCEA8DC4FF11A1A15A9CA550F97195C019841C90C0170C6F2F;85010C03274675693BF15FEA0107FF52FBCB77911DE6B61855D8FD0A9A58FC5240DEBACB857EC050B61AE5B4D9259DB849BE9DE947A78B406DB3D9E3072F5B9135E6DA1F49F9249D1635F14D966B4C0D2057DBCA63FC4D7F202274B90A3A231FCFF0AE80E6C0016F125A485C4E5E811B72C2678D20567A2357009522C9D262D0A66CD7333C84030A60B22AC80174B540391C2AD43631FC0F6CDA3485D8C7155D6A3990ECCBD9D7594AEFAF2976374293DC437BF8CDB46C286F5F951CADF73141D4304A0396F6BCB8BA114A8063E8853EA60CFD7DAC0CE47E99E7C08CC0A547FED2CC95076D11B769EFB20843E1964CD2939BCB839E3547D22D92C0FEADD0A0DBB90C6E1C5BD0F344862A1500842F67C9BD9B3279D2F10FAFC183C2A769B480CE9712D1E849D2A36B37895C3186BA0DBCA28CB01DE6A462BB146F09C9765793C246267F497365559D2ECA16F906005A0DB211293824FF693BA59217A34E9A12FB9DC4CE23B584D4D2DAACBAEB42482ABB80FC94E4DF06FA780A6CB0F6A3634A478BE8684A3D4579A225FE001711D1D72382F81B715EAB32CD292F2C74C39FF474AF14E7E5CABA8E4578B8B58702E7A06485419809B5C2273ABFE7397F54FE91612119D311AAE50945CC09D028B1C4;\n \n \n"}],"_postman_id":"d11021f7-ddec-45ce-a729-c02f5da61435"},{"name":"Transaction Status Query","event":[{"listen":"test","script":{"id":"80d4e5ef-7cfc-4676-a467-589359ede780","exec":["// Get the XML response body","let responseBody = pm.response.text();","","// Use regex to extract the value inside the tag","let match = responseBody.match(/(.*?)<\\/return>/);","","if (match && match[1]) {"," let returnValue = match[1].trim(); // Trim whitespace if any"," "," // Save the extracted value as a collection variable"," pm.collectionVariables.set(\"encryptedResponseBody\", returnValue);"," "," console.log(\"Extracted return value:\", returnValue);","} else {"," console.log(\"No tag found in the response.\");","}"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"id":"d42abf87-5e78-4393-b72c-a69e433f8e50","exec":[""],"type":"text/javascript","packages":{}}}],"id":"2f357d51-353c-437b-8c54-c09109b3f66f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc"},{"key":"Content-Type","value":"text/xml"}],"body":{"mode":"raw","raw":"\n \n \n \n \n {{encryptedResponseBody}}\n \n \n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService","description":"

To send a Transaction Status Query request via the SOAP Interface, kindly encrypt the below request body using the encryption method using the Remita PGP Public Key (the security section above).

<?xml version=\"1.0\" encoding=\"UTF-8\"?><TSQuerySingleRequest><SourceInstitutionCode>000013</SourceInstitutionCode><ChannelCode>1</ChannelCode><SessionID>00007825030714244120834541293</SessionID></TSQuerySingleRequest>\n\n

The encrypted response should be passed in the request tag in the Transaction Status Query request

\n","urlObject":{"path":["FUSION","FUSION","BankFusionService"],"host":["http://192.168.104.21:8323"],"query":[],"variable":[]}},"response":[{"id":"f7ac3060-d9bc-46d1-bdaa-eb15243a254c","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"SOAPAction","value":"fundtransfersingleitem_dc"},{"key":"Content-Type","value":"text/xml"}],"body":{"mode":"raw","raw":"\n \n \n \n \n {{encryptedResponseBody}}\n \n \n","options":{"raw":{"language":"xml"}}},"url":"http://192.168.104.21:8323/FUSION/FUSION/BankFusionService"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Accept","value":"text/xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2"},{"key":"Expires","value":"0"},{"key":"SOAPAction","value":"\"\""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"X-XSS-Protection","value":"0"},{"key":"Pragma","value":"no-cache"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Date","value":"Fri, 07 Mar 2025 13:49:06 GMT"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Type","value":"text/xml;charset=utf-8"},{"key":"Content-Length","value":"1293"}],"cookie":[],"responseTime":null,"body":"\n \n \n \n 85010C03274675693BF15FEA0107FE32B1D998ACCDCFE22D7142FCC756E43894FE156BA4973BA6A5FAFCAFC545BB524B8545CCEF6BFDB3B09FF88ABB5F1203894175BA91E1A8AA40320921BC9F3F8867EBE082638920E086C2DDC09FDE8FF4CC301F26158DE0CE9A382682CE7059AEA2EE1F5C7CA1CF8840018234FAE83A4B50A52063D7930FFE5C90175A9127F2E044FE0E181998BC01E4B40C42EE5D18D6D6602770ECC0BA19C0409CD5E718A2956B1D6F02879FA3AEF1306AEE98040C0C16911900B6D618A71EAC53E86E0B53967DC15BAE30893999DF065EF7E09F5CF95977769E55BDB0588529D27B35DB90A6E66F9A1B283FF2C753896330B5B940492E5C483C5D357583F8B052075A6D8329C9C0263CB1982B9E56499AE9804D231D529B69AC939FCBB4FDB136B21D10CE3518D74AE1082A33D4CCA6AB81DFFBAC883B23A946D2EC0021450497E63F55A1FB720959A191A04ABB149786EBCDE498C2B8D07CE275CCFB6181F3B89C6D8540DAE93897D096B8E2E12A460E99636B24D4EE57BA1DB1AA32D2132C66B25B9154D72187430B00500EF2AE80D6024F33682E2CA01AE2DC050F4C473B7AAC897A6942087D6B3A4F5F963113BD81CF7CF51B9FA55536B26EF9AFB05CFCB85B2713613299759D96D26F7115CB59968782529ED56265EEC13DAD8A20864A17AB121DC30A6E3EFBA69B83C076F0;\n \n \n"}],"_postman_id":"2f357d51-353c-437b-8c54-c09109b3f66f"}],"id":"5e7ee787-74f5-4dae-8fc0-d3126e9757dc","description":"

Getting Started

Follow the steps below to set up and start using the SOAP Interface:

Register on RemitaConnect using the invitation link sent to you by Remita.
\n
Complete your Personal KYC and set up Two-Factor Authentication (2FA) by navigating to the Activation menu.
\n
Use the Test Environment for initial setup and API testing. When you’re enabled for the Production environment, repeat these steps to complete your Production setup.
\n
Upload Your Test PGP Public Key:
\n
Go to the API Credentials page on the Test Environment to save your PGP Public Key. See the image below for reference.
\n

\n\n

You can either paste the Base64-encoded string of your PGP Public Key into the input field highlighted above, or upload the key file using the upload option shown.
\n
Copy Remita’s PGP Public Key from the highlighted section on the API Credentials page. You will use this to encrypt your requests.
\n
Whitelist Your Preferred IPs by entering them in the relevant section shown in the image above.
\n

You are now set to utilize the SOAP Interface. The below sections will explain how to utilize the service whilst encrypting your requests with our PGP Public Key that you have copied

Authentication

The security of message exchanges between institutions and Remita is ensured through the following measures:
\n
HTTPS: All API calls must be made over HTTPS to ensure data encryption in transit.
\n
PGP Encryption: The XML payload must be encrypted using REMITA’s PGP before transmission.
\n
1. Encryption Process:
  \n
  1. Serialize the XML request object to a string.
    \n
  2. Encrypt the XML string using the recipient's (Remita's) public PGP key.
    \n
  \n
2. Decryption Process (for responses):
  \n
  1. Decrypt the data using your private PGP key.
    \n
  2. Parse the decrypted XML string to obtain the response object.
    \n
  \n
3. Response Structure: The response will be in plain text, containing the PGP-encrypted XML payload.
  \n
\n
Key Management:
\n
1. Public Key: Remita will provide its public PGP key for encrypting requests.
  \n
2. Private Key: Keep your private PGP key secure for decrypting responses.
  \n
\n
Key Exchange: Initial key exchange should be performed through a secure, out-of-band method.
\n
IP Whitelisting: API access is restricted to specific IP addresses or ranges for production environments
\n

Contact our Solution Delivery Team (solutiondelivery@systemspecs.com.ng) to get the Remita's Test Public Key to be used for your Tests and Implementation

\n","_postman_id":"5e7ee787-74f5-4dae-8fc0-d3126e9757dc"},{"name":"Response Codes","item":[],"id":"fce30f4f-c6df-470c-bb30-f7ff323d2d95","description":"

Important Note:

The Response Codes for the Financial Instituion APIs are different from the Response Codes applicable to the Non-Financial Institution APIs. For the response codes for the Non-Financial Instituions, click here

Response Code	Response Message	State
00	Approved or completed successfully	Successful
01	Status unknown, please wait for settlement report	Pending
09	Request processing in progress	Pending
03	Invalid Sender	Failed
05	Do not honor	Failed
06	Dormant Account	Failed
07	Invalid Account	Failed
08	Account Name Mismatch	Failed
12	Invalid transaction	Failed
13	Invalid Amount	Failed
14	Invalid Batch Number	Failed
15	Invalid Session or Record ID	Failed
16	Unknown Bank Code	Failed
17	Invalid Channel	Failed
18	Wrong Method Call	Failed
19	Payment Reference Cannot Be Found	Failed
21	No action taken	Failed
22	Error Occurred Getting Transaction Status	Failed
23	Payment Reference Exist. Transaction Under Investigation	Failed
24	Unable To Debit	Failed
25	Unable to locate record	Failed
26	Duplicate record	Failed
30	Format error	Failed
31	Unable To Do TSQ	Failed
33	Exceptions Raised During Name Enquiry	Failed
34	Suspected fraud	Failed
35	Contact sending bank	Failed
36	Unable To Call Main Fund Transfer Service	Failed
37	Unable To Call Main Transaction Status Service	Failed
38	Unable To Call Main Name Enquiry Service	Failed
39	Unable To Call Main Bank List Service	Failed
40	Function Not Supported	Failed
51	No sufficient funds	Failed
57	Transaction not permitted to sender	Failed
58	Transaction not permitted on channel	Failed
61	Transfer limit Exceeded	Failed
63	Security violation	Failed
65	Exceeds withdrawal frequency	Failed
68	Response received too late	Failed
69	Unsuccessful Account/Amount block	Failed
70	Unsuccessful Account/Amount unblock	Failed
71	Empty Mandate Reference Number	Failed
80	Settlement/NIP Per Transaction Limit Exceeded	Failed
81	Processing Delay	Failed
82	Invalid Response Code From Destination Institution	Failed
91	Beneficiary Bank not available	Failed
92	Routing error	Failed
94	Duplicate transaction	Failed
96	System malfunction	Failed
97	Timeout waiting for response from destination	Failed
102	Transaction Failed	Failed
104	Transaction Failed	Failed

","_postman_id":"fce30f4f-c6df-470c-bb30-f7ff323d2d95"}],"id":"e04c8700-2e90-4623-93fc-02de45fc5f76","description":"

Our Funds transfer APIs will enable you to process account-to-account payments.

There are two types of Fund Transfer requests

Single Payment: Single Debit, Single Credit Transfers.
\n
Bulk Payment: Single Debit, Multiple Credit Transfers.
\n

There are presently two Interfaces to access these APIs- the REST API Interface and the SOAP Interface

The Rest API Interface contains APIs that will allow a user to check the Bank List, Name Inquiry, Funds Transfer for (Single and Bulk payments), and to check the status of transactions. This interface is available to Financial Institutions and Non-Financial Institutions alike.
\n
The SOAP Interface APIs are only available to Financial Institutions. They help financial institutions perform Name Inquiry, Funds Transfer for (Single payments), and check the status of transactions. Bulk Payment is not available on the SOAP Interface.
\n

\n","_postman_id":"e04c8700-2e90-4623-93fc-02de45fc5f76"},{"name":"Collections","item":[{"name":"APIs","item":[{"name":"Generate Bill","item":[{"name":"Get Billers","event":[{"listen":"prerequest","script":{"id":"985cdd47-fd45-4983-bc8f-a6cb95288a57","exec":[""],"type":"text/javascript","packages":{}}}],"id":"8ac0986f-9df3-477c-b2aa-9222e42e2723","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-billers?page=0&size=2000","description":"

Retrieve Billers List

This API endpoint makes an HTTP GET request to retrieve a list of billers with pagination support.

Request

Method: GET
\n
URL: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-billers
\n
Query Parameters:
\n
- page (number): The page number for pagination.
  \n
- size (number): The number of items per page.
  \n
\n

\n","urlObject":{"path":["api","v1","biller","get-billers"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[{"key":"page","value":"0"},{"key":"size","value":"2000"}],"variable":[]}},"response":[{"id":"a74a2750-0e73-4d8a-8012-6af74c7c33fa","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":{"raw":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-billers?page=0&size=20","host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"path":["api","v1","biller","get-billers"],"query":[{"key":"page","value":"0"},{"key":"size","value":"20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sat, 26 Oct 2024 21:52:13 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"_meta\": null,\n \"_links\": null,\n \"code\": null,\n \"data\": [\n {\n \"billerId\": \"C0000264104\",\n \"billerName\": \"9-Mobile\",\n \"billerShortName\": \"9-Mobile\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/9mobile_f3ctnl.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"SPECSELECTRICITY\",\n \"billerName\": \"ABUJA ELECTRICITY DISTRIBUTION COMPANY\",\n \"billerShortName\": \"ABUJA ELECTRICITY DISTRIBUTION COMPANY\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Abuja_Electric_voosmh.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000264103\",\n \"billerName\": \"AIRTEL\",\n \"billerShortName\": \"AIRTEL\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Airtel_avwvem.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000168838\",\n \"billerName\": \"Black World\",\n \"billerShortName\": \"Black World\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000190361\",\n \"billerName\": \"Dark Fruit Inc\",\n \"billerShortName\": \"Dark Fruit Inc\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000120293\",\n \"billerName\": \"EKO ELECTRICITY DISTRIBUTION PLC\",\n \"billerShortName\": \"EKO ELECTRICITY DISTRIBUTION PLC\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Eko_Electric_1_g8siit.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000164693\",\n \"billerName\": \"Enugu Electricity Distribution Company (EEDC)\",\n \"billerShortName\": \"Enugu Electricity Distribution Company (EEDC)\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Enugu_Electric_estzsa.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"S0000572202\",\n \"billerName\": \"FEDERAL ROAD SAFETY CORPS\",\n \"billerShortName\": \"FEDERAL ROAD SAFETY CORPS\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1712256663/FRSC-1_ix2tsg.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"DEMOMDA\",\n \"billerName\": \"GENESIS GROUP\",\n \"billerShortName\": \"GENESIS GROUP\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000264101\",\n \"billerName\": \"GLO\",\n \"billerShortName\": \"GLO\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952128/Biller%20API%20Images/GLO_kmutze.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000164691\",\n \"billerName\": \"Ibadan Electricity Distribution Company (IBEDC)\",\n \"billerShortName\": \"Ibadan Electricity Distribution Company (IBEDC)\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952126/Biller%20API%20Images/Ibadan_Electric_ukkdyl.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000164682\",\n \"billerName\": \"Ikeja Electric\",\n \"billerShortName\": \"Ikeja Electric\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Ikeja_Electric_whxao0.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"JAMB\",\n \"billerName\": \"JOINT ADMISSIONS MATRICULATION BOARD -(JAMB) - 051700500100\",\n \"billerShortName\": \"JOINT ADMISSIONS MATRICULATION BOARD -(JAMB) - 051700500100\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"JEDC\",\n \"billerName\": \"JOS ELECTRICITY DISTRIBUTION COMPANY\",\n \"billerShortName\": \"JOS ELECTRICITY DISTRIBUTION COMPANY\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952126/Biller%20API%20Images/Jos_Electric_mled2q.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000288503\",\n \"billerName\": \"KEDCO ( KADUNA ELECTRICITY DISTRIBUTION COMPANY)\",\n \"billerShortName\": \"KEDCO ( KADUNA ELECTRICITY DISTRIBUTION COMPANY)\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Kaduna_Electric_ldxrem.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000263754\",\n \"billerName\": \"MTNN\",\n \"billerShortName\": \"MTNN\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952128/Biller%20API%20Images/MTN_cngsta.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000566058\",\n \"billerName\": \"Michelle World\",\n \"billerShortName\": \"Michelle World\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"QATEST\",\n \"billerName\": \"NSITF\",\n \"billerShortName\": \"NSITF\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"C0000242328\",\n \"billerName\": \"PORT HARCOURT ELECTRICITY DISTRIBUTION COMPANY ( PHED )\",\n \"billerShortName\": \"PORT HARCOURT ELECTRICITY DISTRIBUTION COMPANY ( PHED )\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Port_Harcourt_Electric_b8jurq.png\",\n \"countryCode\": \"NGN\"\n },\n {\n \"billerId\": \"QADEMO\",\n \"billerName\": \"QA CORPORATION\",\n \"billerShortName\": \"QA CORPORATION\",\n \"billerLogoUrl\": null,\n \"countryCode\": \"NGN\"\n }\n ]\n}"}],"_postman_id":"8ac0986f-9df3-477c-b2aa-9222e42e2723"},{"name":"Get Categories","id":"26d762ce-b5d3-4c09-a5dc-762adf1cb93c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-categories?page=0&size=20","description":"

GET /api/v1/biller/get-categories

The API endpoint retrieves categories with pagination from the biller service.

Request

Method: GET
\n
URL: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-categories
\n
Query Parameters:
\n
- page (number, required): The page number for pagination.
  \n
- size (number, required): The number of items per page.
  \n
\n

\n","urlObject":{"path":["api","v1","biller","get-categories"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[{"key":"page","value":"0"},{"key":"size","value":"20"}],"variable":[]}},"response":[{"id":"d044b1e1-3de7-4562-ab16-5be0f55c2b0f","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":{"raw":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-categories?page=0&size=20","host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"path":["api","v1","biller","get-categories"],"query":[{"key":"page","value":"0"},{"key":"size","value":"20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sat, 26 Oct 2024 21:55:57 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"_meta\": null,\n \"_links\": null,\n \"code\": null,\n \"data\": [\n {\n \"categoryId\": \"1\",\n \"categoryName\": \"Airtime & Data\",\n \"categoryDescription\": \"Airtime & Data\"\n },\n {\n \"categoryId\": \"10\",\n \"categoryName\": \"Credit and Loans\",\n \"categoryDescription\": \"Credit and Loans\"\n },\n {\n \"categoryId\": \"11\",\n \"categoryName\": \"Associations and Societies\",\n \"categoryDescription\": \"Associations and Societies\"\n },\n {\n \"categoryId\": \"12\",\n \"categoryName\": \"Religious Institutions\",\n \"categoryDescription\": \"Religious Institutions\"\n },\n {\n \"categoryId\": \"13\",\n \"categoryName\": \"Insurance\",\n \"categoryDescription\": \"Insurance and HMO\"\n },\n {\n \"categoryId\": \"15\",\n \"categoryName\": \"Other Billers\",\n \"categoryDescription\": \"Other Billers\"\n },\n {\n \"categoryId\": \"16\",\n \"categoryName\": \"Hospitals\",\n \"categoryDescription\": \"Hospitals\"\n },\n {\n \"categoryId\": \"17\",\n \"categoryName\": \"Micro Pensions\",\n \"categoryDescription\": \"Micro Pensions\"\n },\n {\n \"categoryId\": \"2\",\n \"categoryName\": \"Cable TV\",\n \"categoryDescription\": \"Cable and TV\"\n },\n {\n \"categoryId\": \"3\",\n \"categoryName\": \"Electricity\",\n \"categoryDescription\": \"Electricity Bill Payments and Metering\"\n },\n {\n \"categoryId\": \"4\",\n \"categoryName\": \"Internet Services\",\n \"categoryDescription\": \"Internet and Services\"\n },\n {\n \"categoryId\": \"5\",\n \"categoryName\": \"Utilities\",\n \"categoryDescription\": \"Bill Payment for Utility and related amenities\"\n },\n {\n \"categoryId\": \"6\",\n \"categoryName\": \"Educational Institutions\",\n \"categoryDescription\": \"Educational Institutions\"\n },\n {\n \"categoryId\": \"7\",\n \"categoryName\": \"Government Payments\",\n \"categoryDescription\": \"Government Payments\"\n },\n {\n \"categoryId\": \"8\",\n \"categoryName\": \"Taxes, Internal and Inland Revenue\",\n \"categoryDescription\": \"Taxes, Internal and Inland Revenue\"\n },\n {\n \"categoryId\": \"9\",\n \"categoryName\": \"Financial Services\",\n \"categoryDescription\": \"Financial Services\"\n },\n {\n \"categoryId\": \"999\",\n \"categoryName\": \"Invoice Category\",\n \"categoryDescription\": \"Invoice Category\"\n }\n ]\n}"}],"_postman_id":"26d762ce-b5d3-4c09-a5dc-762adf1cb93c"},{"name":"Get Category by ID","id":"b7be1614-b5d7-44a7-a3c4-a1ea51f12b7b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-biller-by-category/3","description":"

Get Biller by Category

This API endpoint retrieves billers based on the provided category ID.

Request

Method: GET
\n
URL: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-biller-by-category/6
\n

\n","urlObject":{"path":["api","v1","biller","get-biller-by-category","3"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"7549bbb2-92b2-41d9-ac89-2b911f085f74","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/get-biller-by-category/{{categoryId}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:50:10 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": [\n {\n \"billerId\": \"S0000573002\",\n \"billerName\": \"UNIVERSITY OF IBADAN\",\n \"billerShortName\": \"UNIVERSITY OF IBADAN\",\n \"billerLogoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1713520817/AU_REC_logos_-_2022-04-04T113109.892_xbopn8.png\",\n \"countryCode\": \"NGN\"\n }\n ]\n}"}],"_postman_id":"b7be1614-b5d7-44a7-a3c4-a1ea51f12b7b"},{"name":"Get Biller Products","event":[{"listen":"prerequest","script":{"id":"36fe37a9-907d-4bfe-988d-0dffd9f0b56e","exec":["pm.collectionVariables.set(\"billerId\",\"QATEST\");"],"type":"text/javascript","packages":{}}}],"id":"cc5a3728-16dc-486b-b1ee-0e2e86d59ba4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/S0000573002/products","description":"

Get Biller Products

This API endpoint retrieves the products associated with a specific biller. The information obtained from this endpoint is essential for initiating a bill payment.

Custom Fields

Custom fields are additional fields specific to a biller’s product. A product may or may not have custom fields defined. If a product does not have custom fields, the custom fields array will be empty.

The available list of custom field types and their descriptions are as follows:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Custom Field Type	Description
A	Alphabets
AN	Alphanumeric
N	Numeric
D	Date
DD	Single select item list (no price/amount)
SL	Multi select item list (no price/amount)
SP	Multi select item list with price and amount
ALL	Any value

To better understand the response and custom fields, you can compare the form fields with the response from the API by accessing the front end application of the products accessible from the provided link. Between the products Office Building and School Uniform, you will find an example of all custom field types.

Fields and Descriptions

The following fields and their descriptions are available in the response from this API:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Data Type	Description
amount	Numeric	Bill amount, if there is a fixed amount on the product. If the product does not have a fixed amount, the value will be 0.
amountFixed	Boolean	'true' if there is a fixed amount on the product, 'false' if not.
billPaymentProductId	String	The ID of the product.
billPaymentProductName	String	The name of the product.
currency	String	Currency that the product is being sold in.
customerId	String	The value of the validation item in question. For example, if meter number, then the actual meter number of the customer.
customFields	Array	List of custom fields associated with a product (if any).
display_name	String	The name that should be displayed for the custom field on a user interface.
DISPLAY_NAME	String	The value that should be used for the custom field dropdown in subsequent API calls.
required	Boolean	'true' if the custom field in question is a required field, 'false' if not.
selectOptions	Array	The list of values if a custom field is a dropdown.
sortOrder	String	Order in which the custom field in question should be rendered on a user interface in relation to the other custom fields on that product.
type	String	Custom field type.
validation	Boolean	'true' if the custom field in question requires validation, 'false' if not.
VALUE	String	The name that should be displayed for the custom field dropdown item on a user interface.
variable_name	String	The value that should be used for the custom field in subsequent API calls.

Request

Method: GET
\n
URL: https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/S0000573002/products
\n

\n","urlObject":{"path":["api","v1","biller","S0000573002","products"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"12047f67-b4d2-496e-af88-f4b8f8413176","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/S0000573002/products"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:50:58 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"billerId\": \"S0000573002\",\n \"categoryId\": \"6\",\n \"products\": [\n {\n \"billPaymentProductName\": \"ACCOMMODATION UNDERGRADUATE\",\n \"billPaymentProductId\": \"10713664850\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Added Ammenities\",\n \"variable_name\": \"added_ammenities\",\n \"validation\": false,\n \"type\": \"multiselect\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713679673,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": [\n {\n \"ID\": \"10713679674\",\n \"DESCRIPTION\": \"En Suite Bathroom\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"En Suite Bathroom\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713679675\",\n \"DESCRIPTION\": \"Generator\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Generator\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713679676\",\n \"DESCRIPTION\": \"Inverter\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Inverter\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713679677\",\n \"DESCRIPTION\": \"On Campus\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"On Campus\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n }\n ]\n },\n {\n \"display_name\": \"Matriculation Number\",\n \"variable_name\": \"matriculation_number\",\n \"validation\": false,\n \"type\": \"numeric\",\n \"required\": true,\n \"sortOrder\": \"2\",\n \"variableId\": 10713679678,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"HOSTEL FEE\",\n \"billPaymentProductId\": \"10713664870\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Department\",\n \"variable_name\": \"department\",\n \"validation\": false,\n \"type\": \"alphabetic\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713665605,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n },\n {\n \"display_name\": \"Hostel Plan\",\n \"variable_name\": \"hostel_plan\",\n \"validation\": false,\n \"type\": \"singleselect\",\n \"required\": true,\n \"sortOrder\": \"2\",\n \"variableId\": 10713665606,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": [\n {\n \"ID\": \"10713665609\",\n \"DESCRIPTION\": \"Bronze Plan\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Bronze Plan\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665607\",\n \"DESCRIPTION\": \"Diamond Plan\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Diamond Plan\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665608\",\n \"DESCRIPTION\": \"Gold Plan\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Gold Plan\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665610\",\n \"DESCRIPTION\": \"Special plan\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Special plan\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n }\n ]\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"TENDER FEE\",\n \"billPaymentProductId\": \"10713664879\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": []\n }\n },\n {\n \"billPaymentProductName\": \"ACCEPTANCE FEE\",\n \"billPaymentProductId\": \"10713664951\",\n \"isAmountFixed\": true,\n \"amount\": 45000,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": []\n }\n },\n {\n \"billPaymentProductName\": \"GRADUATION GOWN\",\n \"billPaymentProductId\": \"10713665051\",\n \"isAmountFixed\": true,\n \"amount\": 20000,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Graduation Date\",\n \"variable_name\": \"graduation_date\",\n \"validation\": false,\n \"type\": \"date\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713679491,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n },\n {\n \"display_name\": \"Student Number\",\n \"variable_name\": \"student_number\",\n \"validation\": false,\n \"type\": \"alphanumeric\",\n \"required\": true,\n \"sortOrder\": \"2\",\n \"variableId\": 10713679492,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"LATE REGISTRATION\",\n \"billPaymentProductId\": \"10713664975\",\n \"isAmountFixed\": true,\n \"amount\": 20000,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Level\",\n \"variable_name\": \"level\",\n \"validation\": false,\n \"type\": \"alphanumeric\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713665464,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n },\n {\n \"display_name\": \"Matric no.\",\n \"variable_name\": \"matric_no.\",\n \"validation\": false,\n \"type\": \"alphanumeric\",\n \"required\": true,\n \"sortOrder\": \"2\",\n \"variableId\": 10713665463,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n },\n {\n \"display_name\": \"Department\",\n \"variable_name\": \"department\",\n \"validation\": false,\n \"type\": \"alphabetic\",\n \"required\": true,\n \"sortOrder\": \"3\",\n \"variableId\": 10713665462,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"GRANTS UI: SPORT PROCEEDS\",\n \"billPaymentProductId\": \"10713665036\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": []\n }\n },\n {\n \"billPaymentProductName\": \"TUITION FEES\",\n \"billPaymentProductId\": \"10713679596\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Matriculation Number\",\n \"variable_name\": \"matriculation_number\",\n \"validation\": false,\n \"type\": \"numeric\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713679595,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"GRANT UI: DONATION\",\n \"billPaymentProductId\": \"10713664906\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Donation Type\",\n \"variable_name\": \"donation_type\",\n \"validation\": false,\n \"type\": \"multiselect\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713665755,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": [\n {\n \"ID\": \"10713665799\",\n \"DESCRIPTION\": \"Community\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Community\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665800\",\n \"DESCRIPTION\": \"Less privileged\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Less privileged\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665801\",\n \"DESCRIPTION\": \"Orphanage\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Orphanage\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665802\",\n \"DESCRIPTION\": \"Renovation\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"Renovation\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n },\n {\n \"ID\": \"10713665803\",\n \"DESCRIPTION\": \"School\",\n \"UNITPRICE\": 0,\n \"ACCOUNTID\": 0,\n \"CODE\": \"School\",\n \"FIXEDPRICE\": \"false\",\n \"ITEMPHOTO\": null,\n \"ITEMNAME\": null\n }\n ]\n }\n ]\n }\n },\n {\n \"billPaymentProductName\": \"GRANT UI: HALL FINE\",\n \"billPaymentProductId\": \"10713664913\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": []\n }\n },\n {\n \"billPaymentProductName\": \"GRANT UI: STUDENT UNION FEE\",\n \"billPaymentProductId\": \"10713664933\",\n \"isAmountFixed\": false,\n \"amount\": 0,\n \"currency\": \"NGN\",\n \"metadata\": {\n \"customFields\": [\n {\n \"display_name\": \"Department\",\n \"variable_name\": \"department\",\n \"validation\": false,\n \"type\": \"alphabetic\",\n \"required\": true,\n \"sortOrder\": \"1\",\n \"variableId\": 10713665415,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n },\n {\n \"display_name\": \"matric no.\",\n \"variable_name\": \"matric_no.\",\n \"validation\": false,\n \"type\": \"alphanumeric\",\n \"required\": true,\n \"sortOrder\": \"2\",\n \"variableId\": 10713665416,\n \"singleSelect\": \"N\",\n \"customFieldDropDown\": []\n }\n ]\n }\n }\n ]\n }\n}"}],"_postman_id":"cc5a3728-16dc-486b-b1ee-0e2e86d59ba4"},{"name":"Customer Validation","id":"113e7efb-d158-407e-8524-bc4af26485cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"billPaymentProductId\": \"1509375337244\",\n \"customerId\": \"1111111111\"\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/biller/validate-customer","description":"

Validate Customer

This endpoint is required to be used only when a custom field on a Product requires validation See the sample response on the 'Get Biller Products' API.

Where relevant, the values returned in the response of this API (where the value is not NULL) should be returned in the relevant field in the 'Initiate Transaction' API.

Request Body

billPaymentProductId (String): The Product ID of the product that requires validation.
\n
customerId (String): The value of the validation item in question, e.g., meter number, account number, etc.
\n

Response

status (String): The status of the response.
\n
message (String): A message related to the response.
\n
data (Object):
\n
- customerId (String): The customer ID.
  \n
- billPaymentProductId (String): The Product ID of the product.
  \n
- name (String): Name of the customer associated with the Customer ID.
  \n
- email (String): Email of the customer associated with the Customer ID.
  \n
- address (String): Address of the customer associated with the Customer ID.
  \n
- amount (Numeric): Bill amount (if applicable).
  \n
- maximumAmount (Numeric): Maximum allowable amount for this bill. This will be null if not applicable.
  \n
- minimumAmount (Numeric): Minimum allowable amount for this bill. This will be null if not applicable.
  \n
- valueList (Array): List of values.
  \n
\n

Sample Products and Customer IDs for Validation

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Product Name	Product ID	Customer No
AEDC Prepaid	9676615755	12345678
AEDC Postpaid	201907091130	12345678
IBEDC Prepaid	4111452350	1111111111111
IBEDC Postpaid	9871959918	1010101010101
IKEJA Prepaid	4111432182	1111111111111
IKEJA Postpaid	4111442585	1010101010101
EKEDC Prepaid	9871959933	12345678910
EKEDC Postpaid	9871959937	12345678910
EEDC Prepaid	9871959895	12345678910
EEDC Postpaid	9871959900	12345678910
KADUNA Prepaid	202012122018	12345678910
KADUNA Postpaid	9697339303	12345678910
KANO Prepaid	5134403986	12345678910
KANO Postpaid	2926158761	12345678910
BEDC Prepaid	4230032376	12345678
BEDC Postpaid	8306102805	12345678

","urlObject":{"path":["api","v1","biller","validate-customer"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"83e7b483-c74d-4be9-b0ae-a70b98a5c806","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\n \"billPaymentProductId\": \"4111452350\",\n \"customerId\": \"123456789\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/validate-customer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sat, 26 Oct 2024 21:59:59 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"_meta\": null,\n \"_links\": null,\n \"code\": null,\n \"data\": {\n \"customerId\": \"123456789\",\n \"billPaymentProductId\": \"4111452350\",\n \"name\": \"Adene Jonah\",\n \"email\": null,\n \"address\": \"Mr. John Doe 34 Tokai, Abuja. 7999.\",\n \"amount\": null,\n \"maximumAmount\": null,\n \"minimumAmount\": 500,\n \"valueList\": []\n }\n}"}],"_postman_id":"113e7efb-d158-407e-8524-bc4af26485cc"},{"name":"Initiate Transaction","event":[{"listen":"prerequest","script":{"id":"4d18d691-ec71-4b9a-a132-83beec5ef6cc","exec":["pm.collectionVariables.set(\"productId\",\"10713664850\");"],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"19ff74b3-d9b2-4e04-ac39-a179c65a6075","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"rrr\", getResponseValue.data.rrr);","pm.collectionVariables.set(\"transactionRef\", getResponseValue.data.paymentIdentifier);","pm.collectionVariables.set(\"amount\", getResponseValue.data.amount);"],"type":"text/javascript","packages":{}}}],"id":"59fd7554-cb5b-4450-9af0-569d4eaf2c79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"billPaymentProductId\": \"16748204\",\r\n \"amount\": 2000,\r\n \"name\": \"John Doe\",\r\n \"paymentIdentifier\": \"1778509633\",\r\n \"email\": \"john.doe@mailinator.com\",\r\n \"phoneNumber\": \"08028892288\",\r\n \"customerId\": \"john.doe@mailinator.com\",\r\n \"metadata\": {\r\n \"customFields\": [\r\n {\r\n \"variable_name\": \"name\",\r\n \"value\": \"Tunde Smith\"\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/initiate","description":"

POST /api/v1/biller/initiate

This API endpoint is used to generate a bill and initiate a bill payment.

Request Body

billPaymentProductId (String): The ID of the product for bill payment.
\n
amount (Numeric): Bill amount to be paid.
\n
name (Boolean): Name of the payer.
\n
transactionRef (String): Unique transaction reference for the bill payment.
\n
email (String): Email of the payer.
\n
phoneNumber (String): Phone number of the payer.
\n
customerId (String): Identifier for the customer.
\n
metadata (Object): Additional metadata including custom fields.
\n

The amount in the response is the total amount including any additional charges. The paymentIdentifier and rrr are the payment reference identifiers.

\n","urlObject":{"path":["api","v1","biller","initiate"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"2d1d24bc-6d31-40fd-9f68-a72ff944e329","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"billPaymentProductId\": \"10713664850\",\r\n \"amount\": 2000,\r\n \"name\": \"John Doe\",\r\n \"paymentIdentifier\": \"1778509633\",\r\n \"email\": \"john.doe@mailinator.com\",\r\n \"phoneNumber\": \"08028892288\",\r\n \"customerId\": \"john.doe@mailinator.com\",\r\n \"metadata\": {\r\n \"customFields\": [\r\n {\r\n \"variable_name\": \"added_ammenities\",\r\n \"value\": \"10713679674\"\r\n },\r\n {\r\n \"variable_name\": \"matriculation_number\",\r\n \"value\": 312345543\r\n },\r\n {\r\n \"variable_name\": \"matriculation_number\",\r\n \"value\": 312345543\r\n }\r\n ]\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:59:09 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"amount\": 2000,\n \"paymentIdentifier\": \"1749232750\",\n \"rrr\": \"210799068434\"\n }\n}"}],"_postman_id":"59fd7554-cb5b-4450-9af0-569d4eaf2c79"}],"id":"35d3b645-feb0-4868-9b8a-65fbf8be0668","description":"

Prior to processing a payment on Remita, you will have to generate a Remita Retrieval Reference (RRR)- which represents a unique identification for the bill to be processed.

This section provides you with all you need to generate an RRR

\n","_postman_id":"35d3b645-feb0-4868-9b8a-65fbf8be0668"},{"name":"Process Bill","item":[{"name":"Lookup RRR","event":[{"listen":"prerequest","script":{"id":"4d18d691-ec71-4b9a-a132-83beec5ef6cc","exec":["function randomIntFromInterval(min, max) { "," return Math.floor(Math.random() * (max - min + 1) + min);","}","","// Generate a random amount rounded to the nearest 1000","let randomNum = Math.round(Math.random() * 100000 / 1000) * 1000;","","// Define 10 customers with dummy details","let customers = ["," { firstName: \"John\", lastName: \"Doe\", email: \"john.doe@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Jane\", lastName: \"Smith\", email: \"jane.smith@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Alice\", lastName: \"Johnson\", email: \"alice.johnson@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Bob\", lastName: \"Williams\", email: \"bob.williams@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Charlie\", lastName: \"Brown\", email: \"charlie.brown@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Daisy\", lastName: \"Miller\", email: \"daisy.miller@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Eve\", lastName: \"Davis\", email: \"eve.davis@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Frank\", lastName: \"Garcia\", email: \"frank.garcia@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Grace\", lastName: \"Martinez\", email: \"grace.martinez@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) },"," { firstName: \"Hank\", lastName: \"Lopez\", email: \"hank.lopez@mailinator.com\", phoneNumber: \"080\" + randomIntFromInterval(10000000, 99999999) }","];","","// Select a random customer from the array","let randomCustomer = customers[randomIntFromInterval(0, customers.length - 1)];","","// Derive additional properties for the selected customer","let userName = randomCustomer.firstName + \"_\" + randomCustomer.lastName;","let customerName = randomCustomer.firstName + \" \" + randomCustomer.lastName;","","// Define a set of products with variable details","let products = ["," {"," productId: \"10713664933\","," customerId: randomCustomer.email,"," variable_name1: \"department\","," variable_value1: \"Research\","," variable_name2: \"matric_no.\","," variable_value2: \"3432472897\""," },"," {"," productId: \"10713665051\","," customerId: randomCustomer.email,"," variable_name1: \"graduation_month\","," variable_value1: \"June\","," variable_name2: \"student_number\","," variable_value2: \"UI2789732\""," },"," {"," productId: \"4111452350\","," customerId: \"123456789\","," variable_name1: \"account_number\","," variable_value1: \"123456789\","," variable_name2: \"minimum_vend_amount\","," variable_value2: \"500\""," }","];","","// Select a random product from the array","let randomProduct = products[randomIntFromInterval(0, products.length - 1)];","","// Set the selected customer's details in the environment","pm.environment.set(\"firstName\", randomCustomer.firstName);","pm.environment.set(\"lastName\", randomCustomer.lastName);","pm.environment.set(\"customerName\", customerName);","pm.environment.set(\"email\", randomCustomer.email);","pm.environment.set(\"phoneNumber\", randomCustomer.phoneNumber);","pm.environment.set(\"amount\", randomNum);","","// Set the selected product's details in the environment","pm.environment.set(\"productId\", randomProduct.productId);","pm.environment.set(\"customerId\", randomProduct.customerId);","pm.environment.set(\"variable_name1\", randomProduct.variable_name1);","pm.environment.set(\"variable_value1\", randomProduct.variable_value1);","if (randomProduct.variable_name2) {"," pm.environment.set(\"variable_name2\", randomProduct.variable_name2);"," pm.environment.set(\"variable_value2\", randomProduct.variable_value2);","}"],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"19ff74b3-d9b2-4e04-ac39-a179c65a6075","exec":["var getResponseValue = pm.response.json();","","pm.environment.set(\"rrr\", getResponseValue.data.rrr);","pm.environment.set(\"transactionRef\", getResponseValue.data.paymentIdentifier);","pm.environment.set(\"amount\", getResponseValue.data.amount);"],"type":"text/javascript","packages":{}}}],"id":"ecfd361e-0f7f-4fa1-b58c-d1a90e572b0a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/200799091919","description":"

The API endpoint allows you to look up an already generated Remita Retrieval Reference (RRR). The RRR is the bill reference from Remita.

\n","urlObject":{"path":["api","v1","biller","lookup","200799091919"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"123829fe-f1f1-40ea-8556-5cd0df0e19ac","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/200799091919"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:59:51 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"billerId\": \"S0000573002\",\n \"billerName\": \"UNIVERSITY OF IBADAN\",\n \"productName\": \"ACCOMMODATION UNDERGRADUATE\",\n \"categoryId\": \"6\",\n \"categoryName\": \"Educational Institutions\",\n \"name\": \"John Doe\",\n \"phoneNumber\": \"08028892288\",\n \"email\": \"john.doe@mailinator.com\",\n \"paymentIdentifier\": \"799068434\",\n \"amount\": 2000,\n \"fee\": 0,\n \"rrrAmount\": 2000,\n \"rrr\": \"210799068434\",\n \"currency\": \"NGN\",\n \"description\": \" - ACCOMMODATION UNDERGRADUATE\",\n \"vtu\": false,\n \"rrrType\": \"PY\",\n \"commission\": 17,\n \"status\": \"pending\",\n \"processorId\": \"Remita\",\n \"metadata\": {\n \"transactionDate\": \"2025-06-06 00:00:00\",\n \"paymentDate\": null,\n \"channel\": null,\n \"receiptUrl\": \"https://receipt-qa.systemspecsng.com/rrr/view/447A69627157456A424576556854544379587A565335496D623244764E505A78365A71616C673D3D\",\n \"extraData\": null,\n \"vendingData\": null,\n \"customFields\": [\n {\n \"variable_name\": \"Matriculation Number\",\n \"value\": \"312345543\"\n },\n {\n \"variable_name\": \"Matriculation Number\",\n \"value\": \"312345543\"\n },\n {\n \"variable_name\": \"ADDED AMMENITIES\",\n \"value\": \"En Suite Bathroom\"\n }\n ],\n \"standingOrder\": null\n }\n }\n}"}],"_postman_id":"ecfd361e-0f7f-4fa1-b58c-d1a90e572b0a"},{"name":"Process Transaction","event":[{"listen":"prerequest","script":{"id":"4d18d691-ec71-4b9a-a132-83beec5ef6cc","exec":[""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"19ff74b3-d9b2-4e04-ac39-a179c65a6075","exec":["var getResponseValue = pm.response.json();","","pm.environment.set(\"rrr\", getResponseValue.data.rrr);","pm.environment.set(\"transactionRef\", getResponseValue.data.paymentIdentifier);","pm.environment.set(\"amount\", getResponseValue.data.amount);"],"type":"text/javascript","packages":{}}}],"id":"89b84459-d8c8-4a11-aa73-c8f8d3390b1b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"rrr\": \"200799091919\",\r\n \"paymentIdentifier\": \"{{transactionRef}}\",\r\n \"amount\": 10000\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/process","description":"

POST /api/v1/biller/process

This API endpoint is used to send a request to process a bill. Prior to sending this request, it is expected that debit from the payer has been secured.

Request Body

rrr (String): The Remita Retrieval Reference (RRR) associated with the bill
\n
paymentIdentifier (String): Identifier for the payment
\n
amount (Number): Amount to be processed
\n

\n","urlObject":{"path":["api","v1","biller","process"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"61aa7b31-71b6-4aff-b6f7-74ce27bd51c1","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":""}],"body":{"mode":"raw","raw":"{\r\n \"rrr\": \"200799091919\",\r\n \"paymentIdentifier\": \"{{transactionRef}}\",\r\n \"amount\": 10000\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/process"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 18:00:43 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"amount\": 2000,\n \"paymentIdentifier\": \"1749232750\",\n \"rrr\": \"210799068434\",\n \"transactionStatus\": \"PROCESSING\"\n }\n}"}],"_postman_id":"89b84459-d8c8-4a11-aa73-c8f8d3390b1b"},{"name":"Query Transaction","event":[{"listen":"prerequest","script":{"id":"4d18d691-ec71-4b9a-a132-83beec5ef6cc","exec":[""],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"19ff74b3-d9b2-4e04-ac39-a179c65a6075","exec":[""],"type":"text/javascript","packages":{}}}],"id":"394bd41d-d4a9-4955-9b7e-a733b5fc2cbd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/200799091919","description":"

This API can be used to get the updated information on an RRR. This could include an updated payment status, the RRR receipt or/and any post payment information.

\n","urlObject":{"path":["api","v1","biller","lookup","200799091919"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"fe746bfe-0d49-4bba-b10f-6e3694a450a9","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":""}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/200799091919"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 18:01:24 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"meta\": null,\n \"links\": null,\n \"code\": null,\n \"data\": {\n \"billerId\": \"S0000573002\",\n \"billerName\": \"UNIVERSITY OF IBADAN\",\n \"productName\": \"ACCOMMODATION UNDERGRADUATE\",\n \"categoryId\": \"6\",\n \"categoryName\": \"Educational Institutions\",\n \"name\": \"John Doe\",\n \"phoneNumber\": \"08028892288\",\n \"email\": \"john.doe@mailinator.com\",\n \"paymentIdentifier\": \"799068434\",\n \"amount\": 2000,\n \"fee\": 0,\n \"rrrAmount\": 2000,\n \"rrr\": \"210799068434\",\n \"currency\": \"NGN\",\n \"description\": \" - ACCOMMODATION UNDERGRADUATE\",\n \"vtu\": false,\n \"rrrType\": \"PY\",\n \"commission\": 17,\n \"status\": \"PROCESSING\",\n \"processorId\": \"Remita\",\n \"metadata\": {\n \"transactionDate\": \"2025-06-06 00:00:00\",\n \"paymentDate\": null,\n \"channel\": null,\n \"receiptUrl\": \"https://receipt-qa.systemspecsng.com/rrr/view/447A69627157456A424576556854544379587A565335496D623244764E505A78365A71616C673D3D\",\n \"extraData\": null,\n \"vendingData\": null,\n \"customFields\": [\n {\n \"variable_name\": \"Matriculation Number\",\n \"value\": \"312345543\"\n },\n {\n \"variable_name\": \"Matriculation Number\",\n \"value\": \"312345543\"\n },\n {\n \"variable_name\": \"ADDED AMMENITIES\",\n \"value\": \"En Suite Bathroom\"\n }\n ],\n \"standingOrder\": null\n }\n }\n}"}],"_postman_id":"394bd41d-d4a9-4955-9b7e-a733b5fc2cbd"}],"id":"bffd4356-c98f-466a-a9b0-2647d166fd88","description":"

The API endpoint allows you to look up an already generated Remita Retrieval Reference (RRR). The RRR is the bill reference from Remita.

\n","_postman_id":"bffd4356-c98f-466a-a9b0-2647d166fd88"},{"name":"Mandate Activation","item":[{"name":"Get Mandate Details","event":[{"listen":"test","script":{"id":"ec537874-2422-4fd1-a39b-254341b78463","exec":["const remita_fpssp_util = pm.require('@test-run-rpsl/remita_fpssp_util');","","let resBody = remita_fpssp_util.getResponse();","","if (resBody) {"," var apiResponse = resBody;"," pm.environment.set(\"rrr\", apiResponse.data.rrr);",""," // Test if statuscode is 00"," pm.test(\"Status is 00\", function () {"," pm.expect(apiResponse.status).to.eql(\"00\");"," });",""," // Validate the response structure"," pm.test(\"Validate response structure\", function () {"," // List of expected keys"," const expectedKeys = [\"billerId\",\"billerName\",\"productName\",\"categoryName\",\"name\",\"phoneNumber\", \"email\", \"amount\", \"transactionRef\", \"fee\", \"rrr\", \"rrrAmount\", \"metadata\"];",""," // Validate the response structure"," const keysPresent = expectedKeys.every(key => apiResponse.data.hasOwnProperty(key));"," pm.expect(keysPresent).to.be.true;",""," });"," pm.test(\"Response time is less than 2 seconds\", function () {"," pm.expect(pm.response.responseTime).to.be.below(2000);"," });"," pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);"," });","} else {"," pm.expect.fail(\"Response parsing failed\");","}"],"type":"text/javascript","packages":{}}}],"id":"79d6108d-390b-4733-bd24-f874ab1c332c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/180799091923","description":"

Description

Retrieves the details of a specific Remita mandate using the mandate reference. This allows the financial institution to display the mandate information to the customer for review and verification before activation.

Request:

The bank needs to make a GET request using the mandate ID as the parameter and Remita will send a response back with the Mandate details

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Item	Description
`billerId`	Shows the Remita biller ID of the Biller or Merchant who the RRR is generated in their favour
`billerName`	Shows the Name of the Biller or Merchant who the RRR is generated in their favour
`productName`	The name of the service or product the customer has subscribed to
`categoryId`	The category ID of the Biller or Merchant on Remita
`categoryName`	The name of the biller category on Remita the Merchant falls under
`name`	The name of the payer or customer
`phoneNumber`	The phone number of the payer or customer
`email`	The email of the payer or customer
`amount`	The total transaction amount ie the Principal plus Remita Fees
`fee`	Remita processsing fee
`rrrAmount`	The net transaction amount after Remita fee has been deducted
`rrr`	The Remita Retrieval Reference number
`rrrType`	The type of mandate (Direct Debit or Sanding Order) usually returned as `DD` or `SO`
`status`	The status of the transaction
`frequency`	The sequence of payment, either daily, weekly or monthly.
`payerAccountNumber`	The NUBAN bank account of the customer or payer
`maxNoOfDebits`	The maximum number of times that Remita is authorized to trigger debit on the account within the mandate duration
`startDate`	The start date of the mandate
`endDate`	The end date of the mandate

","urlObject":{"path":["api","v1","biller","lookup","180799091923"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"d8c32263-7d61-4963-afdc-8b440bc38dd6","name":"Variable Amount Mandate","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJtdGwtZGZuc0NyUjROZjctdjBiUWpGa0tGQVlvOEpWQklhOW5mNW13RjlZIn0.eyJleHAiOjE3NTEyODUyMzMsImlhdCI6MTc1MTI4MTYzMywianRpIjoiNzYyZjdjOGQtZmE1YS00Y2QxLWFlOWQtZmFjOGIxNmU5NDBkIiwiaXNzIjoiaHR0cDovLzE5Mi4xNjguMTAuODI6OTE4MC9rZXljbG9hay9yZW1pdGEvZXhhcHAvYXBpL3YxL3JlZGdhdGUvYXV0aC9yZWFsbXMvcmVtaXRhIiwiYXVkIjpbImRpc2NvdmVyeS1zZXJ2ZXIiLCJhY2NvdW50Il0sInN1YiI6IjgwM2RjNDJlLTc2MjMtNDNhMi1iYTRkLWM3ODI2MjVhMmQ2MCIsInR5cCI6IkJlYXJlciIsImF6cCI6InJlbWl0YXVhYS1zZXJ2aWNlIiwic2Vzc2lvbl9zdGF0ZSI6IjBjMDQzNTQ4LTE2M2EtNDkyOC05NmNkLTgzMzM1NGI4ZGQ0ZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cHM6Ly9sb2dpbi5yZW1pdGEubmV0Il0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiZGlzY292ZXJ5LXNlcnZlciI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsInZpZXctcHJvZmlsZSJdfSwiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiZW1haWxfdmVyaWZpZWQiOnRydWUsIm5hbWUiOiJVU0VSMDIwIFVTRVIwMjAiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIybGVwbnI2cnpxYWQwajdnIiwiZ2l2ZW5fbmFtZSI6IlVTRVIwMjAiLCJmYW1pbHlfbmFtZSI6IlVTRVIwMjAiLCJvcmdhbmlzYXRpb24taWQiOiJDV0dERU1PIiwiZW1haWwiOiJ1c2VyMDIwIn0.Ql2Yjh5BZETaoHevgRF-U6Ui8M86tW2MiR5-BIiRrXqueYyHGtfCJgFlrwIjpYrTNzKnqy1QwpzXs3VX1DoVWwUWYO-u3MjydZbYHJZoywKvQakcgdUIHhFELk31BCQM8cABw_KS4LjGNaXHdnMEBHKUBDUmQ-DQR9XGTLwVk3sccm5cgV22X2hjA1BKVzF17rLv0nmPBrqEmjvrUR58OfYqSLTULII18ATyYrGLI4NuaHVS3FzWFJR9Fn7YWTdOyLyJKMHC6libt40Ljl6lOO-lgjIlff_xfDe262kUpx-RY-T2WpVgLWVyl5RMYwUPIJ3JnSj9g6Jq7dr8GVdYjw"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/lookup/180799091923"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 23 Jun 2025 13:28:17 GMT"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"954453df2c8ce3d0-LIS"},{"key":"Content-Encoding","value":"gzip"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"lookup transaction fetch successful\",\n \"data\": {\n \"billerId\": null,\n \"billerName\": null,\n \"productName\": null,\n \"categoryId\": null,\n \"categoryName\": null,\n \"name\": \"John Doe\",\n \"phoneNumber\": \"08022023123\",\n \"email\": \"john.doe@mailinator.com\",\n \"transactionRef\": null,\n \"amount\": 1000,\n \"fee\": 16.13,\n \"rrrAmount\": 983.87,\n \"rrr\": \"350799082014\",\n \"currency\": \"NGN\",\n \"description\": \"CWG DEMO - REGULAR PAYMENT\",\n \"productId\": null,\n \"vtu\": false,\n \"rrrType\": \"SO\",\n \"commission\": 0,\n \"status\": \"pending\",\n \"metadata\": {\n \"transactionDate\": null,\n \"paymentDate\": null,\n \"channel\": null,\n \"receiptUrl\": null,\n \"extraData\": null,\n \"vendingData\": null,\n \"customFields\": [],\n \"standingOrder\": {\n \"frequency\": \"\",\n \"payerAccountNumber\": \"0100034932\",\n \"maxNoOfDebits\": 6,\n \"startDate\": \"23/06/2025\",\n \"endDate\": \"23/12/2025\"\n }\n }\n }\n}"},{"id":"8791ff10-bd64-48b9-beb0-195a9027bd08","name":"Fixed Amount Mandate","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJtdGwtZGZuc0NyUjROZjctdjBiUWpGa0tGQVlvOEpWQklhOW5mNW13RjlZIn0.eyJleHAiOjE3NTEyODUyMzMsImlhdCI6MTc1MTI4MTYzMywianRpIjoiNzYyZjdjOGQtZmE1YS00Y2QxLWFlOWQtZmFjOGIxNmU5NDBkIiwiaXNzIjoiaHR0cDovLzE5Mi4xNjguMTAuODI6OTE4MC9rZXljbG9hay9yZW1pdGEvZXhhcHAvYXBpL3YxL3JlZGdhdGUvYXV0aC9yZWFsbXMvcmVtaXRhIiwiYXVkIjpbImRpc2NvdmVyeS1zZXJ2ZXIiLCJhY2NvdW50Il0sInN1YiI6IjgwM2RjNDJlLTc2MjMtNDNhMi1iYTRkLWM3ODI2MjVhMmQ2MCIsInR5cCI6IkJlYXJlciIsImF6cCI6InJlbWl0YXVhYS1zZXJ2aWNlIiwic2Vzc2lvbl9zdGF0ZSI6IjBjMDQzNTQ4LTE2M2EtNDkyOC05NmNkLTgzMzM1NGI4ZGQ0ZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cHM6Ly9sb2dpbi5yZW1pdGEubmV0Il0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiZGlzY292ZXJ5LXNlcnZlciI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsInZpZXctcHJvZmlsZSJdfSwiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiZW1haWxfdmVyaWZpZWQiOnRydWUsIm5hbWUiOiJVU0VSMDIwIFVTRVIwMjAiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIybGVwbnI2cnpxYWQwajdnIiwiZ2l2ZW5fbmFtZSI6IlVTRVIwMjAiLCJmYW1pbHlfbmFtZSI6IlVTRVIwMjAiLCJvcmdhbmlzYXRpb24taWQiOiJDV0dERU1PIiwiZW1haWwiOiJ1c2VyMDIwIn0.Ql2Yjh5BZETaoHevgRF-U6Ui8M86tW2MiR5-BIiRrXqueYyHGtfCJgFlrwIjpYrTNzKnqy1QwpzXs3VX1DoVWwUWYO-u3MjydZbYHJZoywKvQakcgdUIHhFELk31BCQM8cABw_KS4LjGNaXHdnMEBHKUBDUmQ-DQR9XGTLwVk3sccm5cgV22X2hjA1BKVzF17rLv0nmPBrqEmjvrUR58OfYqSLTULII18ATyYrGLI4NuaHVS3FzWFJR9Fn7YWTdOyLyJKMHC6libt40Ljl6lOO-lgjIlff_xfDe262kUpx-RY-T2WpVgLWVyl5RMYwUPIJ3JnSj9g6Jq7dr8GVdYjw"}],"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/bgatesvc/v3/billpayment/biller/transaction/lookup/180799091923"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Mon, 23 Jun 2025 13:29:05 GMT"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"954455064c6fe3d0-LIS"},{"key":"Content-Encoding","value":"gzip"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"lookup transaction fetch successful\",\n \"data\": {\n \"billerId\": null,\n \"billerName\": null,\n \"productName\": null,\n \"categoryId\": null,\n \"categoryName\": null,\n \"name\": \"John Doe\",\n \"phoneNumber\": \"08022023123\",\n \"email\": \"john.doe@mailinator.com\",\n \"transactionRef\": null,\n \"amount\": 1000,\n \"fee\": 16.13,\n \"rrrAmount\": 983.87,\n \"rrr\": \"280799082020\",\n \"currency\": \"NGN\",\n \"description\": \"CWG DEMO - REGULAR PAYMENT\",\n \"productId\": null,\n \"vtu\": false,\n \"rrrType\": \"SO\",\n \"commission\": 0,\n \"status\": \"pending\",\n \"metadata\": {\n \"transactionDate\": null,\n \"paymentDate\": null,\n \"channel\": null,\n \"receiptUrl\": null,\n \"extraData\": null,\n \"vendingData\": null,\n \"customFields\": [],\n \"standingOrder\": {\n \"frequency\": \"Month\",\n \"payerAccountNumber\": \"0100034932\",\n \"maxNoOfDebits\": null,\n \"startDate\": \"23/06/2025\",\n \"endDate\": \"23/12/2025\"\n }\n }\n }\n}"}],"_postman_id":"79d6108d-390b-4733-bd24-f874ab1c332c"},{"name":"Activate Mandate","event":[{"listen":"test","script":{"id":"379776b8-46f5-4e7c-a5ff-7a5f8f08d374","exec":["const remita_fpssp_util = pm.require('@test-run-rpsl/remita_fpssp_util');","let resBody = remita_fpssp_util.getResponse();","","if (resBody) {"," var apiResponse = resBody;","",""," // Test if statuscode is 00"," pm.test(\"Status is 00\", function () {"," pm.expect(apiResponse.status).to.eql(\"00\");"," });",""," // Validate the response structure"," pm.test(\"Validate response structure\", function () {"," // List of expected keys"," const expectedKeys = [\"transactionRef\", \"rrr\"];",""," // Validate the response structure"," const keysPresent = expectedKeys.every(key => apiResponse.data.hasOwnProperty(key));"," pm.expect(keysPresent).to.be.true;"," });"," pm.test(\"Response time is less than 2 seconds\", function () {"," pm.expect(pm.response.responseTime).to.be.below(2000);"," });"," pm.test(\"Status code is 200\", function () {"," pm.response.to.have.status(200);"," });","} else {"," pm.expect.fail(\"Response parsing failed\");","}","",""],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"packages":{},"type":"text/javascript"}}],"id":"f1a30d86-ecd1-4971-89cd-2a87034191d1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rrr\": \"180799091923\",\r\n \"transactionRef\": \"1778509633\",\r\n \"amount\": 10000,\r\n \"metadata\": {\r\n \"payerAccountNumber\": \"0100034932\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/biller/process","description":"

Activates a verified Remita mandate on behalf of the customer after all required validations and checks have been successfully completed by the financial institution.

Request Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
rrr	String	`Required` Mandate Reference. The Reference of a direct debit/standing order mandate
transactionRef	String	`Required` Reference used to identify the attempt to activate a mandate.
amount	Numeric	`Required` Madnate amount to be activated.
payerAccountNumber	String	`Required` The relevant Account Number of the payer on which the mandate is to be activated on. This must be the same account retrieved from the lookup Mandate API

Response Body Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Type	Description
status	String	Response Code from Server
message	String	Response message from the server
transactionRef	object	Reference mapped to the call to process transaction
rrr	String	Mandate Reference. The Reference of a direct debit/standing order mandate.

","urlObject":{"path":["api","v1","biller","process"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"be5b2550-09ae-494f-a23e-a6e1dd5be5b5","name":"BillPaymentNotificatiion","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer {{token}}"}],"body":{"mode":"raw","raw":"{\r\n \"rrr\": \"200799091919\",\r\n \"transactionRef\": \"1778509633\",\r\n \"amount\": 10000,\r\n \"channel\": \"internetbanking\",\r\n \"metadata\": {\r\n \"fundingSource\": \"HERITAGE\",\r\n \"payerAccountNumber\": \"2035468030\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/bgatesvc/v3/billpayment/biller/transaction/paymentnotification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Wed, 10 Apr 2019 15:57:18 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Mandate Activated successfully\",\n \"data\": {\n \"transactionRef\": \"1674746616\",\n \"rrr\": \"160010116275\"\n }\n}"}],"_postman_id":"f1a30d86-ecd1-4971-89cd-2a87034191d1"}],"id":"87921dbb-8c7b-493b-9240-46d766c416e0","description":"

This section is intended for Banks and other Financial Institutions that need to activate a Remita mandate initiated by their customer. Using this API, the institution can look up the details of a mandate, present it to the customer for verification, and submit a request to activate the mandate once all necessary checks have been successfully completed.

\n","_postman_id":"87921dbb-8c7b-493b-9240-46d766c416e0"}],"id":"3c2ff373-b225-408d-943d-70a7fa68208d","_postman_id":"3c2ff373-b225-408d-943d-70a7fa68208d","description":""},{"name":"Response Codes","item":[],"id":"0322e722-3e18-4c46-8c9f-0d4a8d1ddc09","description":"

Important Note:

Where the state of the transaction is Failed, funds can be returned to the customer
\n
Where the state of the transaction is Pending, you should utilize the query transaction status to check for the updated status of the transaction.
\n

Response Code	Description	State of Transaction
00	Approved or completed successfully	Successful
44	Transaction is still pending	Not Initiated
03	Transaction Pending	Pending
09	(Not provided explicitly, treated as Pending)	Pending
62	Transaction pending	Pending
99	Failed processing request!	Pending
01	Transaction Failed	Failed
02	BAD REQUEST / Bad request	Failed
04	Authentication Error / Failed to Authenticate	Failed
07	Transaction limit exceeded	Failed
08	Incorrect payment reference	Failed
10	Insufficient amount	Failed
11	Record not found	Failed
12	Invalid transaction reference	Failed
17	User verification required	Failed
23	Transaction already processed / RRR already processed on Remita	Failed
24	Invalid Request. Missing headers or parameters	Failed
26	Duplicate record / Unknown merchant / Amount exceeded	Failed
28	Unknown bank account	Failed
31	Invalid credit account / Invalid phone number	Failed
32	Missing request parameters	Failed
34	Api authorization error	Failed
42	UNAUTHORIZED API ACCESS	Failed
50	INSUFFICIENT WALLET BALANCE	Failed
51	Insufficient funds / WALLET NOT CONFIGURED FOR MERCHANT	Failed
52	WALLET LIMIT EXCEEDED	Failed
58	IP NOT PERMITTED	Failed
61	Transaction limit Exceeded / Api Hashing	Failed
63	Transaction confirmed	Failed
64	Transaction completed	Failed
96	System malfunction	Failed
104	Customer Validation Failed for Meter Number	Failed
4000	Account number/Phone number not found	Failed
4001	Phone number/Account number is invalid	Failed
4004	Invalid URL	Failed
4006	Phone number/Account number is required	Failed
4007	Unique Identifier must be numeric	Failed

","_postman_id":"0322e722-3e18-4c46-8c9f-0d4a8d1ddc09"}],"id":"cfcd305b-6317-4f14-aee4-2a967cc750a6","description":"

Target Audience: Aggregators, Financial Institutions

Authentication: Click HERE

About these APIs

These APIs enable you collect payments on behalf of other billers through your platform. This provides you with the capability to offer your customers access to make payments to a vast array of billers and merchants, including schools, churches, service providers and the Federal Government ministries, departments and agencies (MDAs) available on Remita to purchase and subscribe to their various products and services.

The Process

The process involves your customers selecting a Remita biller to pay via your platform.

There are two ways you could utilize these APIs. You can either generate a Remita bill reference (or a Remita Retrieval Reference [RRR]) and process payment, or you could just lookup a Remita bill reference and process payment of RRRs.

To utilize the full Biller API, you can start from the top where you will be able to call all of our Billers and make payment for each of them
\n
If you are interested in just processing a Remita Retrieval Invoice (RRR) you can commence from here
\n

Note:

Prior to Go-Live, you will conduct a UAT to confirm your readiness. Kindly contact us at solutionsdelivery@systemspecs.com.ng for this

\n","_postman_id":"cfcd305b-6317-4f14-aee4-2a967cc750a6"},{"name":"Vending Bills","item":[{"name":"APIs","item":[{"name":"Get Category","event":[{"listen":"test","script":{"id":"787f7d85-a463-4e99-9063-466060c3e5ec","exec":["","","//console.log()"],"type":"text/javascript","packages":{}}}],"id":"59014799-54ab-4037-acc4-83743c5d267a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/categories?page=0&size=20","description":"

The endpoint makes an HTTP GET request to retrieve utility categories with pagination support.

\n","urlObject":{"path":["api","v1","vending","categories"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[{"key":"page","value":"0"},{"key":"size","value":"20"}],"variable":[]}},"response":[{"id":"b7ca2150-25b7-4d38-8b1b-b35867f4f7bc","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":{"raw":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/categories?page=0&size=20","host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"path":["api","v1","vending","categories"],"query":[{"key":"page","value":"0"},{"key":"size","value":"20"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 27 Oct 2024 00:24:05 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"totalPage\": 1,\n \"totalContent\": 6,\n \"items\": [\n {\n \"id\": 1,\n \"name\": \"electricity\",\n \"description\": \"electricity\",\n \"code\": \"electricity\"\n },\n {\n \"id\": 2,\n \"name\": \"Airtime\",\n \"description\": \"Airtime\",\n \"code\": \"airtime\"\n },\n {\n \"id\": 3,\n \"name\": \"Internet Data Subscription\",\n \"description\": \"Internet Data Subscription\",\n \"code\": \"internet_data_subscription\"\n },\n {\n \"id\": 4,\n \"name\": \"Cable TV\",\n \"description\": \"Cable TV\",\n \"code\": \"cable_tv\"\n },\n {\n \"id\": 5,\n \"name\": \"Educations\",\n \"description\": \"Educations\",\n \"code\": \"educations\"\n },\n {\n \"id\": 6,\n \"name\": \"Transportation\",\n \"description\": \"Transportation\",\n \"code\": \"transportation\"\n }\n ]\n }\n}"}],"_postman_id":"59014799-54ab-4037-acc4-83743c5d267a"},{"name":"Get Providers","event":[{"listen":"test","script":{"id":"24850af1-c872-4a9a-928b-9fcb3bfb789c","exec":["","","//console.log()"],"type":"text/javascript","packages":{}}}],"id":"f366009d-83d0-4990-bef5-69a64e928aa5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/providers","description":"

This API provides a list of Providers available

\n","urlObject":{"path":["api","v1","vending","providers"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"e8ee8368-69b7-4634-85c1-b2baac511ab9","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/providers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:14:45 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"totalPage\": 117,\n \"totalContent\": 1165,\n \"items\": [\n {\n \"code\": \"gotv\",\n \"name\": \"GoTV\",\n \"description\": \"GoTV\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952126/Biller%20API%20Images/GoTV_gy5pxy.png\"\n },\n {\n \"code\": \"cowry\",\n \"name\": \"Cowry\",\n \"description\": \"Cowry\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1724266069/Biller%20API%20Images/Cowry_gktfs2.png\"\n },\n {\n \"code\": \"waec\",\n \"name\": \"West African Examinations Council\",\n \"description\": \"West African Examinations Council\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735894565/Biller%20API%20Images/WAEC_cnbt7a.png\"\n },\n {\n \"code\": \"mtn_gh\",\n \"name\": \"MTN Ghana\",\n \"description\": \"MTN Ghana\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1725035129/Biller%20API%20Images/MTN_Ghana_o6kley.png\"\n },\n {\n \"code\": \"telcel_america_pin_usa\",\n \"name\": \"Telcel America PIN USA\",\n \"description\": \"Telcel America PIN USA\",\n \"logoUrl\": \"\"\n },\n {\n \"code\": \"lebara_uk\",\n \"name\": \"Lebara UK\",\n \"description\": \"Lebara UK\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1725035125/Biller%20API%20Images/Lebara_UK_ioxjmf.jpg\"\n },\n {\n \"code\": \"O2_uk\",\n \"name\": \"O2 UK\",\n \"description\": \"O2 UK\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735898168/Biller%20API%20Images/02_UK_ynsvbh.jpg\"\n },\n {\n \"code\": \"vodafone_uk\",\n \"name\": \"Vodafone UK\",\n \"description\": \"Vodafone UK\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1725035130/Biller%20API%20Images/Vodafone_Ghana_kxxppi.jpg\"\n },\n {\n \"code\": \"boost_mobile_usa\",\n \"name\": \"Boost Mobile USA\",\n \"description\": \"Boost Mobile USA\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735897877/Biller%20API%20Images/boost_mobile_jd6nz9.png\"\n },\n {\n \"code\": \"cricket_usa\",\n \"name\": \"Cricket USA\",\n \"description\": \"Cricket USA\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735897878/Biller%20API%20Images/Criket_USA_vnbgaf.png\"\n }\n ]\n }\n}"}],"_postman_id":"f366009d-83d0-4990-bef5-69a64e928aa5"},{"name":"Get Providers by Category","event":[{"listen":"test","script":{"id":"fcd9cc85-fe99-4a35-9b87-e091583a2f7d","exec":["","","//console.log()"],"type":"text/javascript","packages":{}}},{"listen":"prerequest","script":{"packages":{},"type":"text/javascript"}}],"id":"a2c7082c-b388-4b0c-9bec-6288d7d2cd35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/providers/category/{{categoryId}}","description":"

This API provides a list of Providers available by category

\n","urlObject":{"path":["api","v1","vending","providers","category","{{categoryId}}"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"84ff1e6d-6341-4838-b224-d531cd36d529","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/providers/category/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Fri, 06 Jun 2025 17:13:18 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": [\n {\n \"code\": \"ekedc\",\n \"name\": \"Eko Electricity Distribution Company\",\n \"description\": \"Eko Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Eko_Electric_1_g8siit.png\"\n },\n {\n \"code\": \"ikedc\",\n \"name\": \"Ikeja Electricity Distribution Company\",\n \"description\": \"Ikeja Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Ikeja_Electric_whxao0.png\"\n },\n {\n \"code\": \"ibedc\",\n \"name\": \"Ibadan Electricity Distribution Company\",\n \"description\": \"Ibadan Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952126/Biller%20API%20Images/Ibadan_Electric_ukkdyl.png\"\n },\n {\n \"code\": \"eedc\",\n \"name\": \"Enugu Electricity Distribution Company\",\n \"description\": \"Enugu Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Enugu_Electric_estzsa.png\"\n },\n {\n \"code\": \"phed\",\n \"name\": \"Port Harcourt Electricity Distribution Company\",\n \"description\": \"Port Harcourt Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Port_Harcourt_Electric_b8jurq.png\"\n },\n {\n \"code\": \"cie\",\n \"name\": \"CIE Power\",\n \"description\": \"CIE Power\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735898342/Biller%20API%20Images/CIE_power_jwz0j6.png\"\n },\n {\n \"code\": \"kaedc\",\n \"name\": \"Kaduna Electricity Distribution Company\",\n \"description\": \"Kaduna Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Kaduna_Electric_ldxrem.png\"\n },\n {\n \"code\": \"aedc\",\n \"name\": \"Abuja Electricity Distribution Company\",\n \"description\": \"Abuja Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952125/Biller%20API%20Images/Abuja_Electric_voosmh.png\"\n },\n {\n \"code\": \"kedco\",\n \"name\": \"Kano Electricity Distribution Company\",\n \"description\": \"Kano Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Kano_Electric_hthhc5.png\"\n },\n {\n \"code\": \"jedco\",\n \"name\": \"Kano Electricity Distribution Company\",\n \"description\": \"Kano Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1673952127/Biller%20API%20Images/Kano_Electric_hthhc5.png\"\n },\n {\n \"code\": \"spark_meter\",\n \"name\": \"Spark Meter\",\n \"description\": \"Spark Meter\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1735898409/Biller%20API%20Images/Spark_meter_m6nlmb.png\"\n },\n {\n \"code\": \"apl\",\n \"name\": \"APL Electric Company\",\n \"description\": \"APL Electric Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1718370331/Biller%20API%20Images/Aba_Power_Logo_kzgtf4.png\"\n },\n {\n \"code\": \"bedc\",\n \"name\": \"BEDC Electricity Plc\",\n \"description\": \"BEDC Electricity Plc\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1720197794/Biller%20API%20Images/Benin_iujhgu.png\"\n },\n {\n \"code\": \"yedc\",\n \"name\": \"Yola Electricity Distribution Company\",\n \"description\": \"Yola Electricity Distribution Company\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/image/upload/v1720197795/Biller%20API%20Images/Yola_jvubmn.jpg\"\n }\n ]\n}"}],"_postman_id":"a2c7082c-b388-4b0c-9bec-6288d7d2cd35"},{"name":"Get Products","id":"70f28b42-3523-47b5-bfd3-e2861d47ecf0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/products?page=0&pageSize=20&countryCode=NGA&categoryCode=electricity&provider=ekedc","description":"

Get Vending Products

This endpoint retrieves utility products based on the specified page, country code, category code and Providers

\n","urlObject":{"path":["api","v1","vending","products"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[{"key":"page","value":"0"},{"key":"pageSize","value":"20"},{"disabled":true,"key":"productType","value":"DYNAMIC"},{"key":"countryCode","value":"NGA"},{"key":"categoryCode","value":"electricity"},{"disabled":true,"key":"code","value":""},{"key":"provider","value":"ekedc"}],"variable":[]}},"response":[{"id":"a1562286-3f19-4766-a948-81889b25ed5a","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":{"raw":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/products?page=0&pageSize=20&countryCode=NGA&categoryCode=electricity&provider=ekedc","host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"path":["api","v1","vending","products"],"query":[{"key":"page","value":"0","type":"text"},{"key":"pageSize","value":"20","type":"text"},{"key":"productType","value":"DYNAMIC","type":"text","disabled":true},{"key":"countryCode","value":"NGA","type":"text"},{"key":"categoryCode","value":"electricity","type":"text"},{"key":"code","value":"","type":"text","disabled":true},{"key":"provider","value":"ekedc","type":"text"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 27 Oct 2024 00:24:58 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"totalPage\": 1,\n \"totalContent\": 3,\n \"items\": [\n {\n \"name\": \"Eko Electricity Order\",\n \"description\": \"Eko Electricity Order\",\n \"code\": \"100\",\n \"country\": \"Nigeria\",\n \"countryCode\": \"NGA\",\n \"currencyCode\": \"\",\n \"productType\": null,\n \"feeType\": \"DYNAMIC\",\n \"amount\": 0.0,\n \"provider\": \"ekedc\",\n \"categoryCode\": \"electricity\"\n },\n {\n \"name\": \"Eko PREPAID\",\n \"description\": \"Eko PREPAID\",\n \"code\": \"101\",\n \"country\": null,\n \"countryCode\": \"NGA\",\n \"currencyCode\": null,\n \"productType\": null,\n \"feeType\": \"DYNAMIC\",\n \"amount\": 0.0,\n \"provider\": \"ekedc\",\n \"categoryCode\": \"electricity\"\n },\n {\n \"name\": \"Eko POSTPAID\",\n \"description\": \"Eko POSTPAID\",\n \"code\": \"102\",\n \"country\": null,\n \"countryCode\": \"NGA\",\n \"currencyCode\": null,\n \"productType\": null,\n \"feeType\": \"DYNAMIC\",\n \"amount\": 0.0,\n \"provider\": \"ekedc\",\n \"categoryCode\": \"electricity\"\n }\n ]\n }\n}"}],"_postman_id":"70f28b42-3523-47b5-bfd3-e2861d47ecf0"},{"name":"Validate","event":[{"listen":"test","script":{"id":"db28204a-fb4b-4bd9-9a84-8f43b87a6c96","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"accountNumber\", getResponseValue.data.accountNumber);","","pm.collectionVariables.set(\"productCode\", getResponseValue.data.productCode);",""],"type":"text/javascript","packages":{}}}],"id":"af804f50-b868-46fe-b026-2c6178a70266","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"productCode\": \"101\",\n \"accountNumber\": \"123456789\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/validate","description":"

Validate Vending

This endpoint allows you to validate a utility transaction by providing the account number and product code. See account numbers and product codes that you can use for your test

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Services	Meter Number
Eko Postpaid	1111111111
Eko Prepaid	12345678910
Ikeja Postpaid	0100070763
Ikeja Prepaid	45702044269
Ibadan Prepaid	12345678910
Ibadan Postpaid	1111111111
Benin Prepaid	12345678910
Benin Postpaid	12345678910
Yola Prepaid	12345678910
Yola Postpaid	12345678910
Aba Prepaid	45068164669
Aba Postpaid	45068164669
Jos Prepaid	12345678910
Jos Postpaid	12345678910
Ph Prepaid	1111111111
Ph Postpaid	1111111111
Kano Prepaid	1111111111
Kano Postpaid	1111111111
Kaduna Prepaid	1111111111
Kaduna Postpaid	1111111111
DSTV	2022075342
Go TV	2022075342

Request Body

accountNumber (string): The account number for the vending transaction.
\n
productCode (string): The code of the product being vended.
\n

\n","urlObject":{"path":["api","v1","vending","validate"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"ae965578-c12b-43b3-ba79-3980701c7d5d","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"productCode\": \"101\",\n \"accountNumber\": \"123456789\"\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/validate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 27 Oct 2024 00:25:36 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"name\": \"Adene Jonah\",\n \"accountNumber\": \"123456789\",\n \"phoneNumber\": null,\n \"email\": null,\n \"productCode\": \"101\",\n \"accountType\": null,\n \"minAmount\": 500,\n \"maxAmount\": null,\n \"outstandingBalance\": null,\n \"address\": \"Mr. John Doe 34 Tokai, Abuja. 7999.\",\n \"district\": null,\n \"uniqueIdentifier\": null,\n \"transactionRef\": null,\n \"meterNumber\": null,\n \"kct1\": null,\n \"kct2\": null,\n \"vendorsAllowed\": null,\n \"accountStatus\": null,\n \"productPrice\": null,\n \"productValue\": null,\n \"tariffRate\": null,\n \"tariff\": null,\n \"candidateNotUnderAge\": false,\n \"account\": null\n }\n}"}],"_postman_id":"af804f50-b868-46fe-b026-2c6178a70266"},{"name":"Transact","event":[{"listen":"prerequest","script":{"id":"93e24879-d27a-415e-a51f-b79eb06403c9","exec":["const num = _.random(100000000000,999999999999);\r","pm.collectionVariables.set(\"clientRef\", num );"],"type":"text/javascript","packages":{}}},{"listen":"test","script":{"id":"ee066bca-2691-4587-9a01-6641ebec68d2","exec":["var getResponseValue = pm.response.json();","","pm.collectionVariables.set(\"vendReference\", getResponseValue.data.clientReference);"],"type":"text/javascript","packages":{}}}],"id":"9f70f8f9-8628-43c0-bdf7-d7e60b9b9490","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"productCode\": \"101\",\n \"clientReference\": \"583402664332\",\n \"amount\": 8900,\n \"data\": {\n \"accountNumber\": \"5012284010\",\n \"phoneNumber\": \"08064324179\"\n }\n}","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions","description":"

Vending Transaction

This API endpoint allows you to make a utility transaction by sending a POST request to the specified URL.

Request Body

productCode (string) - The code of the product being purchased.
\n
clientReference (string) - A unique reference provided by the client for the transaction.
\n
amount (number) - The amount of the transaction.
\n
data (object) - Additional data for the transaction, including:
\n
- accountNumber (string) - The account number associated with the transaction.
  \n
- phoneNumber (string) - The phone number linked to the transaction.
  \n
\n

The data object includes details of the transaction such as the amount, product code, token, and metadata containing account number and phone number.

\n","urlObject":{"path":["api","v1","vending","transactions"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"e0104956-81ce-4433-9138-1e5ab7941693","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"*/*","disabled":true},{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\n \"productCode\": \"101\",\n \"clientReference\": \"583402664332\",\n \"amount\": 3100,\n \"data\": {\n \"accountNumber\": \"1111111111\",\n \"phoneNumber\": \"08064324179\"\n }\n}\n","options":{"raw":{"headerFamily":"json","language":"json"}}},"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 27 Oct 2024 00:27:24 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"amount\": 3100,\n \"productCode\": \"101\",\n \"categoryCode\": \"electricity\",\n \"token\": \"112345678567859765456788\",\n \"extraTokens\": null,\n \"unit\": \"333.300\",\n \"metadata\": [\n {\n \"accountNumber\": \"1111111111\",\n \"phoneNumber\": \"08064324179\"\n }\n ],\n \"createdAt\": \"2024-10-27T00:27:24.059+00:00\",\n \"updatedAt\": null,\n \"clientReference\": \"957353583665\",\n \"paymentIdentifier\": \"1729988839525188\",\n \"retrialTimeInSec\": 0\n }\n}"}],"_postman_id":"9f70f8f9-8628-43c0-bdf7-d7e60b9b9490"},{"name":"Requery","id":"dc2b2d31-5a99-4e4c-8443-f6ac0e8754d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/query-transaction/583402664332","description":"

The endpoint retrieves transaction details based on the provided utility reference.

\n","urlObject":{"path":["api","v1","vending","query-transaction","583402664332"],"host":["https://api-demo.systemspecsng.com/services/connect-gateway"],"query":[],"variable":[]}},"response":[{"id":"11d85f90-d946-49bb-a0e2-21d4960cf4ee","name":"Successful Response","originalRequest":{"method":"GET","header":[{"key":"secretKey","value":"","type":"text"}],"url":"https://api-demo.systemspecsng.com/services/connect-gateway/api/v1/vending/query-transaction/583402664332"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Content-Security-Policy","value":"default-src 'self'; frame-src 'self' data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://storage.googleapis.com; style-src 'self' https://fonts.googleapis.com 'unsafe-inline'; img-src 'self' data:; font-src 'self' https://fonts.gstatic.com data:; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://pay.google.com/gp/p/js/pay.js ; script-src 'self' 'unsafe-inline' 'unsafe-eval' https://applepay.cdn-apple.com/jsapi/v1.1.0/apple-pay-sdk.js"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Sun, 27 Oct 2024 00:28:05 GMT"},{"key":"Expires","value":"0"},{"key":"Permissions-Policy","value":"camera=(), fullscreen=(self), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), midi=(), payment=(), sync-xhr=()"},{"key":"Pragma","value":"no-cache"},{"key":"Referrer-Policy","value":"strict-origin-when-cross-origin"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Xss-Protection","value":"0"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Approved or completed successfully\",\n \"status\": \"00\",\n \"data\": {\n \"amount\": 3100,\n \"productCode\": \"eko_prepaid\",\n \"categoryCode\": \"electricity\",\n \"token\": \"112345678567859765456788\",\n \"extraTokens\": null,\n \"unit\": \"333.300\",\n \"createdAt\": \"2024-10-27T00:27:24.000+00:00\",\n \"clientReference\": \"957353583665\",\n \"paymentIdentifier\": \"1729988839525188\"\n }\n}"}],"_postman_id":"dc2b2d31-5a99-4e4c-8443-f6ac0e8754d3"}],"id":"1b5341c9-a424-460a-972b-60c2240e951e","_postman_id":"1b5341c9-a424-460a-972b-60c2240e951e","description":""},{"name":"Response Code","item":[],"id":"462d19c8-d38f-4280-a0cb-31c8564a8dd9","description":"

Response Code	Response Message	Status Type
00	Approved or completed successfully	Successful
01	Transaction failed	Failed
02	Bad Request/Customer info could not be retrieved	Failed
03	Transaction pending	Pending
04	Authentication error/You cannot vend for this customer	Failed
06	IP Not Whitelisted	Failed
08	Limit reached	Failed
10	Insufficient amount	Failed
11	Insufficient balance	Failed
12	Invalid Transaction Reference	Failed
17	Invalid Channel	Failed
21	System error	Failed
22	Unknown payment reference	Failed
23	Invalid exchange request/similar transaction	Failed
24	User verification required	Failed
25	Amount exceeded	Failed
26	Duplicate Record	Failed
31	Invalid phone number	Failed
38	Unauthorized Debit Account	Failed
51	Insufficient Funds	Failed
62	Transaction Limit Reached	Failed
71	Unknown code	Requery
94	Duplicate Transaction	Failed
96	System Malfunction	Failed

","_postman_id":"462d19c8-d38f-4280-a0cb-31c8564a8dd9"}],"id":"00e3cb70-f414-42b6-8a26-1ad9e4deaf61","description":"

Target Audience: Aggregators, Financial Institutions

Authentication: Click HERE

About these APIs

Our Vending Bills APIs provide everyday utility bills in easy to consume, light APIs. These include bills for everyday purchases including Airtime and Data, Electricity, Internet Services etc.

\n","_postman_id":"00e3cb70-f414-42b6-8a26-1ad9e4deaf61"},{"name":"Inflight Collections","item":[{"name":"APIs","item":[{"name":"Get Salary History","event":[{"listen":"test","script":{"id":"d0b11c4d-f498-4b1a-a7b5-f83a9ff3ef1e","exec":["var getResponseValue = pm.response.json();\r","pm.collectionVariables.set(\"customerId\", getResponseValue.data.customerId);\r","pm.collectionVariables.set(\"accountNumber\", getResponseValue.data.accountNumber);\r","pm.collectionVariables.set(\"bankCode\", getResponseValue.data.bankCode);\r",""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"81e03c8f-c52f-4285-bc73-a3e0d2cfa9cf","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");\r","var apiKey = pm.collectionVariables.get(\"apiKey\");\r","var apiToken = pm.collectionVariables.get(\"apiToken\");\r","var randomnumber=Math.floor(Math.random()*1101233);\r","var authorisationCode = randomnumber;\r","var d = new Date();\r","var requestId = d.getTime();\r","var randomnumber=Math.floor(Math.random()*1101233);\r","var apiHash = CryptoJS.SHA512(apiKey + requestId + apiToken);\r","var authorization = \"remitaConsumerKey=\" + apiKey + \", remitaConsumerToken=\"+apiHash;\r","\r","pm.collectionVariables.set('requestId', requestId);\r","pm.collectionVariables.set('authorisationCode', authorisationCode);\r","pm.collectionVariables.set('authorization', authorization);\r","\r","console.log(authorization)"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"163d307c-fc5e-450f-8b20-04e79e16b1b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"

This is your token for authentication to Remita

\n"},{"key":"MERCHANT_ID","value":"","description":"

This is the merchant's unique identifier

\n"},{"key":"REQUEST_ID","value":"1751533484929","description":"

This uniquely identifies a request

\n"},{"key":"AUTHORIZATION","value":"","description":"

See Environment and Credentials Section for how this is formed

\n"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\": \"73573\",\r\n \"firstName\": \"Teresa\",\r\n \"lastName\": \"Stoker\",\r\n \"middleName\": \"R\",\r\n \"accountNumber\": \"5012284010\",\r\n \"bankCode\": \"023\",\r\n \"bvn\": \"22222222223\",\r\n \"authorisationChannel\": \"USSD\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/salary/history/provideCustomerDetails","description":"

This API allows you to get the salary history of the prospective borrower.

apiHash is the SHA-512 encryption of the concatenation of apiKey + requestId + apiToken.

Click here for Field and Definitions

\n","urlObject":{"path":["loansvc","data","api","v2","payday","salary","history","provideCustomerDetails"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"8c1387f9-5a8f-4e91-9199-4948d90b073d","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","type":"text"},{"key":"API_KEY","value":"","description":"This is your token for authentication to Remita"},{"key":"MERCHANT_ID","value":"","description":"This is the merchant's unique identifier"},{"key":"REQUEST_ID","value":"1751533484929","description":"This uniquely identifies a request"},{"key":"AUTHORIZATION","value":"","description":"See [Environment and Credentials Section](https://api.remita.net/#432c11e8-8671-4773-892e-5f3bb25e64a3) for how this is formed"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\": \"73573\",\r\n \"firstName\": \"Teresa\",\r\n \"lastName\": \"Stoker\",\r\n \"middleName\": \"R\",\r\n \"accountNumber\": \"5012284010\",\r\n \"bankCode\": \"023\",\r\n \"bvn\": \"22222222223\",\r\n \"authorisationChannel\": \"USSD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/salary/history/provideCustomerDetails"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 10 Oct 2021 17:14:03 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"hasData\": true,\n \"responseId\": \"1633886042479/1633886042479\",\n \"responseDate\": \"10-10-2021 17:14:03+0000\",\n \"requestDate\": \"10-10-2021 17:14:02+0000\",\n \"responseCode\": \"00\",\n \"responseMsg\": \"SUCCESS\",\n \"data\": {\n \"customerId\": \"1366\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\",\n \"bvn\": null,\n \"companyName\": \"National Youth Secrvice Corps\",\n \"customerName\": \"Teresa Stoker\",\n \"category\": null,\n \"firstPaymentDate\": \"10-08-2020 00:00:00+0000\",\n \"salaryCount\": \"6\",\n \"salaryPaymentDetails\": [\n {\n \"paymentDate\": \"25-06-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n },\n {\n \"paymentDate\": \"25-05-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n },\n {\n \"paymentDate\": \"25-04-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n },\n {\n \"paymentDate\": \"25-03-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n },\n {\n \"paymentDate\": \"25-02-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n },\n {\n \"paymentDate\": \"25-01-2021 13:33:46+0000\",\n \"amount\": \"155000\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\"\n }\n ],\n \"loanHistoryDetails\": [\n {\n \"loanProvider\": \"*******\",\n \"loanAmount\": 5000,\n \"outstandingAmount\": 5650,\n \"loanDisbursementDate\": \"19-08-2021 00:00:00+0000\",\n \"status\": \"NEW\",\n \"repaymentAmount\": 5650,\n \"repaymentFreq\": \"MONTHLY\"\n }\n ],\n \"originalCustomerId\": \"1366\"\n }\n}"}],"_postman_id":"163d307c-fc5e-450f-8b20-04e79e16b1b3"},{"name":"Loan Disbursement Notification","event":[{"listen":"test","script":{"id":"80caacc3-0019-4cd7-a1d0-4a74e8ab3dff","exec":["var resBody=responseBody;\r","if(resBody.startsWith('jsonp')){\r"," resBody=resBody.substring(7,resBody.length-1);\r","}\r","var getResponseValue = JSON.parse(resBody);\r","//postman.setEnvironmentVariable(\"customerId\", data.customerId);\r","pm.collectionVariables.set(\"mandateReference\", getResponseValue.data.mandateReference);"],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"557e2149-627f-4e5f-9ea7-beab81a7523c","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var apiToken = pm.collectionVariables.get(\"apiToken\");","var customerId = pm.collectionVariables.get(\"customerId\");","var accountNumber = pm.collectionVariables.get(\"accountNumber\");","var bankCode = pm.collectionVariables.get(\"bankCode\");","var d = new Date();","var requestId = d.getTime();","var randomnumber=Math.floor(Math.random()*1101233);","var authorisationCode = pm.collectionVariables.get(\"authorisationCode\");","var apiHash = CryptoJS.SHA512(apiKey + requestId + apiToken);","var authorization = \"remitaConsumerKey=\" + apiKey + \", remitaConsumerToken=\"+apiHash;","","var dd = d.getDate();","var mm = d.getMonth()+1; //January is 0!","var yyyy = d.getFullYear();","","if(dd<10){"," dd='0'+dd;","} ","if(mm<10){"," mm='0'+mm;","} ","var disbursementDate = dd + '-' + mm + '-' + yyyy + ' 01:09:25+0000';","","var loanAmount = '20000';","var numberOfRepayments = '5';","var loanCharge = 0.03;","var collectionAmount = (loanAmount/numberOfRepayments)+(loanCharge*(loanAmount/numberOfRepayments));","var totalCollectionAmount = collectionAmount*numberOfRepayments;","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('authorization', authorization);","pm.collectionVariables.set('disbursementDate', disbursementDate);","pm.collectionVariables.set('loanAmount', loanAmount);","pm.collectionVariables.set('numberOfRepayments', numberOfRepayments);","pm.collectionVariables.set('collectionAmount', collectionAmount);","pm.collectionVariables.set('totalCollectionAmount', totalCollectionAmount);","","console.log(authorization)"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"fa11a18b-7b2d-45c8-a23c-58e2bb18fc15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"

This is your token for authentication to Remita

\n"},{"key":"MERCHANT_ID","value":"","description":"

This is the merchant's unique identifier

\n"},{"key":"REQUEST_ID","value":"1751533484929","description":"

This uniquely identifies a request

\n"},{"key":"AUTHORIZATION","value":"","description":"

See Environment and Credentials Section for how this is formed

\n"}],"body":{"mode":"raw","raw":"{\r\n \"customerId\": \"202408261636\",\r\n \"authorisationCode\": \"73573\",\r\n \"authorisationChannel\": \"USSD\",\r\n \"phoneNumber\": \"08154567478\",\r\n \"accountNumber\": \"5012284010\",\r\n \"currency\": \"NGN\",\r\n \"loanAmount\": \"20000\",\r\n \"collectionAmount\": \"4120\",\r\n \"dateOfDisbursement\": \"03-07-2025 01:09:25+0000\",\r\n \"dateOfCollection\": \"03-07-2025 01:09:25+0000\",\r\n \"totalCollectionAmount\": \"20600\",\r\n \"numberOfRepayments\": \"5\",\r\n \"bankCode\": \"023\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/post/loan","description":"

When you have determined that you would want to lend to a prospective borrower who has their salary paid via Remita's products and you would like for us to retrieve your repayments whilst processing the borrower's salary payments, the Loan Disbursement API should be utilized to let us know the relevant details about the loan to enable us process your repayments.

You will receive a mandate reference as a part of the response to notifying us of the loan that you have disbursed. The Mandate reference will be your unique reference on subsequent interactions with us on the loan for which you have notified us to process repayments on.\n

\n
Note:
Date format for this API is dd-mm-yyyy hh:mm:ss+UTCOffset
\n
(For Example in the NIgerian Timezone, this could be 20-04-2022 01:09:25+0100\")
\n

apiHash is the SHA-512 encryption of the concatenation of apiKey + requestId + apiToken.

\n","urlObject":{"path":["loansvc","data","api","v2","payday","post","loan"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"7845e594-5964-4ac3-81bf-2aba66c7ef4e","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","name":"Content-Type","type":"text"},{"key":"API_KEY","value":"","description":"This is your token for authentication to Remita"},{"key":"MERCHANT_ID","value":"","description":"This is the merchant's unique identifier"},{"key":"REQUEST_ID","value":"1751533484929","description":"This uniquely identifies a request"},{"key":"AUTHORIZATION","value":"","description":"See [Environment and Credentials Section](https://api.remita.net/#432c11e8-8671-4773-892e-5f3bb25e64a3) for how this is formed"}],"body":{"mode":"raw","raw":"{\r\n \"customerId\": \"202408261636\",\r\n \"authorisationCode\": \"73573\",\r\n \"authorisationChannel\": \"USSD\",\r\n \"phoneNumber\": \"08154567478\",\r\n \"accountNumber\": \"2000001234\",\r\n \"currency\": \"NGN\",\r\n \"loanAmount\": \"20000\",\r\n \"collectionAmount\": \"4120\",\r\n \"dateOfDisbursement\": \"03-07-2025 01:09:25+0000\",\r\n \"dateOfCollection\": \"03-07-2025 01:09:25+0000\",\r\n \"totalCollectionAmount\": \"20600\",\r\n \"numberOfRepayments\": \"5\",\r\n \"bankCode\": \"011\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/post/loan"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Sun, 10 Oct 2021 18:33:00 GMT"},{"key":"Server","value":"Apache/2.4.35 (Unix) OpenSSL/1.0.2l"},{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6200"},{"key":"Content-Type","value":"application/json;charset=UTF-8"},{"key":"Keep-Alive","value":"timeout=5, max=100"},{"key":"Connection","value":"Keep-Alive"},{"key":"Transfer-Encoding","value":"chunked"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"hasData\": true,\n \"responseId\": \"1660828507169/1660828507169\",\n \"responseDate\": \"18-08-2022 13:15:07+0000\",\n \"requestDate\": \"18-08-2022 13:15:07+0000\",\n \"responseCode\": \"00\",\n \"responseMsg\": \"SUCCESS\",\n \"data\": {\n \"authorisationCode\": \"832790\",\n \"accountNumber\": \"5012284010\",\n \"bankCode\": \"023\",\n \"amount\": \"20000\",\n \"customerId\": \"1366\",\n \"status\": \"NEW\",\n \"mandateReference\": \"190008773515\"\n }\n}"}],"_postman_id":"fa11a18b-7b2d-45c8-a23c-58e2bb18fc15"},{"name":"Collection Notification","event":[{"listen":"prerequest","script":{"id":"7234e38d-ec69-4dc5-b59a-44792d66fcc1","exec":["var url = \"http://remita.net\"; //your notification url\r","var customerId = pm.collectionVariables.get('customerId')\r","var mandateReference = pm.collectionVariables.get('mandateReference')\r","pm.collectionVariables.set('your-url',url)"],"type":"text/javascript","packages":{}}}],"id":"38fe1bc3-e076-4dc5-9a48-11aa3e594607","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\": 1509378261255,\r\n \"amount\": 2000,\r\n \"statusCode\": null,\r\n \"modulename\": \"PAYDAYLOAN\",\r\n \"notificationSent\": false,\r\n \"dateNotificationSent\": \"2019-07-10\",\r\n \"firstNotificationSent\": null,\r\n \"dateFirstNotificationSent\": null,\r\n \"netSalary\": 23278.5,\r\n \"totalCredit\": 2000,\r\n \"customerPhoneNumber\": null,\r\n \"mandateRef\": \"190000196045\",\r\n \"balanceDue\": 6000,\r\n \"customer_id\": \"1366\",\r\n \"request_id\": null,\r\n \"payment_date\": \"24-08-2021 14:56:53+0000\",\r\n \"payment_status\": \"NEW\",\r\n \"status_reason\": null\r\n}","options":{"raw":{"language":"json"}}},"url":"{{yourListeningUrl}}","description":"

The collection notification is a webhook - which we use to send you a notification of collections/repayments made in your favour.

Once a mandate has been created for a Remita will debit a repayment on any inflow to the payer's account via Remita

\n
Notes:
\n
- Ensure you acknowledge the collection notification in the format shown in the sample response body.
\n
- Attempts to send the notification will be made thrice, after which no further attempts will be made on that specific transaction
\n

\n","urlObject":{"host":["{{yourListeningUrl}}"],"query":[],"variable":[]}},"response":[{"id":"d39c79d4-7387-4843-80ab-b2cdf718c8a9","name":"Sample Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"id\": 1509378261255,\n \"amount\": 2000,\n \"statusCode\": null,\n \"modulename\": \"PAYDAYLOAN\",\n \"notificationSent\": false,\n \"dateNotificationSent\": \"2019-07-10\",\n \"firstNotificationSent\": null,\n \"dateFirstNotificationSent\": null,\n \"netSalary\": 23278.5,\n \"totalCredit\": 2000,\n \"customerPhoneNumber\": null,\n \"mandateRef\": \"190000196045\",\n \"balanceDue\": 6000,\n \"customer_id\": \"1366\",\n \"request_id\": null,\n \"payment_date\": \"24-08-2021 14:56:53+0000\",\n \"payment_status\": \"NEW\",\n \"status_reason\": null\n}","options":{"raw":{"language":"json"}}},"url":"{{url}}"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"Response_code\":\"00\",\r\n \"response_descr\":\"Successful\",\r\n \"ack_id\": \"00\"\r\n}\r\n"}],"_postman_id":"38fe1bc3-e076-4dc5-9a48-11aa3e594607"},{"name":"Mandate History","event":[{"listen":"prerequest","script":{"id":"c2feb790-ac07-4d92-87c9-9914862ebe25","exec":["var merchantId_DD = pm.collectionVariables.get(\"merchantId\");","var apiKey_DD = pm.collectionVariables.get(\"apiKey\");","var apiToken = pm.collectionVariables.get(\"apiToken\");","","var d = new Date();","var requestId = d.getTime();","var randomnumber=Math.floor(Math.random()*1101233);","var authorisationCode = pm.collectionVariables.get(\"authorisationCode\");","var apiHash = CryptoJS.SHA512(apiKey + requestId + apiToken);","var authorization = \"remitaConsumerKey=\" + apiKey + \", remitaConsumerToken=\"+apiHash;","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('authorization', authorization);","","console.log(authorization)"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8c45c836-5166-4cfb-8c2c-808b23fdab8d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"

This is your token for authentication to Remita

\n"},{"key":"MERCHANT_ID","value":"","description":"

This is the merchant's unique identifier

\n"},{"key":"REQUEST_ID","value":"1751533484929","description":"

This uniquely identifies a request

\n"},{"key":"AUTHORIZATION","value":"","description":"

See Environment and Credentials Section for how this is formed

\n"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\": \"73573\",\r\n \"customerId\": \"202408261636\",\r\n \"mandateRef\": \"190799091952\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/loan/payment/history","urlObject":{"path":["loansvc","data","api","v2","payday","loan","payment","history"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"e3505564-60da-4347-84b3-892cbb5eb5a4","name":"No Loan Repayments Processed","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"This is your token for authentication to Remita"},{"key":"MERCHANT_ID","value":"","description":"This is the merchant's unique identifier"},{"key":"REQUEST_ID","value":"1751533484929","description":"This uniquely identifies a request"},{"key":"AUTHORIZATION","value":"","description":"See [Environment and Credentials Section](https://api.remita.net/#432c11e8-8671-4773-892e-5f3bb25e64a3) for how this is formed"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\":\"73573\",\r\n \"customerId\":\"0000013\",\r\n \"mandateRef\":\"110220838465\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/loan/payment/history"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6201"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 22 Aug 2021 20:50:27 GMT"},{"key":"Content-Type","value":"application/json;charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"hasData\": false,\n \"responseId\": \"1629665425482/1629665425482\",\n \"responseDate\": \"22-08-2021 20:50:27+0000\",\n \"requestDate\": \"22-08-2021 20:50:26+0000\",\n \"responseCode\": \"00\",\n \"responseMsg\": \"SUCCESS\",\n \"data\": {\n \"customerId\": \"0000013\",\n \"firstName\": \"GOKE GOKE\",\n \"lastName\": null,\n \"phoneNumber\": null,\n \"loanMandateReference\": \"110220838465\",\n \"totalDisbursed\": 20000,\n \"outstandingLoanBal\": 210000,\n \"loanRepaymentRef\": null,\n \"employerName\": \"FUNDANT INTERNATIONAL\",\n \"salaryAccount\": \"7658989890\",\n \"authorisationCode\": \"842530\",\n \"salaryBankCode\": \"GUARANTY TRUST BANK\",\n \"disbursementAccountBank\": \"ACCESS BANK PLC\",\n \"collectionStartDate\": \"28-12-2018 11:49:25+0000\",\n \"dateOfDisbursement\": \"27-11-2018 11:49:25+0000\",\n \"disbursementAccount\": \"7658989890\",\n \"status\": \"NEW\",\n \"lenderDetails\": \"ALLARDYCE TECHNOLOGIES\",\n \"repayment\": null\n }\n}"}],"_postman_id":"8c45c836-5166-4cfb-8c2c-808b23fdab8d"},{"name":"Stop Loan Collection","event":[{"listen":"prerequest","script":{"id":"30dd7320-58a1-4db9-9c67-17844d480b6d","exec":["var merchantId = pm.collectionVariables.get(\"merchantId\");","var apiKey = pm.collectionVariables.get(\"apiKey\");","var apiToken = pm.collectionVariables.get(\"apiToken\");","","var d = new Date();","var requestId = d.getTime();","var randomnumber=Math.floor(Math.random()*1101233);","var authorisationCode = pm.collectionVariables.get(\"authorisationCode\");","var apiHash = CryptoJS.SHA512(apiKey + requestId + apiToken);","var authorization = \"remitaConsumerKey=\" + apiKey + \", remitaConsumerToken=\"+apiHash;","","pm.collectionVariables.set('requestId', requestId);","pm.collectionVariables.set('authorization', authorization);","","console.log(authorization)"],"type":"text/javascript","packages":{},"requests":{}}}],"id":"9f288f3b-4da2-4521-8c23-48160e9751e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"

This is your token for authentication to Remita

\n"},{"key":"MERCHANT_ID","value":"","description":"

This is the merchant's unique identifier

\n"},{"key":"REQUEST_ID","value":"1751533484929","description":"

This uniquely identifies a request

\n"},{"key":"AUTHORIZATION","value":"","description":"

See Environment and Credentials Section for how this is formed

\n"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\": \"73573\",\r\n \"customerId\": \"202408261636\",\r\n \"mandateReference\": \"190799091952\"\r\n}"},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/stop/loan","urlObject":{"path":["loansvc","data","api","v2","payday","stop","loan"],"host":["https://demo.remita.net/remita/exapp/api/v1/send/api"],"query":[],"variable":[]}},"response":[{"id":"9f138a34-19ea-497c-a213-9df50a0d397a","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"API_KEY","value":"","description":"This is your token for authentication to Remita"},{"key":"MERCHANT_ID","value":"","description":"This is the merchant's unique identifier"},{"key":"REQUEST_ID","value":"1751533484929","description":"This uniquely identifies a request"},{"key":"AUTHORIZATION","value":"","description":"See [Environment and Credentials Section](https://api.remita.net/#432c11e8-8671-4773-892e-5f3bb25e64a3) for how this is formed"}],"body":{"mode":"raw","raw":"{\r\n \"authorisationCode\": \"73573\",\r\n \"customerId\": \"1366\",\r\n \"mandateReference\": \"200009304590\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://demo.remita.net/remita/exapp/api/v1/send/api/loansvc/data/api/v2/payday/stop/loan"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[{"key":"X-Application-Context","value":"channel-gateway:remita.monitor:6201"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 22 Aug 2021 20:52:44 GMT"},{"key":"Content-Type","value":"application/json;charset=UTF-8"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"hasData\": false,\n \"responseId\": \"1629665563414/1629665563414\",\n \"responseDate\": \"22-08-2021 20:52:44+0000\",\n \"requestDate\": \"22-08-2021 20:52:44+0000\",\n \"responseCode\": \"00\",\n \"responseMsg\": \"SUCCESS\",\n \"data\": {\n \"customerId\": \"1366\",\n \"status\": \"true\",\n \"mandateReference\": \"200009304590\"\n }\n}"}],"_postman_id":"9f288f3b-4da2-4521-8c23-48160e9751e0"}],"id":"579fb401-f937-497b-b8d0-98ca8db2aa77","description":"

Environments & Credentials

Test Environment

BASE URL\nDemo Environment: https://remitademo.net/remita/exapp/api/v1/send/api\nCREDENTIALS\n- Merchant ID: 27768931\n- API Key: Q1dHREVNTzEyMzR8Q1dHREVNTw==\n- API Token: SGlQekNzMEdMbjhlRUZsUzJCWk5saDB6SU14Zk15djR4WmkxaUpDTll6bGIxRCs4UkVvaGhnPT0=\n- API Hash: SHA512 hashing of (apiKey + requestId + apiToken)\n- Authorization: remitaConsumerKey=`apiKey`,remitaConsumerToken=`apiHash`\nPROCESS FLOW\nThe link below shows the flowchart for the operational process of this service.\nhttps://viewer.diagrams.net/?tags={}&highlight=0000ff&layers=1&nav=1#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\n\n

","_postman_id":"579fb401-f937-497b-b8d0-98ca8db2aa77"},{"name":"Fields and Definitions","item":[],"id":"98e699bb-ccf0-4266-9467-dbef5c42d96a","description":"

Request Fields

Parameter	Type	Mandatory	Description
authorisationCode	String	Yes	Authorization Code representing the consent gotten from potential borrower to get his/her salary details via this API call
firstName	String	Yes	Potential Borrower's First Name
lastName	String	Yes	Potential Borrower's Last Name
middleName	String	No	Potential Borrower's Middle Name
accountNumber (get salary history)	String	Yes	Potential Borrower's Salary Account number
bankCode (get salary history)	String	Yes	Potential Borrower's Bank code for Salary Account Number (See list of Banks Here for your reference)
bvn	String	Yes	Potential Borrower's Bank Verification Number (BVN)
authorisationChannel	String	Yes	Channel through which potential Borrower gave their consent.
customerId	String	Yes	Unique Customer ID for borrower on Remita. You will get this in response to the Get Salary History call
phoneNumber	String	Yes	Borrower's Phone number
currency	String	Yes	Currency of Loan
loanAmount	String	Yes	Amount being lent to the borrower
collectionAmount	String	Yes	Amount to be credited to the lender from the borrower's incoming salary related payment
accountNumber (loan disbursement notification)	String	Yes	Repayment collection account number
bankCode (loan disbursement notification)	String	Yes	Repayment collection account bank code
dateOfDisbursement	String	Yes	Date loan was disbursed to borrower, in the format dd-mm-yyyy hh:mm:ss+UTCOffset (For Example in the NIgerian Timezone, this could be 20-04-2022 01:09:25+0100\")
dateOfCollection	String	Yes	Date lender wants collections to commence on the mandate, in the format dd-mm-yyyy hh:mm:ss+UTCOffset (For Example in the NIgerian Timezone, this could be 20-04-2022 01:09:25+0100\")
totalCollectionAmount	String	Yes	Total amount to be collected from the borrower inclusive of fees/charges
numberOfRepayments	String	Yes	Number of repayments to be processed from the borrower where one repayment represents the `collectionAmount` value
mandateRef	String	Yes	Unique reference reference for a loan . You will get this in response to the loan disburment notification call named `mandateReference`.

Response Fields

Parameter	Type	Description
customerId	String	Unique Customer ID for borrower on Remita. You will get this in response to the Get Salary History call
accountNumber	String	Potential Borrower's Salary Account number
bankCode	String	Potential Borrower's Bank code for Salary Account Number (See list of Banks Here for your reference)
bvn	String	Potential Borrower's Bank Verification Number (BVN)
companyName	String	Current company where Potential Borrower works and where potential borrower will be receiving salary from
customerName	String	Potential borrower's name with Remita
firstPaymentDate	String	Date of First Salary payment with company stated as `companyName`
salaryCount	String	Number of Salary Payments in API response
salaryPaymentDetails -- paymentDate	String	Salary Payment Date
salaryPaymentDetails -- amount	String	Amount paid to potential borrower in Salary related payment
salaryPaymentDetails -- accountNumber	String	Salary account number where potential borrower received salary
salaryPaymentDetails -- bankCode	String	Bank of Salary account number where potential borrower received salary (See list of Banks Here for your reference)
loanHistoryDetails -- loanProvider	String	Loan Provider where lender has an active loan
loanHistoryDetails -- loanAmount	String	Amount borrowed by borrower with said loan provider where lender has an active loan
loanHistoryDetails -- outstandingAmount	String	Amount outstanding on said active loan that borrower has
loanHistoryDetails -- loanDisbursementDate	String	Date said active loan was disbursed to borrower
loanHistoryDetails -- status	String	Status of active loan
loanHistoryDetails -- repaymentAmount	String	Repayment amount that is to be collected whilst Remita is processing salary related payment of borrower
loanHistoryDetails -- repaymentFreq	String	Frequency of Repayment
originalCustomerId	String	Original Unique Customer ID for borrower on Remita. `customerId` will be more useful to you as a lender. You can ignore this field.
authorisationCode	String	Authorization Code representing the consent gotten from potential borrower to get his/her salary details via this API call
amount	String	Amount borrowed to the borrower
mandateReference	String	Unique reference reference for a loan
firstName	String	Borrower's First Name
lastName	String	Borrower's Last Name
phoneNumber	String	Borrower's Phone number
loanMandateReference	String	Unique reference reference for a loan
totalDisbursed	Numeric	Total loan disbursed on Mandate in question
outstandingLoanBal	Numeric	Outstanding loan balance on Mandate in question
employerName	String	Name of Employer responsible for paying borrower's salary
salaryAccount	String	Salary Account of Borrower
salaryBankCode	String	Bank of Salary Account of Borrower (See list of Banks Here for your reference)
disbursementAccountBank	String	Bank where loan was disbursed into
collectionStartDate	String	Date communicated by lender on the mandate as to when collections can commence from
dateOfDisbursement	String	Date loan was disbursed to borrower
disbursementAccount	String	Account number where loan was disbursed into
status	String	Status of the Mandate
lenderDetails	String	Lender on the Mandate

","_postman_id":"98e699bb-ccf0-4266-9467-dbef5c42d96a"},{"name":"Status Codes","item":[],"id":"6a8740f5-7c3a-4486-916a-a9f0bb5e3e25","description":"

Code	Description
00	Successful (Record Found
01	Transaction Failed
02	Bad Request
04	Authentication Error
06	System Error
07	Limit Reached
09	Unknown Mandate Reference
11	Invalid Amount
12	Resource not found
13	Duplicate Request
14	Authentication Expired
15	User Registration Error
16	Duplicate User Registration Error
17	User Verification Required
22	Unknown Transaction
23	Already Processed Transaction
24	Invalid Request.Missing Headers or Parameters
25	Error Processing Request
26	Unknown Merchant
27	Bank Account Not Linked with Merchant
28	Unknown Bank Account
29	Decryption Error
30	Account Pending Authorization for Merchant Debit
31	Invalid Credit Account
32	Missing Request Parameters
33	Invalid Debit Account
34	API Authorization Error/ API Hashing Error
35	Request Time Stamp Expired
36	Invalid Request Time Stamp Format
37	Unauthorized Credit Account
38	Unauthorized Debit Account
40	Invalid Date
41	Invalid Authorisation ID
42	Inactive Customer
7800	User Record not Found
7801	Customer not Found
7802	Customer already enrolled
7803	Customer already enrolled
7804	Customer opted out of service
7805	Unauthorized Mandate Reference
7806	Customer is ineligible to receive loan at this time
7807	Customer details could not be provided at this time
7808	Customer is Currently Suspended
7809	Invalid BVN Match

","_postman_id":"6a8740f5-7c3a-4486-916a-a9f0bb5e3e25"},{"name":"Bank Codes","item":[],"id":"010ab091-0f76-4cdb-bdfc-de84cefa023a","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

bankCode	bankName
000	CENTRAL BANK OF NIGERIA
011	FIRST BANK OF NIGERIA PLC
023	NIGERIA INTERNATIONAL BANK (CITIBANK)
030	BANK PLC
032	UNION BANK OF NIGERIA PLC
033	UBA PLC
035	WEMA BANK PLC
039	STANBIC IBTC BANK PLC
044	ACCESS BANK PLC
050	ECOBANK NIGERIA PLC
057	ZENITH BANK PLC
058	GUARANTY TRUST BANK
068	STANDARD CHARTERED BANK NIGERIA LTD
070	FIDELITY BANK PLC
076	SKYE BANK PLC
101	PROVIDUS BANK
214	FIRST CITY MONUMENT BANK PLC
215	UNITY BANK PLC
232	STERLING BANK PLC
301	JAIZ BANK
459	CORONATION MERCHANT BANK LIMITED
480	JUBILEE BANK
510120013	KANO MICROFINANCE BANKS
511080016	ESO SAVINGS LOANS PLC
511080026	ASO SAVINGS AND LOANS
511080036	NATIONAL HOUSING FUND
511080106	GAA-AKANBI MICRO FINANCE BANK
512170012	CLASSIC MICROFINANCE BANK
512170022	SOLID ROCK MFB OKE ONA ABEOKUTA
512170032	LAVENDER MICROFINANCE BANK LTD
512170042	EBIGI MICROFINANCE BANK
512170052	EFOTAMODI/OGUNOLA MICROFINANCE BANK
512170062	EIYEPE MICROFINANCE BANK
512170072	EJOSE MICROFINANCE BANK LTD
512170082	EMAZING GRACE MICROFINANCE BANK
512170092	CATLAND MICROFINANCE BANK LTD
512170102	OGUN STATE MICROFINANCE BANKS
512170112	UKUOMBE MICROFINANCE BANK LTD
512170122	URUWON MICROFINANCE BANK
512170132	USO-E MICROFINANCE BANK
512170142	EPPLE MICROFINANCE BANK
512170152	OFONYIN MICROFINANCE BANK
512170162	OMODI-IMOSAN MICROFINANCE BANK LTD
512170172	OJEBU-IFE COMMUNITY BANK NIG. LTD
512170182	OJEBU-IMUSIN MICROFINANCE BANK LTD
512170192	OKENNE MICROFINANCE BANK LTD
512170202	OGUN STATE MICROFINANCE BANKS
512170212	OLISAN MICROFINANCE BANK LTD
512170222	OMOWO MICROFINANCE BANK NIG LTD
512170232	ONTERLAND MICROFINANCE BANK
512170242	OPERU MICROFINANCE BANK LTD
512170252	OTELE MICROFINANCE BANK LTD
512170262	OGUN STATE MICROFINANCE BANKS
512170272	OGUN STATE MICROFINANCE BANKS
512170282	OGUN STATE MICROFINANCE BANKS
512170292	MALPOLY MICROFINANCE BANK
512170302	MOLUSI MICROFINANCE BANK LTD
512170312	NEW IMAGE MFB EGBA ODEDA
512170322	COMBINED BENEFITS MICROFINANCE BANK
512170332	OGUN STATE MICROFINANCE BANKS
512170342	AMU COMMUNITY BANK LTD
512170352	ARISUN MFB
512170362	RIVERSIDE MICROFINANCE BANK LTD
512170372	SAGAM MICROFINANCE BANK
512170382	TRUST MFB EGBA OWODE ABEOKUTA
512170392	OGUN STATE MICROFINANCE BANKS
512170402	ACON SUCCESS MICROFINANCE BANK LTD
512170412	UNAAB MICROFINANCE BANK
512170422	WEST-END MICROFINANCE BANK
512170432	HONEY MICROFINANCE BANK
512170442	EGOSASA MICROFINANCE BANK
512170452	ESTRA POLARIS MICROFINANCE BANK LTD
512170462	OGUN STATE MICROFINANCE BANKS
512170472	OGUN STATE MICROFINANCE BANKS
512170492	STAR MICROFINANCE BANK
512170502	CENTAGE SAVINGS AND LOANS
512170522	OGUN STATE MICROFINANCE BANKS
512170542	GATEWAY SAVINGS AND LOANS LTD
512170552	NACRDB ABIGI
512170562	NACRDB AYETORO
512170572	NACRDB IMEKO
512170582	NACRDB ABEOKUTA
512170592	OGUN STATE MICROFINANCE BANKS
512170602	NACRDB OTA
512170612	NACRDB ODEDA ABEOKUTA
512170622	NACRDB AGO-IWOYE
512170632	NACRDB SAGAM
512170652	ONTEGRATED MICROFINANCE BANK
512170662	OROLU MIRCOFINANCE BANK LTD
513210013	RIVERS MICROFINANCE BANKS
514040013	EDO MICROFINANCE BANKS
515150013	LAGOS BUILDING INVESTMENT CO.LTD
515150023	SKYE MORTGAGE
515150033	UNION HOMES SAVINGS AND LOANS PLC
515150043	NIGERIA POLICE FORCE
515150053	NIGERIA POLICE FORCE
515150063	LAGOS MICROFINANCE BANKS
515150073	SPECSMFB
516290013	OSUN MICROFINANCE BANKS
516290023	AAU MICRO-FINANCE BANK
517150014	ARITA BASHORUN MICROFINANCE BANK
517150024	MULTIVEST MICROFINANCE BANK
517150034	OGBOORA MFB
517150044	PACESETTERS MICROFINANCE BANK
517150054	CIVIC MICROFINANCE BANK
517150064	ALOGBON MFB
517150074	CREST MFB
517150084	EYETE MFB
517150094	EKESAN MFB
518150014	YOBE SAVINGS & LOANS LIMITED
518150024	NIG AGRIC COOP & RURAL DEV BANK LTD
518150034	YOBE MICROFINANCE BANK
518150044	YOBE MICROFINANCE BANK
518150054	YOBE MICROFINANCE BANK
518150064	YOBE MICROFINANCE BANK
519290019	ZION MFB
520150010	AURS MICRO FINANCE BANK
520150020	KWARA STATE MICROFINANCE BANKS
520150030	KWARA STATE MICROFINANCE BANKS
520150040	KWARA STATE MICROFINANCE BANKS
520150050	KWARA STATE MICROFINANCE BANKS
520150060	KWARA STATE MICROFINANCE BANKS
520150070	KWARA STATE MICROFINANCE BANKS
520150080	KWARA STATE MICROFINANCE BANKS
520150090	KWARA STATE MICROFINANCE BANKS
520150100	KWARA STATE MICROFINANCE BANKS
520150110	KWARA STATE MICROFINANCE BANKS
520150120	KWARA STATE MICROFINANCE BANKS
520150130	KWARA STATE MICROFINANCE BANKS
520150140	KWARA STATE MICROFINANCE BANKS
520150150	KWARA STATE MICROFINANCE BANKS
520150160	KWARA STATE MICROFINANCE BANKS
520150170	KWARA STATE MICROFINANCE BANKS
520150180	KWARA STATE MICROFINANCE BANKS
521150010	OKOLE MICROFINANCE BANK
521150020	SUNBEAM MICROFINANCE BANK LTD
521150030	ERAMOKO MFB LIMITED
522150010	JIGAWA SAVINGS & LOANS LTD
580000010	JUBILEE LIFE MORTGAGE BANK
590000001	POCKET MONEY

","_postman_id":"010ab091-0f76-4cdb-bdfc-de84cefa023a"}],"id":"bc6737a4-65c2-43de-b0dd-2fa98f55cf34","description":"

Our Inflight Collection APIs firstly allows you to get Salary History on over a million salary earners receiving their Salary and related Payroll payments through our Payroll offerings every month via our Data Referencing Service.

Secondly, it avails you the opportunity to have repayments from your borrowers deducted and credited to you at the point of salary payment- thereby significantly improving the success rate on your repayments

\n","_postman_id":"bc6737a4-65c2-43de-b0dd-2fa98f55cf34"},{"name":"Verification Service","item":[],"id":"86712cff-3f16-4728-9b2e-f587a17cae54","_postman_id":"86712cff-3f16-4728-9b2e-f587a17cae54","description":""},{"name":"NRS e-Invoice","item":[{"name":"Merchant","item":[{"name":"Process Invoice","event":[{"listen":"prerequest","script":{"exec":["// Profile","// let main_MerchantId = pm.environment.get(\"firsMerchantId\");","","let businessId = \"SF19KD\";","let firsServiceId = \"1736d4f4-c154-4fca-85b8-895141a03096\";","","","pm.environment.set(\"main_MerchantId\",\"CON7B60C\");","pm.environment.set(\"tin_MainTest\",\"02989-0001\");","pm.environment.set(\"businessId_MainTest\",businessId);","pm.environment.set(\"firsServiceId_MainTest\", firsServiceId);","","// ===== Prepare Request Body =====","let now = new Date();","","","// ===== Helper Function for Date Formatting =====","function formatDate(date) {"," const dd = String(date.getDate()).padStart(2, '0');"," const mm = String(date.getMonth() + 1).padStart(2, '0');"," const yyyy = date.getFullYear();"," return `${dd}-${mm}-${yyyy}`; // For display (dd-mm-yyyy)","}","","function formatCompactDate(date) {"," const dd = String(date.getDate()).padStart(2, '0');"," const mm = String(date.getMonth() + 1).padStart(2, '0');"," const yyyy = date.getFullYear();"," return `${yyyy}${mm}${dd}`; // For identifiers (yyyymmdd)","}","","// ===== Dates & Time =====","let issueDate = formatDate(now); // dd-mm-yyyy","let dueDateObj = new Date(now);","dueDateObj.setDate(dueDateObj.getDate() + 30);","let dueDate = formatDate(dueDateObj); // dd-mm-yyyy","let issueTime = now.toTimeString().slice(0, 8); // HH:mm:ss","","// ===== Invoice Identifiers =====","const InvoiceNo = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","const purchaseOrder = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","const customerRefSeller = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","","let formattedDate = formatCompactDate(now); // yyyymmdd","","// let businessId = '252cd495-db2c-4cfc-8a46-f998ee4c70e6';","// let firsServiceId = 'null';","// let businessId = pm.environment.get(\"firsBusinessId\");","// let firsServiceId = pm.environment.get(\"firsServiceId\");","","","let buyerIrn = InvoiceNo + '-' + businessId + '-' + formattedDate;","let sellerIrn = InvoiceNo + '-' + businessId + '-' + formattedDate;","","// ===== Sample Customers =====","const customers = ["," {"," customerId: \"cust_001\","," name: \"Zenith Bank Plc\","," email: \"contact@zenithbank.com\","," phone: \"+2348011111111\","," identifiers: { tin: \"29114238-0001\" },"," address: { line: \"1 Main Street\", city: \"Lagos\", country: \"NG\", postalZone: \"100001\" }"," },"," {"," customerId: \"cust_002\","," name: \"Dangote Group\","," email: \"info@dangote.com\","," phone: \"+2348022222222\","," identifiers: { tin: \"99234238-0001\" },"," address: { line: \"2 Broad Street\", city: \"Abuja\", country: \"NG\", postalZone: \"900001\" }"," },"," {"," customerId: \"cust_003\","," name: \"Innoson Motors\","," email: \"sales@innosonmotors.com\","," phone: \"+2348033333333\","," identifiers: { tin: \"21919238-0001\" },"," address: { line: \"3 Kings Road\", city: \"Port Harcourt\", country: \"NG\", postalZone: \"500001\" }"," },"," {"," customerId: \"cust_004\","," name: \"Nigerian Breweries Plc\","," email: \"support@nbplc.com\","," phone: \"+2348044444444\","," identifiers: { tin: \"29000238-0001\" },"," address: { line: \"4 Queens Drive\", city: \"Enugu\", country: \"NG\", postalZone: \"400001\" }"," },"," {"," customerId: \"cust_005\","," name: \"Jumia Nigeria\","," email: \"hello@jumia.com\","," phone: \"+2348055555555\","," identifiers: { tin: \"29388238-0001\" },"," address: { line: \"5 Unity Road\", city: \"Kano\", country: \"NG\", postalZone: \"700001\" }"," },"," {"," customerId: \"cust_006\","," name: \"Airtel Nigeria\","," email: \"care@airtel.com\","," phone: \"+2348066666666\","," identifiers: { tin: \"29499238-0001\" },"," address: { line: \"6 Government House\", city: \"Awka\", country: \"NG\", postalZone: \"420001\" }"," },"," {"," customerId: \"cust_007\","," name: \"GTBank Plc\","," email: \"support@gtbank.com\","," phone: \"+2348077777777\","," identifiers: { tin: \"11188238-0001\" },"," address: { line: \"7 Independence Avenue\", city: \"Kaduna\", country: \"NG\", postalZone: \"800001\" }"," },"," {"," customerId: \"cust_008\","," name: \"Access Bank Plc\","," email: \"customerservice@accessbank.com\","," phone: \"+2348088888888\","," identifiers: { tin: \"29388993-0001\" },"," address: { line: \"8 Old Road\", city: \"Owerri\", country: \"NG\", postalZone: \"460001\" }"," },"," {"," customerId: \"cust_009\","," name: \"Shoprite Nigeria\","," email: \"info@shoprite.com\","," phone: \"+2348099999999\","," identifiers: { tin: \"24988238-0001\" },"," address: { line: \"9 Market Road\", city: \"Ibadan\", country: \"NG\", postalZone: \"200001\" }"," },"," {"," customerId: \"cust_010\","," name: \"Konga Online Shopping Ltd\","," email: \"support@konga.com\","," phone: \"+2348010101010\","," identifiers: { tin: \"29320038-0001\" },"," address: { line: \"10 Ikoyi Crescent\", city: \"Lagos\", country: \"NG\", postalZone: \"101001\" }"," }","];","","// ===== Sample Line Items =====","const lineItemsList = ["," { name: \"50kg Bag of Rice\", description: \"Premium long-grain rice\", hsnCode: \"CC-001\", productCategory: \"Food and Beverages\", unitPrice: 5000, discountRate: 10, feeRate: 2, taxRate: 7.5 },"," { name: \"50kg Bag of Beans\", description: \"Premium beans\", hsnCode: \"CC-002\", productCategory: \"Food and Beverages\", unitPrice: 4500, discountRate: 5, feeRate: 1.5, taxRate: 7.5 },"," { name: \"Carton of Indomie\", description: \"Instant noodles\", hsnCode: \"CC-003\", productCategory: \"Food\", unitPrice: 3500, discountRate: 8, feeRate: 2, taxRate: 7.5 },"," { name: \"Gallon of Vegetable Oil\", description: \"Cooking oil\", hsnCode: \"CC-004\", productCategory: \"Food\", unitPrice: 12000, discountRate: 12, feeRate: 2.5, taxRate: 7.5 },"," { name: \"Bag of Garri\", description: \"Ijebu Garri\", hsnCode: \"CC-005\", productCategory: \"Food\", unitPrice: 3000, discountRate: 7, feeRate: 1, taxRate: 7.5 },"," { name: \"Carton of Milk\", description: \"Powdered milk\", hsnCode: \"CC-006\", productCategory: \"Beverages\", unitPrice: 8000, discountRate: 10, feeRate: 2, taxRate: 7.5 },"," { name: \"Bottle of Palm Oil\", description: \"Palm oil\", hsnCode: \"CC-007\", productCategory: \"Food\", unitPrice: 2000, discountRate: 3, feeRate: 1, taxRate: 7.5 },"," { name: \"Bag of Sugar\", description: \"Refined sugar\", hsnCode: \"CC-008\", productCategory: \"Food\", unitPrice: 4000, discountRate: 6, feeRate: 1.5, taxRate: 7.5 },"," { name: \"Bag of Flour\", description: \"Baking flour\", hsnCode: \"CC-009\", productCategory: \"Food\", unitPrice: 6000, discountRate: 9, feeRate: 2, taxRate: 7.5 },"," { name: \"Carton of Juice\", description: \"Fruit juice\", hsnCode: \"CC-010\", productCategory: \"Beverages\", unitPrice: 10000, discountRate: 10, feeRate: 2, taxRate: 7.5 }","];","","// ===== Random Customer & Line Items =====","const customer = customers[Math.floor(Math.random() * customers.length)];","const shuffledItems = lineItemsList.sort(() => 0.5 - Math.random()).slice(0, 2); // always 2 line items","","// ===== Calculate Totals =====","let totalLineAmount = 0;","let totalTax = 0;","let calculatedLineItems = [];","","shuffledItems.forEach(item => {"," const quantity = Math.floor(Math.random() * 5) + 1; // random 1-5"," const lineTotal = item.unitPrice * quantity;"," const discountAmount = parseFloat((lineTotal * (item.discountRate / 100)).toFixed(2));"," const feeAmount = parseFloat((lineTotal * (item.feeRate / 100)).toFixed(2));"," const taxableAmount = parseFloat((lineTotal + feeAmount - discountAmount).toFixed(2)); "," const taxAmount = parseFloat((taxableAmount * (item.taxRate / 100)).toFixed(2));"," const totalAmount = taxableAmount; "," "," totalLineAmount += taxableAmount;"," totalTax += taxAmount;",""," calculatedLineItems.push({"," name: item.name,"," description: item.description,"," sellersItemIdentification: \"sellersItemIdentification\","," hsnCode: item.hsnCode,"," productCategory: item.productCategory,"," unitPrice: item.unitPrice,"," discountRate: item.discountRate,"," discountAmount,"," feeRate: item.feeRate,"," feeAmount,"," quantity,"," totalAmount,"," taxCode: \"STANDARD_VAT\","," taxRate: item.taxRate,"," taxAmount"," });","});","","const grandTotal = parseFloat((totalLineAmount + totalTax).toFixed(2));","","// ===== Set Environment Variables =====","pm.environment.set(\"issueDate\", issueDate);","pm.environment.set(\"dueDate\", dueDate);","pm.environment.set(\"issueTime\", issueTime);","pm.environment.set(\"buyerIrn\", buyerIrn);","pm.environment.set(\"sellerIrn\", sellerIrn);","pm.environment.set(\"InvoiceNo\", InvoiceNo);","pm.environment.set(\"purchaseOrder\", purchaseOrder);","","// ===== Customer Variables =====","pm.environment.set(\"cust_customerId\", customer.customerId);","pm.environment.set(\"cust_name\", customer.name);","pm.environment.set(\"cust_email\", customer.email);","pm.environment.set(\"cust_phone\", customer.phone);","pm.environment.set(\"cust_tin\", customer.identifiers.tin);","pm.environment.set(\"cust_address_line\", customer.address.line);","pm.environment.set(\"cust_address_city\", customer.address.city);","pm.environment.set(\"cust_address_country\", customer.address.country);","pm.environment.set(\"cust_address_postalZone\", customer.address.postalZone);","","// ===== Clear Existing Line Items =====","for (let i = 0; i < 10; i++) {"," const keys = ["," \"name\", \"description\", \"hsnCode\", \"productCategory\", \"unitPrice\","," \"discountRate\", \"discountAmount\", \"feeRate\", \"feeAmount\","," \"quantity\", \"totalAmount\", \"taxRate\", \"taxAmount\""," ];"," keys.forEach(key => pm.environment.unset(`li_${i}_${key}`));","}","","// ===== Set Line Items =====","calculatedLineItems.forEach((li, i) => {"," Object.entries(li).forEach(([key, value]) => {"," pm.environment.set(`li_${i}_${key}`, value);"," });","});","","// ===== Set Totals =====","pm.environment.set(\"totals_totalLineAmount\", parseFloat(totalLineAmount.toFixed(2)));","pm.environment.set(\"totals_totalTax\", parseFloat(totalTax.toFixed(2)));","pm.environment.set(\"totals_grandTotal\", grandTotal);","","","// ===== Log Summary =====","console.log(`Generated invoice with ${calculatedLineItems.length} line items`);","console.log(`Total Line Amount: ${totalLineAmount.toFixed(2)}`);","console.log(`Total Tax: ${totalTax.toFixed(2)}`);","console.log(`Grand Total: ${grandTotal}`);"],"type":"text/javascript","packages":{},"requests":{},"id":"03802210-86d7-4357-9463-8f33a8b6da8d"}}],"id":"a7afe913-1cc9-4e8f-a9ec-ba290d087cee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"invoiceRef\": \"4571583738433\",\r\n \"merchantId\": \"\",\r\n \"currency\": \"NGN\",\r\n \"issueDate\": \"08-10-2025\",\r\n \"dueDate\": \"07-11-2025\",\r\n \"status\": \"issued\",\r\n \"orderReference\": \"4047610103513\",\r\n \"customer\": {\r\n \"customerId\": \"cust_009\",\r\n \"name\": \"Shoprite Nigeria\",\r\n \"email\": \"info@shoprite.com\",\r\n \"phone\": \"+2348099999999\",\r\n \"identifiers\": {\r\n \"tin\": \"24988238-0001\"\r\n },\r\n \"address\": {\r\n \"line\": \"9 Market Road\",\r\n \"city\": \"Ibadan\",\r\n \"country\": \"NG\",\r\n \"postalZone\": \"200001\"\r\n }\r\n }, // Customer Information Optional\r\n \"lineItems\": [\r\n {\r\n \"name\": \"50kg Bag of Beans\",\r\n \"description\": \"Premium beans\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n // \"hsnCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n // \"productCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"isicCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n \"serviceCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 4500,\r\n \"discountRate\": 5,\r\n \"discountAmount\": 675,\r\n \"feeRate\": 1.5,\r\n \"feeAmount\": 202.5,\r\n \"quantity\": 3,\r\n \"totalAmount\": 13027.5,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 977.06\r\n },\r\n {\r\n \"name\": \"Gallon of Vegetable Oil\",\r\n \"description\": \"Cooking oil\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n \"hsnCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n \"productCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n // \"isicCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n // \"serviceCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 12000,\r\n \"discountRate\": 12,\r\n \"discountAmount\": 2880,\r\n \"feeRate\": 2.5,\r\n \"feeAmount\": 600,\r\n \"quantity\": 2,\r\n \"totalAmount\": 21720,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 1629\r\n }\r\n ],\r\n \"totals\": {\r\n \"totalLineAmount\": 34747.5,\r\n \"totalTax\": 2606.06,\r\n \"grandTotal\": 37353.56\r\n }\r\n ,\"firsSpecific\": {\r\n \"invoiceTypeCode\": \"396\",\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\", required for APP only\r\n \"paymentStatus\": \"PENDING\",\r\n \"invoiceKind\": \"B2B\" // B2B,B2C, B2G - defaults to B2B\r\n ,\"references\": {\r\n \"orderReference\": \"order REF\", //optional\r\n \"buyerReference\": \"buyer REF\", //optional\r\n \"billingReferences\": [\r\n {\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"issueDate\": \"05-03-2026\"\r\n }\r\n ] //optional. Use if Invoice type of main invoices is a Credit note. This will capture the IRN of the invoice that you are applying a credit note on.\r\n // ,\"dispatchDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"receiptDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"originatorDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"contractDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"additionalDocumentReferences\": [\r\n // {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ] //optional\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/process","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/process

Creates an invoice on our platform and queues it for transmission to NRS. This is the primary endpoint of the integration and you will call it every time your system issues an invoice.

We return the IRN and QR string as soon as the invoice is persisted. Transmission to NRS happens asynchronously; the transmitted and delivered flags in the response tell you the current NRS notification state, which you can later refresh via Lookup Invoice or receive via webhook.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`invoiceRef`	string	Yes	Your internal invoice reference. Must be unique within your merchant account.
`merchantId`	string	Yes	Your merchant identifier on our platform.
`currency`	string	Yes	ISO 4217 currency code. Currently `NGN`.
`issueDate`	string (`DD-MM-YYYY`)	Yes	Date the invoice is issued.
`dueDate`	string (`DD-MM-YYYY`)	Yes	Date payment is due.
`status`	string	Yes	Invoice lifecycle status. Use `issued` when creating.
`orderReference`	string	No	Your order or purchase reference.
`customer`	object	No	Buyer details. See Customer object below. Omit for anonymous B2C sales if your flow allows.
`lineItems`	array	Yes	One or more invoice lines. See Line item object below.
`totals`	object	Yes	Invoice totals. See Totals object below.
`firsSpecific`	object	Yes	NRS-specific metadata. See FIRS-specific object below.

Customer object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`customerId`	string	No	Your internal identifier for this customer.
`name`	string	Yes (if `customer` sent)	Legal or trading name of the buyer.
`email`	string	No	Buyer email address.
`phone`	string	No	Buyer phone, international format (`+234...`).
`identifiers.tin`	string	Yes for B2B/B2G	Buyer's Tax Identification Number.
`address.line`	string	Yes (if `address` sent)	Street address.
`address.city`	string	Yes (if `address` sent)	City.
`address.country`	string	Yes (if `address` sent)	ISO 3166-1 alpha-2 country code (`NG`).
`address.postalZone`	string	No	Postal code.

Line item object

Field	Type	Required	Description
`name`	string	Yes	Short name of the item.
`description`	string	No	Longer description.
`sellersItemIdentification`	string	No	Your SKU or catalogue reference.
`hsnCode`	string	Conditional	Harmonised System / product code. Send this together with `productCategory` for tangible goods.
`productCategory`	string	Conditional	Product category label. Pair with `hsnCode`.
`isicCode`	string	Conditional	ISIC code for services. Send this together with `serviceCategory` for services.
`serviceCategory`	string	Conditional	Service category label. Pair with `isicCode`.
`unitPrice`	number	Yes	Price per unit, before discount/fee/tax.
`discountRate`	number	No	Discount percentage, e.g. `3` means 3%.
`discountAmount`	number	No	Discount value in invoice currency.
`feeRate`	number	No	Additional fee percentage.
`feeAmount`	number	No	Additional fee value in invoice currency.
`quantity`	number	Yes	Number of units.
`totalAmount`	number	Yes	Line total after discount and fee, before tax.
`taxCode`	string	Yes	Tax code. `STANDARD_VAT` for standard-rated Nigerian VAT.
`taxRate`	number	Yes	Tax percentage, e.g. `7.5`.
`taxAmount`	number	Yes	Tax value for the line.

Each line item must classify its subject matter using either hsnCode + productCategory (for goods) or isicCode + serviceCategory (for services). Do not send both pairs on the same line.

Totals object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`totalLineAmount`	number	Yes	Sum of all `totalAmount` values across line items (pre-tax).
`totalTax`	number	Yes	Sum of all `taxAmount` values.
`grandTotal`	number	Yes	`totalLineAmount + totalTax`.

FIRS-specific object

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`invoiceTypeCode`	string	Yes	UBL invoice type code. Use `396` for a standard Invoice Request.
`paymentStatus`	string	Yes	Initial payment status. One of `PENDING`, `PAID`, `REJECTED`. Typically `PENDING` at creation.
`invoiceKind`	string	No	`B2B`, `B2C`, or `B2G`. Defaults to `B2B`.
`references`	object	No	Related-document references. See below.

firsSpecific.references object. All fields are optional. Use billingReferences when the invoice being created is a credit note — the billing reference captures the IRN of the original invoice being credited.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`orderReference`	string	Purchase-order reference.
`buyerReference`	string	Buyer-side reference.
`billingReferences`	array of `{ irn, issueDate }`	IRN(s) of prior invoice(s) this invoice adjusts (credit-note case).
`dispatchDocumentReference`	`{ irn, issueDate }`	Reference to a dispatch / delivery document.
`receiptDocumentReference`	`{ irn, issueDate }`	Reference to a goods-receipt document.
`originatorDocumentReference`	`{ irn, issueDate }`	Reference to the originating document.
`contractDocumentReference`	`{ irn, issueDate }`	Reference to a governing contract.
`additionalDocumentReferences`	array of `{ irn, issueDate }`	Any other supporting references.

Inside these reference objects, issueDate uses DD-MM-YYYY format.

Example request

{\n    \"invoiceRef\": \"7122889588380\",\n    \"merchantId\": \"CON7B60C\",\n    \"currency\": \"NGN\",\n    \"issueDate\": \"24-04-2026\",\n    \"dueDate\": \"24-05-2026\",\n    \"status\": \"issued\",\n    \"orderReference\": \"PO-00421\",\n    \"customer\": {\n        \"customerId\": \"CUST-001\",\n        \"name\": \"Innoson Motors\",\n        \"email\": \"sales@innosonmotors.com\",\n        \"phone\": \"+2348033333333\",\n        \"identifiers\": { \"tin\": \"21919238-0001\" },\n        \"address\": {\n            \"line\": \"3 Kings Road\",\n            \"city\": \"Port Harcourt\",\n            \"country\": \"NG\",\n            \"postalZone\": \"500001\"\n        }\n    },\n    \"lineItems\": [\n        {\n            \"name\": \"Bottle of Palm Oil\",\n            \"description\": \"Palm oil\",\n            \"sellersItemIdentification\": \"PO-500ML\",\n            \"isicCode\": \"0126\",\n            \"serviceCategory\": \"Edible oil supply\",\n            \"unitPrice\": 2000,\n            \"discountRate\": 3,\n            \"discountAmount\": 240,\n            \"feeRate\": 1,\n            \"feeAmount\": 80,\n            \"quantity\": 4,\n            \"totalAmount\": 7840,\n            \"taxCode\": \"STANDARD_VAT\",\n            \"taxRate\": 7.5,\n            \"taxAmount\": 588\n        }\n    ],\n    \"totals\": {\n        \"totalLineAmount\": 7840,\n        \"totalTax\": 588,\n        \"grandTotal\": 8428\n    },\n    \"firsSpecific\": {\n        \"invoiceTypeCode\": \"396\",\n        \"paymentStatus\": \"PENDING\",\n        \"invoiceKind\": \"B2B\"\n    }\n}\n\n

Example response (200 OK)

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": {\n        \"issueDate\": \"24-04-2026\",\n        \"dueDate\": \"24-05-2026\",\n        \"syncDate\": \"24-04-2026\",\n        \"paymentStatus\": \"PENDING\",\n        \"transmitted\": false,\n        \"delivered\": false,\n        \"irn\": \"7122889588380-BBCCC154-20260424\",\n        \"qrString\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...\"\n    }\n}\n\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Response field	Description
`issueDate`, `dueDate`	Echoed from the request.
`syncDate`	Date the invoice was synchronised to our platform.
`paymentStatus`	Current payment state. `PENDING` at creation.
`transmitted`	`true` once the invoice has been transmitted to NRS.
`delivered`	`true` once NRS has confirmed receipt.
`irn`	The Invoice Reference Number — store this.
`qrString`	Base64-encoded PNG (`data:image/png;base64,...`) to render on the invoice document.

\n","urlObject":{"path":["api","v1","invoice","process"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"bf26533d-e367-4378-b04d-2b97a6df13fb","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"invoiceRef\": \"4571583738433\",\r\n \"merchantId\": \"\",\r\n \"currency\": \"NGN\",\r\n \"issueDate\": \"08-10-2025\",\r\n \"dueDate\": \"07-11-2025\",\r\n \"status\": \"issued\",\r\n \"orderReference\": \"4047610103513\",\r\n \"customer\": {\r\n \"customerId\": \"cust_009\",\r\n \"name\": \"Shoprite Nigeria\",\r\n \"email\": \"info@shoprite.com\",\r\n \"phone\": \"+2348099999999\",\r\n \"identifiers\": {\r\n \"tin\": \"24988238-0001\"\r\n },\r\n \"address\": {\r\n \"line\": \"9 Market Road\",\r\n \"city\": \"Ibadan\",\r\n \"country\": \"NG\",\r\n \"postalZone\": \"200001\"\r\n }\r\n }, // Customer Information Optional\r\n \"lineItems\": [\r\n {\r\n \"name\": \"50kg Bag of Beans\",\r\n \"description\": \"Premium beans\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n // \"hsnCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n // \"productCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"isicCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n \"serviceCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 4500,\r\n \"discountRate\": 5,\r\n \"discountAmount\": 675,\r\n \"feeRate\": 1.5,\r\n \"feeAmount\": 202.5,\r\n \"quantity\": 3,\r\n \"totalAmount\": 13027.5,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 977.06\r\n },\r\n {\r\n \"name\": \"Gallon of Vegetable Oil\",\r\n \"description\": \"Cooking oil\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n \"hsnCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n \"productCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n // \"isicCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n // \"serviceCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 12000,\r\n \"discountRate\": 12,\r\n \"discountAmount\": 2880,\r\n \"feeRate\": 2.5,\r\n \"feeAmount\": 600,\r\n \"quantity\": 2,\r\n \"totalAmount\": 21720,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 1629\r\n }\r\n ],\r\n \"totals\": {\r\n \"totalLineAmount\": 34747.5,\r\n \"totalTax\": 2606.06,\r\n \"grandTotal\": 37353.56\r\n }\r\n ,\"firsSpecific\": {\r\n \"invoiceTypeCode\": \"396\",\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\", required for APP only\r\n \"paymentStatus\": \"PENDING\",\r\n \"invoiceKind\": \"B2B\" // B2B,B2C, B2G - defaults to B2B\r\n ,\"references\": {\r\n \"orderReference\": \"order REF\", //optional\r\n \"buyerReference\": \"buyer REF\", //optional\r\n \"billingReferences\": [\r\n {\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"issueDate\": \"05-03-2026\"\r\n }\r\n ] //optional. Use if Invoice type of main invoices is a Credit note. This will capture the IRN of the invoice that you are applying a credit note on.\r\n // ,\"dispatchDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"receiptDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"originatorDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"contractDocumentReference\": {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"additionalDocumentReferences\": [\r\n // {\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ] //optional\r\n }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/process"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:30:38 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"syncDate\": \"24-04-2026\",\n \"paymentStatus\": \"PENDING\",\n \"transmitted\": false,\n \"delivered\": false,\n \"irn\": \"7122889588380-BBCCC154-20260424\",\n \"qrString\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAAD+ElEQVR4Xu3XWW4dIRCFYXbA/nfJDkh9p9pDrvyQl6SsyK3rHuBHqvGA1/2T66zXkS+vH+zl+sFeru+OnbXWPbfe9va26+nr7nV3Jgex+p36LqCwtdc+BW54TfT8GHZWva0bWzNTaH3V85yeHMXqtzgSg8uNIsudcuMbYFJ9zCbZUq8AipvGkMw/oKtEjyAfETY5iVUt4r6+fuus18mP6y9hubaL6Wltb/VcauFNakYwYVyRF3c212DKwMPqQezp4fojOIpyp1KbvJNYAlmWwoiMOtQx1CYhH8S8V+M+xK65yGCK0g5ieAyTazHNEvhKzqOGIecwkryycWgRe1p8us2L+hx20itMP2Rv02R2b0URahBLUbJ32crylUBfcXdAGMQEVlzlequCdkJwsxtPYuGSaAojxtuuZk1qYBLbLdLop4uZbUhsp7Er377kG1IxNqqf37t+AisjU46ZqRhvxqeH8nqyfghjvg+gVceOlljXLCcmsW2/OLG7zGZ61LlPoB9SM4NVru26JG9pliJiOQFSEnOYLB8elOFbxjX121S2lkEsGrP40aHNwpq7/l1sL6ewmqug2m0rtMfzxi8xr/f3LExgbvYKTcKDsjt9nSh/Sv0IhvEpthooze09v/cymMD0hq7d1KZwa5YiyMJ01Bh2nUFtuj3ekU57K0/AIFYRbA/qYSfrEwHzyXTGp7AIzdXLvIgqr7hQg7kNYpfVT5KFtztHX/Mk28ocJvUeptNA0eWjXl8rZADr7LY7y3YmxKpBab5VyAjG7DRJ8KMuiy8vyGHcGsPo3BZheQcoxdUaaPhxYQS7zlGX2Eh0tc4VVRVpUa4xrAK6I8tkT29Xu+Sr3oxBpjABTZTd9tPAzgdpatmfww5dDvSk3iQhFPbu8TGMCxuqBHu30EPmpf6zp/8cU335D0w9JvtiTAdNKYtB7OZIJ+s2Wch5hKerYBJjqO6Vc8MB6qkSev8Yw0rtWmpami2U9KqC5D/pH8T2ozEJqjeWb0GPB3OYntXNqGWu+mVb6GZ0EEtE7WCsF1sVoI1SlZ+3tgGM0U51W7b7OCDrrTwKdA6jwo/iwcuHhHSnAsR8EqOCqU1m7xxS4kW6mieD2CHEl+3dy0n91dFL6qnjFGZC8R1wwms4LK1WC2PYgch50+1BYkse32VwBKPQj8bcZH+1Y5gkfhLzLMtV4onCpEDl3oYXL6ewGH0YLphbF0Nujsz5GMT8GqmWsWOcnPO2x+1TzBim/HRHzVQxdkmayryID2MyH0eu7Vapdqjdp7FYupN/7dM16vHi6b/GYrZp39t3y49u/uTCCKZldgczUsh0NWD5fcpgCPuD6wd7uX6wl+t/wH4BpMo9Tas89dAAAAAASUVORK5CYII=\"\n }\n}"}],"_postman_id":"a7afe913-1cc9-4e8f-a9ec-ba290d087cee"},{"name":"Lookup Invoice","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"bfdc1aff-53c7-47c3-a836-96d96d0e6c38"}}],"id":"3240583b-ad24-4e92-870b-e69077626bfb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\"\r\n ,\"invoiceReference\": \"4571583738433\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/details","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/details

Retrieves the current state of an invoice previously created via Process Invoice. Use this to poll transmission status, fetch the full invoice record, or retrieve the QR string if your system did not persist it at creation time.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`merchantId`	string	Yes	Your merchant identifier.
`irn`	string	Either this or `invoiceReference`	The IRN returned when the invoice was created.
`invoiceReference`	string	Either this or `irn`	Your original `invoiceRef` from Process Invoice.

If both are supplied, irn takes precedence.

Example response (200 OK)

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": {\n        \"invoiceRef\": \"7122889588380\",\n        \"merchantId\": \"CON7B60C\",\n        \"currency\": \"NGN\",\n        \"issueDate\": \"24-04-2026\",\n        \"dueDate\": \"24-05-2026\",\n        \"orderReference\": \"order REF\",\n        \"invoiceDirection\": \"SENT\",\n        \"customer\": { \"...\": \"as submitted\" },\n        \"lineItems\": [ \"...\": \"as submitted, plus unitQuantity and unitPriceDescription\" ],\n        \"totals\": { \"totalLineAmount\": 17040, \"totalTax\": 1278, \"grandTotal\": 18318 },\n        \"firsSpecific\": {\n            \"firsBusinessId\": \"1736d4f4-c154-4fca-85b8-805141a03093\",\n            \"serviceId\": \"BBCCC154\",\n            \"invoiceTypeCode\": \"Invoice Request\",\n            \"paymentStatus\": \"PENDING\",\n            \"irn\": \"7122889588380-BBCCC154-20260424\",\n            \"invoiceKind\": \"B2B\",\n            \"accountingSupplierParty\": {\n                \"name\": \"Toks Bread\",\n                \"tin\": \"02989-0001\",\n                \"email\": \"toks@toksbread.com\",\n                \"telephone\": \"+2348080099928\",\n                \"postalAddress\": { \"...\": \"your merchant address\" }\n            },\n            \"taxCurrencyCode\": \"NGN\",\n            \"invoiceStatus\": {\n                \"issueDate\": \"24-04-2026\",\n                \"dueDate\": \"24-05-2026\",\n                \"syncDate\": \"24-04-2026\",\n                \"paymentStatus\": \"PENDING\",\n                \"transmitted\": false,\n                \"delivered\": false,\n                \"irn\": \"7122889588380-BBCCC154-20260424\"\n            },\n            \"firsNotificationStatus\": {\n                \"status\": \"PENDING\",\n                \"message\": \"Notification to FIRS is currently pending\"\n            }\n        },\n        \"qrString\": \"data:image/png;base64,...\",\n        \"merchantLogo\": \"data:image/png;base64,...\"\n    }\n}\n\n

Notable fields in the response:

invoiceDirection — SENT for invoices you have issued. (Inbound invoices sent to you would show a different direction in account-receivable flows.)
\n
firsSpecific.firsNotificationStatus — the current status of the notification we send to NRS. Expect transitions such as PENDING → TRANSMITTED → DELIVERED, or FAILED with a descriptive message if NRS rejected the invoice.
\n
merchantLogo — your merchant logo that we include on generated invoice PDFs. Managed via Update Merchant Details.
\n

\n","urlObject":{"path":["api","v1","invoice","details"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"404758bb-6605-4065-949f-4af7bbefd0b8","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\"\r\n ,\"invoiceReference\": \"4571583738433\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:32:09 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"invoiceRef\": \"7122889588380\",\n \"merchantId\": \"CON7B60C\",\n \"currency\": \"NGN\",\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"orderReference\": \"order REF\",\n \"invoiceDirection\": \"SENT\",\n \"customer\": {\n \"name\": \"Innoson Motors\",\n \"email\": \"sales@innosonmotors.com\",\n \"phone\": \"+2348033333333\",\n \"identifiers\": {\n \"tin\": \"21919238-0001\"\n },\n \"address\": {\n \"line\": \"3 Kings Road\",\n \"city\": \"Port Harcourt\",\n \"country\": \"NG\",\n \"postalZone\": \"500001\"\n }\n },\n \"lineItems\": [\n {\n \"name\": \"Bottle of Palm Oil\",\n \"description\": \"Palm oil\",\n \"sellersItemIdentification\": \"sellersItemIdentification\",\n \"unitPrice\": 2000,\n \"unitQuantity\": 1,\n \"unitPriceDescription\": \"NGN2000 per 1\",\n \"discountRate\": 3,\n \"discountAmount\": 240,\n \"feeRate\": 1,\n \"feeAmount\": 80,\n \"quantity\": 4,\n \"totalAmount\": 7840,\n \"taxCode\": \"STANDARD_VAT\",\n \"taxRate\": 7.5,\n \"taxAmount\": 588\n },\n {\n \"name\": \"Carton of Juice\",\n \"description\": \"Fruit juice\",\n \"sellersItemIdentification\": \"sellersItemIdentification\",\n \"hsnCode\": \"CC-010\",\n \"productCategory\": \"Beverages\",\n \"unitPrice\": 10000,\n \"unitQuantity\": 1,\n \"unitPriceDescription\": \"NGN10000 per 1\",\n \"discountRate\": 10,\n \"discountAmount\": 1000,\n \"feeRate\": 2,\n \"feeAmount\": 200,\n \"quantity\": 1,\n \"totalAmount\": 9200,\n \"taxCode\": \"STANDARD_VAT\",\n \"taxRate\": 7.5,\n \"taxAmount\": 690\n }\n ],\n \"totals\": {\n \"totalLineAmount\": 17040,\n \"totalTax\": 1278,\n \"grandTotal\": 18318\n },\n \"firsSpecific\": {\n \"firsBusinessId\": \"1736d4f4-c154-4fca-85b8-805141a03093\",\n \"serviceId\": \"BBCCC154\",\n \"invoiceTypeCode\": \"Invoice Request\",\n \"paymentStatus\": \"PENDING\",\n \"irn\": \"7122889588380-BBCCC154-20260424\",\n \"invoiceKind\": \"B2B\",\n \"dates\": {},\n \"references\": {\n \"orderReference\": \"order REF\",\n \"buyerReference\": \"buyer REF\",\n \"billingReferences\": [\n {\n \"irn\": \"7122889588380-SF19KD-20260424\",\n \"issueDate\": \"05-03-2026\"\n }\n ]\n },\n \"accountingSupplierParty\": {\n \"name\": \"Toks Bread\",\n \"tin\": \"02989-0001\",\n \"email\": \"toks@toksbread.com\",\n \"telephone\": \"+2348080099928\",\n \"postalAddress\": {\n \"line\": \"B22 road sandfill\",\n \"city\": \"LAGOS\",\n \"country\": \"NG\",\n \"postalZone\": \"101233\"\n }\n },\n \"taxCurrencyCode\": \"NGN\",\n \"invoiceStatus\": {\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"syncDate\": \"24-04-2026\",\n \"paymentStatus\": \"PENDING\",\n \"transmitted\": false,\n \"delivered\": false,\n \"irn\": \"7122889588380-BBCCC154-20260424\"\n },\n \"firsNotificationStatus\": {\n \"status\": \"PENDING\",\n \"message\": \"Notification to FIRS is currently pending\"\n }\n },\n \"qrString\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAAD+ElEQVR4Xu3XWW4dIRCFYXbA/nfJDkh9p9pDrvyQl6SsyK3rHuBHqvGA1/2T66zXkS+vH+zl+sFeru+OnbXWPbfe9va26+nr7nV3Jgex+p36LqCwtdc+BW54TfT8GHZWva0bWzNTaH3V85yeHMXqtzgSg8uNIsudcuMbYFJ9zCbZUq8AipvGkMw/oKtEjyAfETY5iVUt4r6+fuus18mP6y9hubaL6Wltb/VcauFNakYwYVyRF3c212DKwMPqQezp4fojOIpyp1KbvJNYAlmWwoiMOtQx1CYhH8S8V+M+xK65yGCK0g5ieAyTazHNEvhKzqOGIecwkryycWgRe1p8us2L+hx20itMP2Rv02R2b0URahBLUbJ32crylUBfcXdAGMQEVlzlequCdkJwsxtPYuGSaAojxtuuZk1qYBLbLdLop4uZbUhsp7Er377kG1IxNqqf37t+AisjU46ZqRhvxqeH8nqyfghjvg+gVceOlljXLCcmsW2/OLG7zGZ61LlPoB9SM4NVru26JG9pliJiOQFSEnOYLB8elOFbxjX121S2lkEsGrP40aHNwpq7/l1sL6ewmqug2m0rtMfzxi8xr/f3LExgbvYKTcKDsjt9nSh/Sv0IhvEpthooze09v/cymMD0hq7d1KZwa5YiyMJ01Bh2nUFtuj3ekU57K0/AIFYRbA/qYSfrEwHzyXTGp7AIzdXLvIgqr7hQg7kNYpfVT5KFtztHX/Mk28ocJvUeptNA0eWjXl8rZADr7LY7y3YmxKpBab5VyAjG7DRJ8KMuiy8vyGHcGsPo3BZheQcoxdUaaPhxYQS7zlGX2Eh0tc4VVRVpUa4xrAK6I8tkT29Xu+Sr3oxBpjABTZTd9tPAzgdpatmfww5dDvSk3iQhFPbu8TGMCxuqBHu30EPmpf6zp/8cU335D0w9JvtiTAdNKYtB7OZIJ+s2Wch5hKerYBJjqO6Vc8MB6qkSev8Yw0rtWmpami2U9KqC5D/pH8T2ozEJqjeWb0GPB3OYntXNqGWu+mVb6GZ0EEtE7WCsF1sVoI1SlZ+3tgGM0U51W7b7OCDrrTwKdA6jwo/iwcuHhHSnAsR8EqOCqU1m7xxS4kW6mieD2CHEl+3dy0n91dFL6qnjFGZC8R1wwms4LK1WC2PYgch50+1BYkse32VwBKPQj8bcZH+1Y5gkfhLzLMtV4onCpEDl3oYXL6ewGH0YLphbF0Nujsz5GMT8GqmWsWOcnPO2x+1TzBim/HRHzVQxdkmayryID2MyH0eu7Vapdqjdp7FYupN/7dM16vHi6b/GYrZp39t3y49u/uTCCKZldgczUsh0NWD5fcpgCPuD6wd7uX6wl+t/wH4BpMo9Tas89dAAAAAASUVORK5CYII=\",\n \"merchantLogo\": \"data:image/png;base64,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\"\n }\n}"}],"_postman_id":"3240583b-ad24-4e92-870b-e69077626bfb"},{"name":"Payment Notification","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"398060d2-8630-42f2-ad85-49f265c5fec8"}}],"id":"963f00f2-d4c2-4cc9-9245-40e717fb4339","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PAID\" // PENDING, PAID, REJECTED\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/payment/notify","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/payment/notify

Notify the platform (and through it, NRS) that the payment status of an invoice has changed. Call this when a customer pays, or when a payment is rejected/cancelled.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`merchantId`	string	Yes	Your merchant identifier.
`irn`	string	Yes	IRN of the invoice whose payment status is changing.
`paymentStatus`	string	Yes	New status. One of `PENDING`, `PAID`, `REJECTED`.

Example response (200 OK)

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": null\n}\n\n

\n","urlObject":{"path":["api","v1","invoice","payment","notify"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"632384c5-26e5-45d2-b7e6-22fe690e45f9","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PAID\" // PENDING, PAID, REJECTED\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/payment/notify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:35:30 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": null\n}"}],"_postman_id":"963f00f2-d4c2-4cc9-9245-40e717fb4339"},{"name":"Update Merchant Details","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"193b1ed4-0fac-42c6-82ba-3872a2897fea"}}],"id":"2ebec603-2322-4b76-976e-77fd19c0396a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"CON7B60D\",\r\n \"name\": \"Toks Bread\",\r\n \"firsBusinessId\": \"fdadoa-122322-sadasdsa\",\r\n \"firsServiceId\": \"SF19KD\",\r\n \"tin\": \"02989-0001\",\r\n \"email\": \"toks@toksbread.com\",\r\n \"phone\": \"+2348080099928\",\r\n \"webhookUrl\": \"webhookUrl_29ce14037de4\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/merchant/update","description":"

`PUT {{baseUrl_ApiGateway}}/api/v1/invoice/merchant/update`\n \nUpdate the profile details we hold for your merchant account — things that appear on your generated invoices (name, contact details) or that affect routing (NRS identifiers, webhook URL). This is typically called rarely, when your details genuinely change.\n \nRequest body\n \n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `merchantId` | string | Yes | Your merchant identifier. Cannot be changed. |\n| `name` | string | No | Legal/trading name. |\n| `firsBusinessId` | string | No | Your FIRS/NRS business identifier. |\n| `firsServiceId` | string | No | Your FIRS/NRS service identifier. |\n| `tin` | string | No | Your Tax Identification Number. |\n| `email` | string | No | Primary contact email. |\n| `phone` | string | No | Primary contact phone. |\n| `webhookUrl` | string | No | URL we POST invoice status updates to. |\n \nOmitted fields are left unchanged.\n \nExample response (200 OK)\n \njson { \"status\": \"00\", \"message\": \"Approved or completed successfully\", \"data\": { \"id\": 10, \"name\": \"Toks Bread\", \"merchantId\": \"CON7B60C\", \"firsBusinessId\": \"fdadoa-122322-sadasdsa\", \"firsServiceId\": \"SF19KD\", \"tin\": \"02989-0001\", \"email\": \"toks@toksbread.com\", \"phone\": \"+2348080099928\", \"serviceMode\": \"BOTH\", \"webhookUrl\": \"webhookUrl_29ce14037de4\", \"logoUrl\": \"https://res.cloudinary.com/remita/...\", \"createdDate\": \"2025-11-26T10:34:29Z\", \"updatedDate\": \"2026-04-24T10:35:55Z\", \"aggregators\": null } } \n

\n","urlObject":{"path":["api","v1","invoice","merchant","update"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"d9c98f42-0357-4df8-be72-5a26b3a715bc","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"CON7B60D\",\r\n \"name\": \"Toks Bread\",\r\n \"firsBusinessId\": \"fdadoa-122322-sadasdsa\",\r\n \"firsServiceId\": \"SF19KD\",\r\n \"tin\": \"02989-0001\",\r\n \"email\": \"toks@toksbread.com\",\r\n \"phone\": \"+2348080099928\",\r\n \"webhookUrl\": \"webhookUrl_29ce14037de4\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/merchant/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:35:55 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"id\": 10,\n \"name\": \"Toks Bread\",\n \"merchantId\": \"CON7B60C\",\n \"firsBusinessId\": \"fdadoa-122322-sadasdsa\",\n \"firsServiceId\": \"SF19KD\",\n \"tin\": \"02989-0001\",\n \"email\": \"toks@toksbread.com\",\n \"phone\": \"+2348080099928\",\n \"serviceMode\": \"BOTH\",\n \"webhookUrl\": \"webhookUrl_29ce14037de4\",\n \"logoUrl\": \"https://res.cloudinary.com/remita/raw/upload/v1764153272/mroatonaxksbivslkgc4[image/png\",\n \"createdDate\": \"2025-11-26T10:34:29Z\",\n \"updatedDate\": \"2026-04-24T10:35:55Z\",\n \"aggregators\": null\n }\n}"}],"_postman_id":"2ebec603-2322-4b76-976e-77fd19c0396a"},{"name":"Update Service Mode","event":[{"listen":"prerequest","script":{"id":"fffde4e9-96d1-4ebd-b654-8c5bc2abca8f","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"9b8882e8-141c-4ee7-9974-d79c12cc9724","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"AGG123457\",\r\n \"serviceMode\": \"BOTH\" //APP, SI, BOTH, NONE\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/service-mode/update","description":"

PUT {{baseUrl_ApiGateway}}/api/v1/invoice/service-mode/update

Change the service mode of a merchant account.

\n","urlObject":{"path":["api","v1","invoice","service-mode","update"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"9b8882e8-141c-4ee7-9974-d79c12cc9724"}],"id":"97aaf5b3-39fa-4d54-b170-3c10b8a5250d","description":"

Use the endpoints in this folder when you are the business issuing invoices.

\n","_postman_id":"97aaf5b3-39fa-4d54-b170-3c10b8a5250d"},{"name":"Aggregator","item":[{"name":"Link Merchant","event":[{"listen":"prerequest","script":{"id":"11206a7e-38e9-4097-a4c1-8d6f6cffd3a5","exec":["function randomIntFromInterval(min, max) { // min and max included "," return Math.floor(Math.random() * (max - min + 1) + min)","}","","let append = randomIntFromInterval(10000000, 99999999);","let tin1 = randomIntFromInterval(10000000, 99999999);","let tin2 = randomIntFromInterval(1000,9999);","let tin = tin1.toString() + \"-\" + tin2.toString();","let merchantId = \"C000\" + tin2;","let phoneNumber = \"+23480\" + append;","","let firstName = pm.variables.replaceIn(\"Runolfsdottir\");","let lastName = pm.variables.replaceIn(\"Stracke\");","let userName = firstName+\"_\"+lastName;","let email = (userName + \"_toks@mailinator.com\").toLowerCase();","","let businessName = pm.variables.replaceIn(\"Bednar LLC\");","let busDomain = businessName.split(' ')[0];","let sanitizedDomain = busDomain.replace(/[^a-zA-Z0-9]/g, \"\");","let businessEmail = (\"info@\" + sanitizedDomain + \".com\").toLowerCase();","","const nrsServiceId = () => {"," const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';"," return Array.from({length: 8}, () => chars[Math.floor(Math.random() * chars.length)]).join('');","};","","let serviceMode = 'BOTH'; //SI, APP, BOTH, NONE","","pm.environment.set(\"businessName\", businessName);","pm.environment.set(\"businessEmail\", businessEmail);","pm.environment.set(\"tin\", tin);","pm.environment.set(\"merchantId_Register\", merchantId);","pm.environment.set(\"userName\", userName);","pm.environment.set(\"userName_Business\", email);","pm.environment.set(\"phoneNumber\",phoneNumber);","pm.environment.set(\"nrsServiceId\", nrsServiceId());","pm.environment.set(\"serviceMode\", serviceMode);","",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"4c5db04e-d2c2-4aaa-92b7-91ba8803b97e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"type":"text","key":"aggregatorId","value":"{{aggregator_Register}}"},{"type":"file","key":"merchant.merchantLogo","src":["postman-cloud:///1f0e7e89-3e9f-4e20-b7d8-8bdc5beef609","/Users/tokunboomonubi/Downloads/Frame 1618876271.png"]},{"type":"text","key":"merchant.name","value":"{{businessName}}"},{"type":"text","key":"merchant.merchantId","value":"{{merchantId_Register}}"},{"type":"text","key":"merchant.firsBusinessId","value":"afceaa99-7a82-432a-8483-f71c5a46415a"},{"type":"text","key":"merchant.firsServiceId","value":"{{nrsServiceId}}"},{"type":"text","key":"merchant.tin","value":"{{tin}}"},{"type":"text","key":"merchant.email","value":"{{businessEmail}}"},{"type":"text","key":"merchant.phone","value":"{{phoneNumber}}"},{"type":"text","key":"merchant.webhookUrl","value":"webhook.com"},{"type":"text","key":"merchant.addresses[0].line","value":"Line"},{"type":"text","key":"merchant.addresses[0].city","value":"City"},{"type":"text","key":"merchant.addresses[0].postalZone","value":"Postal Zone"},{"type":"text","key":"merchant.addresses[0].country","value":"NGN"},{"key":"merchant.serviceMode","value":"BOTH","type":"text","uuid":"5fe99236-a573-419e-96fd-8fc5a65f1e1b"}]},"url":"{{baseUrl_Invoice}}/api/v1/remita/firs/aggregator/link-merchants","description":"

POST {{baseUrl_Invoice}}/api/v1/remita/firs/aggregator/link-merchants

Register a merchant under your aggregator account. After this call succeeds, you may Process Invoice, Lookup Invoice, notify payments, and Update Merchant Details for this merchant.

This is the only endpoint that uses baseUrl_Invoice and the only one that uses multipart/form-data (because it accepts a logo file).

Form fields

Field	Type	Required	Description
`aggregatorId`	text	Yes	Your aggregator identifier on our platform.
`merchant.merchantLogo`	file	No	Logo image file. Rendered on generated invoice PDFs for this merchant.
`merchant.name`	text	Yes	Merchant's legal/trading name.
`merchant.merchantId`	text	Yes	Identifier you wish to assign to this merchant.
`merchant.firsBusinessId`	text	Yes	Merchant's FIRS/NRS business identifier (UUID).
`merchant.firsServiceId`	text	Yes	Merchant's FIRS/NRS service identifier.
`merchant.tin`	text	Yes	Merchant's Tax Identification Number.
`merchant.email`	text	Yes	Primary contact email.
`merchant.phone`	text	Yes	Primary contact phone, international format.
`merchant.webhookUrl`	text	No	URL where we POST invoice status updates for this merchant.
`merchant.addresses[0].line`	text	Yes	Street address line.
`merchant.addresses[0].city`	text	Yes	City.
`merchant.addresses[0].postalZone`	text	No	Postal code.
`merchant.addresses[0].country`	text	Yes	ISO 3166-1 alpha-2 country code.
`merchant.serviceMode`	text	Yes	Service mode for this merchant. `APP`, `SI`, `BOTH`, or `NONE`.

The addresses field is an array — you can supply more than one address by adding fields with index [1], [2], etc.

Example (cURL)

curl --location '{{baseUrl_Invoice}}/api/v1/remita/firs/aggregator/link-merchants' \\\n  --header 'secretKey: your-secret-key' \\\n  --form 'aggregatorId=\"AGG123456\"' \\\n  --form 'merchant.merchantLogo=@\"/path/to/logo.png\"' \\\n  --form 'merchant.name=\"Test Merchant\"' \\\n  --form 'merchant.merchantId=\"FERA2E4C\"' \\\n  --form 'merchant.firsBusinessId=\"6dj03c76-1d83-4a39-a4de-51bd70547aef\"' \\\n  --form 'merchant.firsServiceId=\"94ND90NR\"' \\\n  --form 'merchant.tin=\"TIN-0099990001\"' \\\n  --form 'merchant.email=\"merchant@email.com\"' \\\n  --form 'merchant.phone=\"+2341234567890\"' \\\n  --form 'merchant.webhookUrl=\"https://example.com/webhooks/nrs\"' \\\n  --form 'merchant.addresses[0].line=\"Line\"' \\\n  --form 'merchant.addresses[0].city=\"City\"' \\\n  --form 'merchant.addresses[0].postalZone=\"Postal Zone\"' \\\n  --form 'merchant.addresses[0].country=\"NG\"' \\\n  --form 'merchant.serviceMode=\"BOTH\"'\n\n

Example response (200 OK)

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": null\n}\n\n

\n","urlObject":{"path":["api","v1","remita","firs","aggregator","link-merchants"],"host":["{{baseUrl_Invoice}}"],"query":[],"variable":[]}},"response":[{"id":"4f9eaa59-0fe4-415e-9bea-5b6b601bbac8","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"type":"text","key":"aggregatorId","value":"{{aggregator_Register}}"},{"type":"file","key":"merchant.merchantLogo","src":["postman-cloud:///1f0e7e89-3e9f-4e20-b7d8-8bdc5beef609","/Users/tokunboomonubi/Downloads/Frame 1618876271.png"]},{"type":"text","key":"merchant.name","value":"{{businessName}}"},{"type":"text","key":"merchant.merchantId","value":"{{merchantId_Register}}"},{"type":"text","key":"merchant.firsBusinessId","value":"9ad8fd31-fd59-48c6-8f41-e85d6ad9b2dd"},{"type":"text","key":"merchant.firsServiceId","value":"{{nrsServiceId}}"},{"type":"text","key":"merchant.tin","value":"{{tin}}"},{"type":"text","key":"merchant.email","value":"{{businessEmail}}"},{"type":"text","key":"merchant.phone","value":"{{phoneNumber}}"},{"type":"text","key":"merchant.webhookUrl","value":"webhook.com"},{"type":"text","key":"merchant.addresses[0].line","value":"Line"},{"type":"text","key":"merchant.addresses[0].city","value":"City"},{"type":"text","key":"merchant.addresses[0].postalZone","value":"Postal Zone"},{"type":"text","key":"merchant.addresses[0].country","value":"NGN"},{"key":"merchant.serviceMode","value":"BOTH","type":"text","uuid":"5fe99236-a573-419e-96fd-8fc5a65f1e1b"}]},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/merchants/link"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:37:38 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": null\n}"}],"_postman_id":"4c5db04e-d2c2-4aaa-92b7-91ba8803b97e"},{"name":"Process Invoice","event":[{"listen":"prerequest","script":{"exec":["// ===== Prepare Request Body =====","let now = new Date();","","","// ===== Helper Function for Date Formatting =====","function formatDate(date) {"," const dd = String(date.getDate()).padStart(2, '0');"," const mm = String(date.getMonth() + 1).padStart(2, '0');"," const yyyy = date.getFullYear();"," return `${dd}-${mm}-${yyyy}`; // For display (dd-mm-yyyy)","}","","function formatCompactDate(date) {"," const dd = String(date.getDate()).padStart(2, '0');"," const mm = String(date.getMonth() + 1).padStart(2, '0');"," const yyyy = date.getFullYear();"," return `${yyyy}${mm}${dd}`; // For identifiers (yyyymmdd)","}","","// ===== Dates & Time =====","let issueDate = formatDate(now); // dd-mm-yyyy","let dueDateObj = new Date(now);","dueDateObj.setDate(dueDateObj.getDate() + 30);","let dueDate = formatDate(dueDateObj); // dd-mm-yyyy","let issueTime = now.toTimeString().slice(0, 8); // HH:mm:ss","","// ===== Invoice Identifiers =====","const InvoiceNo = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","const purchaseOrder = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","const customerRefSeller = Math.floor(Math.random() * 9e11 + 1e11).toString() + Math.floor(Math.random() * 10).toString();","","let formattedDate = formatCompactDate(now); // yyyymmdd","","let main_MerchantId = pm.environment.get(\"merchantId_Register\");","// let main_MerchantId = \"MERA2E4C\";","","// let businessId = '252cd495-db2c-4cfc-8a46-f998ee4c70e6';","// let firsServiceId = 'null';","// let businessId = pm.environment.get(\"firsBusinessId\");","// let firsServiceId = pm.environment.get(\"firsServiceId\");","let businessId = pm.environment.get(\"businessId_MainTest\");","let firsServiceId = pm.environment.get(\"firsServiceId_MainTest\");","","let buyerIrn = InvoiceNo + '-' + firsServiceId + '-' + formattedDate;","let sellerIrn = InvoiceNo + '-' + firsServiceId + '-' + formattedDate;","","// ===== Sample Customers =====","const customers = ["," {"," customerId: \"cust_001\","," name: \"Zenith Bank Plc\","," email: \"contact@zenithbank.com\","," phone: \"+2348011111111\","," identifiers: { tin: \"29114238-0001\" },"," address: { line: \"1 Main Street\", city: \"Lagos\", country: \"NG\", postalZone: \"100001\" }"," },"," {"," customerId: \"cust_002\","," name: \"Dangote Group\","," email: \"info@dangote.com\","," phone: \"+2348022222222\","," identifiers: { tin: \"99234238-0001\" },"," address: { line: \"2 Broad Street\", city: \"Abuja\", country: \"NG\", postalZone: \"900001\" }"," },"," {"," customerId: \"cust_003\","," name: \"Innoson Motors\","," email: \"sales@innosonmotors.com\","," phone: \"+2348033333333\","," identifiers: { tin: \"21919238-0001\" },"," address: { line: \"3 Kings Road\", city: \"Port Harcourt\", country: \"NG\", postalZone: \"500001\" }"," },"," {"," customerId: \"cust_004\","," name: \"Nigerian Breweries Plc\","," email: \"support@nbplc.com\","," phone: \"+2348044444444\","," identifiers: { tin: \"29000238-0001\" },"," address: { line: \"4 Queens Drive\", city: \"Enugu\", country: \"NG\", postalZone: \"400001\" }"," },"," {"," customerId: \"cust_005\","," name: \"Jumia Nigeria\","," email: \"hello@jumia.com\","," phone: \"+2348055555555\","," identifiers: { tin: \"29388238-0001\" },"," address: { line: \"5 Unity Road\", city: \"Kano\", country: \"NG\", postalZone: \"700001\" }"," },"," {"," customerId: \"cust_006\","," name: \"Airtel Nigeria\","," email: \"care@airtel.com\","," phone: \"+2348066666666\","," identifiers: { tin: \"29499238-0001\" },"," address: { line: \"6 Government House\", city: \"Awka\", country: \"NG\", postalZone: \"420001\" }"," },"," {"," customerId: \"cust_007\","," name: \"GTBank Plc\","," email: \"support@gtbank.com\","," phone: \"+2348077777777\","," identifiers: { tin: \"11188238-0001\" },"," address: { line: \"7 Independence Avenue\", city: \"Kaduna\", country: \"NG\", postalZone: \"800001\" }"," },"," {"," customerId: \"cust_008\","," name: \"Access Bank Plc\","," email: \"customerservice@accessbank.com\","," phone: \"+2348088888888\","," identifiers: { tin: \"29388993-0001\" },"," address: { line: \"8 Old Road\", city: \"Owerri\", country: \"NG\", postalZone: \"460001\" }"," },"," {"," customerId: \"cust_009\","," name: \"Shoprite Nigeria\","," email: \"info@shoprite.com\","," phone: \"+2348099999999\","," identifiers: { tin: \"24988238-0001\" },"," address: { line: \"9 Market Road\", city: \"Ibadan\", country: \"NG\", postalZone: \"200001\" }"," },"," {"," customerId: \"cust_010\","," name: \"Konga Online Shopping Ltd\","," email: \"support@konga.com\","," phone: \"+2348010101010\","," identifiers: { tin: \"29320038-0001\" },"," address: { line: \"10 Ikoyi Crescent\", city: \"Lagos\", country: \"NG\", postalZone: \"101001\" }"," }","];","","// ===== Sample Line Items =====","const lineItemsList = ["," { name: \"50kg Bag of Rice\", description: \"Premium long-grain rice\", hsnCode: \"CC-001\", productCategory: \"Food and Beverages\", unitPrice: 5000, discountRate: 10, feeRate: 2, taxRate: 7.5 },"," { name: \"50kg Bag of Beans\", description: \"Premium beans\", hsnCode: \"CC-002\", productCategory: \"Food and Beverages\", unitPrice: 4500, discountRate: 5, feeRate: 1.5, taxRate: 7.5 },"," { name: \"Carton of Indomie\", description: \"Instant noodles\", hsnCode: \"CC-003\", productCategory: \"Food\", unitPrice: 3500, discountRate: 8, feeRate: 2, taxRate: 7.5 },"," { name: \"Gallon of Vegetable Oil\", description: \"Cooking oil\", hsnCode: \"CC-004\", productCategory: \"Food\", unitPrice: 12000, discountRate: 12, feeRate: 2.5, taxRate: 7.5 },"," { name: \"Bag of Garri\", description: \"Ijebu Garri\", hsnCode: \"CC-005\", productCategory: \"Food\", unitPrice: 3000, discountRate: 7, feeRate: 1, taxRate: 7.5 },"," { name: \"Carton of Milk\", description: \"Powdered milk\", hsnCode: \"CC-006\", productCategory: \"Beverages\", unitPrice: 8000, discountRate: 10, feeRate: 2, taxRate: 7.5 },"," { name: \"Bottle of Palm Oil\", description: \"Palm oil\", hsnCode: \"CC-007\", productCategory: \"Food\", unitPrice: 2000, discountRate: 3, feeRate: 1, taxRate: 7.5 },"," { name: \"Bag of Sugar\", description: \"Refined sugar\", hsnCode: \"CC-008\", productCategory: \"Food\", unitPrice: 4000, discountRate: 6, feeRate: 1.5, taxRate: 7.5 },"," { name: \"Bag of Flour\", description: \"Baking flour\", hsnCode: \"CC-009\", productCategory: \"Food\", unitPrice: 6000, discountRate: 9, feeRate: 2, taxRate: 7.5 },"," { name: \"Carton of Juice\", description: \"Fruit juice\", hsnCode: \"CC-010\", productCategory: \"Beverages\", unitPrice: 10000, discountRate: 10, feeRate: 2, taxRate: 7.5 }","];","","// ===== Random Customer & Line Items =====","const customer = customers[Math.floor(Math.random() * customers.length)];","const shuffledItems = lineItemsList.sort(() => 0.5 - Math.random()).slice(0, 2); // always 2 line items","","// ===== Calculate Totals =====","let totalLineAmount = 0;","let totalTax = 0;","let calculatedLineItems = [];","","shuffledItems.forEach(item => {"," const quantity = Math.floor(Math.random() * 5) + 1; // random 1-5"," const lineTotal = item.unitPrice * quantity;"," const discountAmount = parseFloat((lineTotal * (item.discountRate / 100)).toFixed(2));"," const feeAmount = parseFloat((lineTotal * (item.feeRate / 100)).toFixed(2));"," const taxableAmount = parseFloat((lineTotal + feeAmount - discountAmount).toFixed(2)); "," const taxAmount = parseFloat((taxableAmount * (item.taxRate / 100)).toFixed(2));"," const totalAmount = taxableAmount; "," "," totalLineAmount += taxableAmount;"," totalTax += taxAmount;",""," calculatedLineItems.push({"," name: item.name,"," description: item.description,"," sellersItemIdentification: \"sellersItemIdentification\","," hsnCode: item.hsnCode,"," productCategory: item.productCategory,"," unitPrice: item.unitPrice,"," discountRate: item.discountRate,"," discountAmount,"," feeRate: item.feeRate,"," feeAmount,"," quantity,"," totalAmount,"," taxCode: \"STANDARD_VAT\","," taxRate: item.taxRate,"," taxAmount"," });","});","","const grandTotal = parseFloat((totalLineAmount + totalTax).toFixed(2));","","pm.environment.set(\"main_MerchantId\",main_MerchantId);","pm.environment.set(\"tin_MainTest\",\"5582780001\");","pm.environment.set(\"businessId_MainTest\",\"1736d4f4-c154-4fca-85b8-805141a03093\");","pm.environment.set(\"firsServiceId_MainTest\",\"BBCCC154\");","pm.environment.set(\"tin_MainTest\",\"5582780001\");","","// ===== Set Environment Variables =====","pm.environment.set(\"issueDate\", issueDate);","pm.environment.set(\"dueDate\", dueDate);","pm.environment.set(\"issueTime\", issueTime);","pm.environment.set(\"buyerIrn\", buyerIrn);","pm.environment.set(\"sellerIrn\", sellerIrn);","pm.environment.set(\"InvoiceNo\", InvoiceNo);","pm.environment.set(\"purchaseOrder\", purchaseOrder);","","// ===== Customer Variables =====","pm.environment.set(\"cust_customerId\", customer.customerId);","pm.environment.set(\"cust_name\", customer.name);","pm.environment.set(\"cust_email\", customer.email);","pm.environment.set(\"cust_phone\", customer.phone);","pm.environment.set(\"cust_tin\", customer.identifiers.tin);","pm.environment.set(\"cust_address_line\", customer.address.line);","pm.environment.set(\"cust_address_city\", customer.address.city);","pm.environment.set(\"cust_address_country\", customer.address.country);","pm.environment.set(\"cust_address_postalZone\", customer.address.postalZone);","","// ===== Clear Existing Line Items =====","for (let i = 0; i < 10; i++) {"," const keys = ["," \"name\", \"description\", \"hsnCode\", \"productCategory\", \"unitPrice\","," \"discountRate\", \"discountAmount\", \"feeRate\", \"feeAmount\","," \"quantity\", \"totalAmount\", \"taxRate\", \"taxAmount\""," ];"," keys.forEach(key => pm.environment.unset(`li_${i}_${key}`));","}","","// ===== Set Line Items =====","calculatedLineItems.forEach((li, i) => {"," Object.entries(li).forEach(([key, value]) => {"," pm.environment.set(`li_${i}_${key}`, value);"," });","});","","// ===== Set Totals =====","pm.environment.set(\"totals_totalLineAmount\", parseFloat(totalLineAmount.toFixed(2)));","pm.environment.set(\"totals_totalTax\", parseFloat(totalTax.toFixed(2)));","pm.environment.set(\"totals_grandTotal\", grandTotal);","","","// ===== Log Summary =====","console.log(`Generated invoice with ${calculatedLineItems.length} line items`);","console.log(`Total Line Amount: ${totalLineAmount.toFixed(2)}`);","console.log(`Total Tax: ${totalTax.toFixed(2)}`);","console.log(`Grand Total: ${grandTotal}`);"],"type":"text/javascript","packages":{},"requests":{},"id":"bc8b2e57-339d-4805-bdf6-89b70644e5e3"}}],"id":"d5286b68-e09c-40c6-bf8b-b9c561c75ef9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"invoiceRef\": \"4571583738433\",\r\n \"aggregatorId\": \"{{aggregator_Register}}\",\r\n \"merchantId\": \"\",\r\n \"currency\": \"NGN\",\r\n \"issueDate\": \"08-10-2025\",\r\n \"dueDate\": \"07-11-2025\",\r\n \"status\": \"issued\",\r\n \"orderReference\": \"4047610103513\",\r\n \"customer\": {\r\n \"customerId\": \"cust_009\",\r\n \"name\": \"Shoprite Nigeria\",\r\n \"email\": \"info@shoprite.com\",\r\n \"phone\": \"+2348099999999\",\r\n \"identifiers\": {\r\n \"tin\": \"24988238-0001\"\r\n },\r\n \"address\": {\r\n \"line\": \"9 Market Road\",\r\n \"city\": \"Ibadan\",\r\n \"country\": \"NG\",\r\n \"postalZone\": \"200001\"\r\n }\r\n },\r\n \"lineItems\": [\r\n {\r\n \"name\": \"50kg Bag of Beans\",\r\n \"description\": \"Premium beans\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n // \"hsnCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n // \"productCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"isicCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n \"serviceCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 4500,\r\n \"discountRate\": 5,\r\n \"discountAmount\": 675,\r\n \"feeRate\": 1.5,\r\n \"feeAmount\": 202.5,\r\n \"quantity\": 3,\r\n \"totalAmount\": 13027.5,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 977.06\r\n },\r\n {\r\n \"name\": \"Gallon of Vegetable Oil\",\r\n \"description\": \"Cooking oil\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n \"hsnCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n \"productCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n // \"isicCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n // \"serviceCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 12000,\r\n \"discountRate\": 12,\r\n \"discountAmount\": 2880,\r\n \"feeRate\": 2.5,\r\n \"feeAmount\": 600,\r\n \"quantity\": 2,\r\n \"totalAmount\": 21720,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 1629\r\n }\r\n ],\r\n \"totals\": {\r\n \"totalLineAmount\": 34747.5,\r\n \"totalTax\": 2606.06,\r\n \"grandTotal\": 37353.56\r\n },\r\n \"firsSpecific\": {\r\n \"invoiceTypeCode\": \"396\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PENDING\",\r\n \"invoiceKind\": \"B2B\" // B2B,B2C, B2G - defaults to B2B\r\n // ,\"references\": {\r\n // \"orderReference\": \"order REF\", //optional\r\n // \"buyerReference\": \"buyer REF\", //optional\r\n // \"billingReferences\": [\r\n // {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ], //optional\r\n // \"dispatchDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"receiptDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"originatorDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"contractDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"additionalDocumentReferences\": [\r\n // {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ] //optional\r\n // }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/process","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/process

Create an invoice on behalf of a linked merchant. The request body is the same as Merchant's Process Invoice, with one addition: an aggregatorId at the top level identifying you.

Request body additions

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`aggregatorId`	string	Yes	Your aggregator identifier.
`merchantId`	string	Yes	Identifier of the linked merchant this invoice is being issued by.

All other fields (invoiceRef, currency, customer, lineItems, totals, firsSpecific, etc.) are identical to Merchant Process Invoice.

Example response (200 OK)

Same shape as Merchant Process Invoice:

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": {\n        \"issueDate\": \"24-04-2026\",\n        \"dueDate\": \"24-05-2026\",\n        \"syncDate\": \"24-04-2026\",\n        \"paymentStatus\": \"PENDING\",\n        \"transmitted\": false,\n        \"delivered\": false,\n        \"irn\": \"1966926849272-BBCCC154-20260424\",\n        \"qrString\": \"data:image/png;base64,...\"\n    }\n}\n\n

\n","urlObject":{"path":["api","v1","invoice","aggregator","invoice","process"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"4a28614d-0825-4839-b733-e42b777d1845","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"invoiceRef\": \"4571583738433\",\r\n // \"aggregatorId\": \"{{aggregator_Register}}\",\r\n \"merchantId\": \"\",\r\n \"currency\": \"NGN\",\r\n \"issueDate\": \"08-10-2025\",\r\n \"dueDate\": \"07-11-2025\",\r\n \"status\": \"issued\",\r\n \"orderReference\": \"4047610103513\",\r\n \"customer\": {\r\n \"customerId\": \"cust_009\",\r\n \"name\": \"Shoprite Nigeria\",\r\n \"email\": \"info@shoprite.com\",\r\n \"phone\": \"+2348099999999\",\r\n \"identifiers\": {\r\n \"tin\": \"24988238-0001\"\r\n },\r\n \"address\": {\r\n \"line\": \"9 Market Road\",\r\n \"city\": \"Ibadan\",\r\n \"country\": \"NG\",\r\n \"postalZone\": \"200001\"\r\n }\r\n },\r\n \"lineItems\": [\r\n {\r\n \"name\": \"50kg Bag of Beans\",\r\n \"description\": \"Premium beans\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n // \"hsnCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n // \"productCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"isicCode\": \"CC-002\", // Pass one of Product Code or Service Code\r\n \"serviceCategory\": \"Food and Beverages\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 4500,\r\n \"discountRate\": 5,\r\n \"discountAmount\": 675,\r\n \"feeRate\": 1.5,\r\n \"feeAmount\": 202.5,\r\n \"quantity\": 3,\r\n \"totalAmount\": 13027.5,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 977.06\r\n },\r\n {\r\n \"name\": \"Gallon of Vegetable Oil\",\r\n \"description\": \"Cooking oil\",\r\n \"sellersItemIdentification\": \"sellersItemIdentification\",\r\n \"hsnCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n \"productCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n // \"isicCode\": \"CC-004\", // Pass one of Product Code or Service Code\r\n // \"serviceCategory\": \"Food\", // Pass one of Product Code or Service Code\r\n \"unitPrice\": 12000,\r\n \"discountRate\": 12,\r\n \"discountAmount\": 2880,\r\n \"feeRate\": 2.5,\r\n \"feeAmount\": 600,\r\n \"quantity\": 2,\r\n \"totalAmount\": 21720,\r\n \"taxCode\": \"STANDARD_VAT\",\r\n \"taxRate\": 7.5,\r\n \"taxAmount\": 1629\r\n }\r\n ],\r\n \"totals\": {\r\n \"totalLineAmount\": 34747.5,\r\n \"totalTax\": 2606.06,\r\n \"grandTotal\": 37353.56\r\n },\r\n \"firsSpecific\": {\r\n \"invoiceTypeCode\": \"396\",\r\n // \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PENDING\",\r\n \"invoiceKind\": \"B2B\" // B2B,B2C, B2G - defaults to B2B\r\n // ,\"references\": {\r\n // \"orderReference\": \"order REF\", //optional\r\n // \"buyerReference\": \"buyer REF\", //optional\r\n // \"billingReferences\": [\r\n // {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ], //optional\r\n // \"dispatchDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"receiptDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"originatorDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"contractDocumentReference\": {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }, //optional\r\n // \"additionalDocumentReferences\": [\r\n // {\r\n // \"irn\": \"ITW001-E9E0C0D3-20240619\",\r\n // \"issueDate\": \"05-03-2026\"\r\n // }\r\n // ] //optional\r\n // }\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/process"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:37:53 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"syncDate\": \"24-04-2026\",\n \"paymentStatus\": \"PENDING\",\n \"transmitted\": false,\n \"delivered\": false,\n \"irn\": \"1966926849272-BBCCC154-20260424\",\n \"qrString\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAAD9UlEQVR4Xu3WXW4bMQxFYe1A+98ld6Dyu8q4qdEAfSlYFJnY4xnpKODfpbTOn1y13kd+e31jb9c39nb961ittfq7T1Wt2uvs8uret56cxA6g+rZjboM96m7lnR/D2nBG91T1Z1uyd7vVt3g1j7G62d12s3yDlhhPY+dIen+WZAtxXPGdxZCd82XBTg30I4cM3fkxjGS+vH5V1pfXX8JydVwpxLf/lipoD+IaGU1hnWAjqcJ+jNGErOesRHkQa7CxoyJV4m2DEq44j/4zhwlmD0XPHntmpSP6Fe857BiXdkDznPBQGQMOYiqSD7fP+EbECkDyHxdGsIpiWrqJasy/H1FP3Oew3igOqYjmzua7U6jq1VY3i219psNLw/1ry2gPSshlfhBbZmBbq9mi3FDkQkKvshzA0pMbtatB1aia5FBkM4mxvkfJQ2gXrn+sd9j7SP0MVtfeG9VyPlj3dGD5eVI/hBH01go7zSlGg+XlejCHgRJWgz2nNrmDLI1nEksUb0EeHYauKfwqx38ZxHbaTb9krk2PU+o1Pk1i6tK9HFQ6rKmERToiDR7D8hVbTcbEFmEjalIdDGIZpt40Pw+3MTe6fm5tI9gVc0dXcD98ONEQ+XxK/QAmkJ3fS2HixiLj5P/l6QTG1jRjs5ZZcicq3XEQI49DOMZSBbG713p5Ws0I1qZDow+RzmBmn513EFtK0lQkXDrPR4UuDftxYQKrhFD+A/RLJncOBj6DWNJ9JN5vct9x5pp16+XpCFbaCfl2TPWclZiTtfieeDmE1W0tIEHmiRq4VaokBrG2kYzN3H6YYrzOdCXI/STmXb/LprYc8mCMX5+UNYBVup+sg5Jqs3HEilFsJeGim7Qnqlwpy9dFhjCJPxnUDt3uG+Rz6iewWC2+VzAd25WEWwF4eTqCNSCwmo29hFP2Ei9LYQxiTI88tBs7bR62mqSXM4nJsyGeSHgEI7hL76mXpyOYcUkv4i2ndXOH0D0PYkcMTSjH45dqOrxl0avVjGBFMctpTzTvCSF7R98DTWK2tmijnoYTNS+LKXsSS6+L0WkzRBOxpBKIfBDTTAJsZm/21xW0QhjFlKEqtInchyLmrUlrhZNYXLi291iqoJRoL37+0RjG6ii4w5tiLGfP65u/R/UTmDBGNY6hlewDfNAcHMOkfqXB3NjqhlvOb2dUs3NYfq8T+h85lyj79TiIsfnYwxJMVWCBoFK2ShjEDjuXHFfq0RaiTrP+LhjDGEomS03KdlIvwp7PNCasAKFVCQk0FxTCNKYAj9C2RLZjgSNfie2tjikMSc5NYtoZC9ISkaPYjWJFyzf1J6nfibmAj2F/cH1jb9c39nb9D9gPkgC6sq+m7FEAAAAASUVORK5CYII=\"\n }\n}"}],"_postman_id":"d5286b68-e09c-40c6-bf8b-b9c561c75ef9"},{"name":"Lookup Invoice","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"1e78d2cb-fbae-43c4-bd08-c1fb84e434d4"}}],"id":"bbcb1480-9fe2-4cb7-9450-dbe8e6337666","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\"\r\n ,\"invoiceReference\": \"4571583738433\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/details","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/details

Retrieve an invoice created by your aggregator on behalf of a merchant. Request body is identical to Merchant Lookup Invoice.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`merchantId`	string	Yes	The linked merchant's identifier.
`irn`	string	Either this or `invoiceReference`	The IRN returned at creation time.
`invoiceReference`	string	Either this or `irn`	The original `invoiceRef`.

The response includes an additional top-level field aggregatorId identifying the aggregator that created the invoice. Otherwise the structure matches Merchant Lookup Invoice.

\n","urlObject":{"path":["api","v1","invoice","aggregator","invoice","details"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"1c601bf7-4c3e-412c-a0c7-ecbacb5594b7","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\"\r\n ,\"invoiceReference\": \"4571583738433\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/invoice/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:38:54 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"invoiceRef\": \"1966926849272\",\n \"merchantId\": \"C0008335\",\n \"aggregatorId\": \"CON7B60C\",\n \"currency\": \"NGN\",\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"invoiceDirection\": \"SENT\",\n \"customer\": {\n \"name\": \"GTBank Plc\",\n \"email\": \"support@gtbank.com\",\n \"phone\": \"+2348077777777\",\n \"identifiers\": {\n \"tin\": \"11188238-0001\"\n },\n \"address\": {\n \"line\": \"7 Independence Avenue\",\n \"city\": \"Kaduna\",\n \"country\": \"NG\",\n \"postalZone\": \"800001\"\n }\n },\n \"lineItems\": [\n {\n \"name\": \"Bag of Garri\",\n \"description\": \"Ijebu Garri\",\n \"sellersItemIdentification\": \"sellersItemIdentification\",\n \"unitPrice\": 3000,\n \"unitQuantity\": 1,\n \"unitPriceDescription\": \"NGN3000 per 1\",\n \"discountRate\": 7,\n \"discountAmount\": 840,\n \"feeRate\": 1,\n \"feeAmount\": 120,\n \"quantity\": 4,\n \"totalAmount\": 11280,\n \"taxCode\": \"STANDARD_VAT\",\n \"taxRate\": 7.5,\n \"taxAmount\": 846\n },\n {\n \"name\": \"Carton of Milk\",\n \"description\": \"Powdered milk\",\n \"sellersItemIdentification\": \"sellersItemIdentification\",\n \"hsnCode\": \"CC-006\",\n \"productCategory\": \"Beverages\",\n \"unitPrice\": 8000,\n \"unitQuantity\": 1,\n \"unitPriceDescription\": \"NGN8000 per 1\",\n \"discountRate\": 10,\n \"discountAmount\": 800,\n \"feeRate\": 2,\n \"feeAmount\": 160,\n \"quantity\": 1,\n \"totalAmount\": 7360,\n \"taxCode\": \"STANDARD_VAT\",\n \"taxRate\": 7.5,\n \"taxAmount\": 552\n }\n ],\n \"totals\": {\n \"totalLineAmount\": 18640,\n \"totalTax\": 1398,\n \"grandTotal\": 20038\n },\n \"firsSpecific\": {\n \"firsBusinessId\": \"1736d4f4-c154-4fca-85b8-805141a03093\",\n \"serviceId\": \"BBCCC154\",\n \"invoiceTypeCode\": \"Invoice Request\",\n \"paymentStatus\": \"PENDING\",\n \"irn\": \"1966926849272-BBCCC154-20260424\",\n \"invoiceKind\": \"B2B\",\n \"dates\": {},\n \"references\": {},\n \"accountingSupplierParty\": {\n \"name\": \"Dibbert Group\",\n \"tin\": \"48877688-8335\",\n \"email\": \"info@dibbert.com\",\n \"telephone\": \"+2348078714877\",\n \"postalAddress\": {\n \"line\": \"Line\",\n \"city\": \"City\",\n \"country\": \"NG\",\n \"postalZone\": \"Postal Zone\"\n }\n },\n \"taxCurrencyCode\": \"NGN\",\n \"invoiceStatus\": {\n \"issueDate\": \"24-04-2026\",\n \"dueDate\": \"24-05-2026\",\n \"syncDate\": \"24-04-2026\",\n \"paymentStatus\": \"PENDING\",\n \"transmitted\": false,\n \"delivered\": false,\n \"irn\": \"1966926849272-BBCCC154-20260424\"\n },\n \"firsNotificationStatus\": {\n \"status\": \"PENDING\",\n \"message\": \"Notification to FIRS is currently pending\"\n }\n },\n \"qrString\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAAD9UlEQVR4Xu3WXW4bMQxFYe1A+98ld6Dyu8q4qdEAfSlYFJnY4xnpKODfpbTOn1y13kd+e31jb9c39nb961ittfq7T1Wt2uvs8uret56cxA6g+rZjboM96m7lnR/D2nBG91T1Z1uyd7vVt3g1j7G62d12s3yDlhhPY+dIen+WZAtxXPGdxZCd82XBTg30I4cM3fkxjGS+vH5V1pfXX8JydVwpxLf/lipoD+IaGU1hnWAjqcJ+jNGErOesRHkQa7CxoyJV4m2DEq44j/4zhwlmD0XPHntmpSP6Fe857BiXdkDznPBQGQMOYiqSD7fP+EbECkDyHxdGsIpiWrqJasy/H1FP3Oew3igOqYjmzua7U6jq1VY3i219psNLw/1ry2gPSshlfhBbZmBbq9mi3FDkQkKvshzA0pMbtatB1aia5FBkM4mxvkfJQ2gXrn+sd9j7SP0MVtfeG9VyPlj3dGD5eVI/hBH01go7zSlGg+XlejCHgRJWgz2nNrmDLI1nEksUb0EeHYauKfwqx38ZxHbaTb9krk2PU+o1Pk1i6tK9HFQ6rKmERToiDR7D8hVbTcbEFmEjalIdDGIZpt40Pw+3MTe6fm5tI9gVc0dXcD98ONEQ+XxK/QAmkJ3fS2HixiLj5P/l6QTG1jRjs5ZZcicq3XEQI49DOMZSBbG713p5Ws0I1qZDow+RzmBmn513EFtK0lQkXDrPR4UuDftxYQKrhFD+A/RLJncOBj6DWNJ9JN5vct9x5pp16+XpCFbaCfl2TPWclZiTtfieeDmE1W0tIEHmiRq4VaokBrG2kYzN3H6YYrzOdCXI/STmXb/LprYc8mCMX5+UNYBVup+sg5Jqs3HEilFsJeGim7Qnqlwpy9dFhjCJPxnUDt3uG+Rz6iewWC2+VzAd25WEWwF4eTqCNSCwmo29hFP2Ei9LYQxiTI88tBs7bR62mqSXM4nJsyGeSHgEI7hL76mXpyOYcUkv4i2ndXOH0D0PYkcMTSjH45dqOrxl0avVjGBFMctpTzTvCSF7R98DTWK2tmijnoYTNS+LKXsSS6+L0WkzRBOxpBKIfBDTTAJsZm/21xW0QhjFlKEqtInchyLmrUlrhZNYXLi291iqoJRoL37+0RjG6ii4w5tiLGfP65u/R/UTmDBGNY6hlewDfNAcHMOkfqXB3NjqhlvOb2dUs3NYfq8T+h85lyj79TiIsfnYwxJMVWCBoFK2ShjEDjuXHFfq0RaiTrP+LhjDGEomS03KdlIvwp7PNCasAKFVCQk0FxTCNKYAj9C2RLZjgSNfie2tjikMSc5NYtoZC9ISkaPYjWJFyzf1J6nfibmAj2F/cH1jb9c39nb9D9gPkgC6sq+m7FEAAAAASUVORK5CYII=\",\n \"merchantLogo\": \"\"\n }\n}"}],"_postman_id":"bbcb1480-9fe2-4cb7-9450-dbe8e6337666"},{"name":"Payment Notification","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"873171a3-36b1-4592-b169-907f27faed05"}}],"id":"1a6be53d-10a4-4b11-95ba-7e374acd069e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PAID\" // PENDING, PAID, REJECTED\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/payment/notify","description":"

POST {{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/payment/notify

Update the payment status of an invoice created under your aggregator.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`merchantId`	string	Yes	The linked merchant's identifier.
`irn`	string	Yes	IRN of the invoice.
`paymentStatus`	string	Yes	`PENDING`, `PAID`, or `REJECTED`.

Response envelope is the same as Merchant Payment Notification with data: null.

\n","urlObject":{"path":["api","v1","invoice","aggregator","payment","notify"],"host":["{{baseUrl_ApiGateway}}"],"query":[{"disabled":true,"key":"aggregatorId","value":"{{aggregator_Register}}"}],"variable":[]}},"response":[{"id":"5d426eee-8d7a-4297-b6c3-d4955d96fda8","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"\",\r\n \"irn\": \"4571583738433-BBCCC154-20251008\",\r\n \"paymentStatus\": \"PAID\" // PENDING, PAID, REJECTED\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/payment/notify","host":["{{baseUrl_ApiGateway}}"],"path":["api","v1","invoice","aggregator","payment","notify"],"query":[{"key":"aggregatorId","value":"{{aggregator_Register}}","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:39:17 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": null\n}"}],"_postman_id":"1a6be53d-10a4-4b11-95ba-7e374acd069e"},{"name":"Update Merchant Details","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"8ad0a198-97fa-4ac8-91d9-3e4c732c7d47"}}],"id":"51a0cde3-eabf-446b-b158-b2e0cb7d4930","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"C0008335\",\r\n \"name\": \"Dibbert Group Annex\",\r\n \"firsBusinessId\": \"fdadoa-000000-sadasdsa\",\r\n \"firsServiceId\": \"AF19KD\",\r\n \"tin\": \"42989-0001\",\r\n \"email\": \"toks@dibbertgroup.com\",\r\n \"phone\": \"+2348080099930\",\r\n \"webhookUrl\": \"webhookUrl_29ce14037de4\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/merchant/update","description":"

PUT {{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/merchant/update

Update the profile of a merchant linked under your aggregator. Fields and behaviour match Merchant Update Merchant Details; the request body refers to the linked merchant by merchantId.

\n","urlObject":{"path":["api","v1","invoice","aggregator","merchant","update"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"b34b8b97-faaa-45fd-9677-940259d7a956","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"merchantId\": \"C0008335\",\r\n \"name\": \"Dibbert Group Annex\",\r\n \"firsBusinessId\": \"fdadoa-000000-sadasdsa\",\r\n \"firsServiceId\": \"AF19KD\",\r\n \"tin\": \"42989-0001\",\r\n \"email\": \"toks@dibbertgroup.com\",\r\n \"phone\": \"+2348080099930\",\r\n \"webhookUrl\": \"webhookUrl_29ce14037de4\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/aggregator/merchant/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:40:30 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": {\n \"id\": 34,\n \"name\": \"Dibbert Group Annex\",\n \"merchantId\": \"C0008335\",\n \"firsBusinessId\": \"fdadoa-000000-sadasdsa\",\n \"firsServiceId\": \"AF19KD\",\n \"tin\": \"42989-0001\",\n \"email\": \"toks@dibbertgroup.com\",\n \"phone\": \"+2348080099930\",\n \"serviceMode\": \"BOTH\",\n \"webhookUrl\": \"webhookUrl_29ce14037de4\",\n \"logoUrl\": null,\n \"createdDate\": \"2026-04-06T16:55:41Z\",\n \"updatedDate\": \"2026-04-24T10:40:30Z\",\n \"aggregators\": null\n }\n}"}],"_postman_id":"51a0cde3-eabf-446b-b158-b2e0cb7d4930"},{"name":"Update Service Mode","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"requests":{},"id":"3b2d4206-5f11-41a8-b99f-aa4d5333b85a"}}],"id":"f26c8da1-9bee-4ad9-9d3e-bfc1e4fd1880","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[{"key":"secretKey","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"aggregatorId\": \"AGG123457\",\r\n \"serviceMode\": \"BOTH\" //APP, SI, BOTH\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/service-mode/update","description":"

PUT {{baseUrl_ApiGateway}}/api/v1/invoice/service-mode/update

Change the service mode of an aggregator account. The service mode controls which role the aggregator plays in the NRS four-corner model.

Request body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`aggregatorId`	string	Yes	Aggregator identifier whose mode is being changed.
`serviceMode`	string	Yes	New mode. One of `APP`, `SI`, `BOTH`.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Value	Meaning
`APP`	Access Point Provider — aggregator transmits invoices to NRS on behalf of merchants.
`SI`	System Integrator — aggregator integrates merchants' systems to the NRS platform.
`BOTH`	Aggregator operates in both roles.

Example response (200 OK)

{\n    \"status\": \"00\",\n    \"message\": \"Approved or completed successfully\",\n    \"data\": null\n}\n\n

\n","urlObject":{"path":["api","v1","invoice","service-mode","update"],"host":["{{baseUrl_ApiGateway}}"],"query":[],"variable":[]}},"response":[{"id":"71d02c4d-7c7c-4377-bdf2-d30d9c284789","name":"Successful Response","originalRequest":{"method":"PUT","header":[{"key":"secretKey","value":"","type":"text","disabled":true},{"key":"secretKey","value":"{{secretKey_ToksBread}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"aggregatorId\": \"{{aggregator_Register}}\",\r\n \"serviceMode\": \"BOTH\" //APP, SI, BOTH\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseUrl_ApiGateway}}/api/v1/invoice/service-mode/update"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":":status","value":200},{"key":"cache-control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"content-security-policy","value":"default-src 'self'; frame-ancestors 'none'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; form-action 'self'; base-uri 'self'; object-src 'none';"},{"key":"Content-Type","value":"application/json","description":"","type":"text"},{"key":"date","value":"Fri, 24 Apr 2026 10:37:26 GMT"},{"key":"expires","value":"0"},{"key":"permissions-policy","value":"camera=(), microphone=(), geolocation=(), payment=()"},{"key":"pragma","value":"no-cache"},{"key":"referrer-policy","value":"strict-origin-when-cross-origin"},{"key":"strict-transport-security","value":"max-age=63072000 ; includeSubDomains ; preload"},{"key":"vary","value":"Origin, Access-Control-Request-Method, Access-Control-Request-Headers"},{"key":"x-content-type-options","value":"nosniff"},{"key":"x-frame-options","value":"DENY"},{"key":"x-xss-protection","value":"0"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"00\",\n \"message\": \"Approved or completed successfully\",\n \"data\": null\n}"}],"_postman_id":"f26c8da1-9bee-4ad9-9d3e-bfc1e4fd1880"}],"id":"8246721e-11e7-464c-a835-1ab5eb65648d","description":"

Use the endpoints in this folder when you operate the platform on behalf of other merchants — for example, an ERP vendor that onboards its customers, or a fintech providing invoicing as part of a broader offering.

The Aggregator flow mirrors the Merchant flow, with two differences:

Every request carries an aggregatorId so we know which aggregator is acting.
\n
Before you can Process Invoice on behalf of a merchant, that merchant must be onboarded via Link Merchant.
\n

\n","_postman_id":"8246721e-11e7-464c-a835-1ab5eb65648d"}],"id":"16bfaf48-b1ac-44aa-ab22-fedd35fefded","description":"

Welcome. This documentation describes how to integrate with the NRS e-Invoicing platform to generate, transmit, and track invoices that are cleared by the Nigeria Revenue Service (NRS, formerly FIRS). Two integration modes are supported and are organised into the two folders of this collection:

Merchant — a business that issues invoices on its own behalf.
\n
Aggregator — a party that operates on behalf of one or more merchants it has onboarded (for example, a billing platform, ERP vendor, or marketplace).
The endpoints are intentionally symmetric: every Merchant capability has an Aggregator equivalent, plus an additional Link Merchant endpoint that Aggregators use to register the merchants they service.
\n

How it works

When you call Process Invoice, we do two things in a single request:

Persist the invoice on our side with the details you supplied.
\n
Forward the invoice to NRS for clearance, in their required specification.
You receive back the platform's own confirmation along with an IRN (Invoice Reference Number) — the unique identifier NRS issues for every cleared invoice — and a QR string (a base64-encoded PNG) that you can render on the printed or PDF copy you deliver to your customer. The QR code is what a tax officer or buyer scans to verify the invoice on the NRS public verification portal.
\n

Notification to NRS happens asynchronously. The initial response tells you the invoice has been accepted by us and queued for transmission; you can poll Lookup Invoice at any time to see the latest transmission and notification status, or (recommended) configure a webhook so we push the status change to you.

Once the invoice is paid, you notify us via Payment Notification so we can update the record and forward the payment status to NRS.

Authentication

Every request is authenticated with a single header:

secretKey: <your secret key>\n\n

Your secretKey is issued to you during onboarding. Treat it like a password:

Do not embed it in client-side code, mobile apps, or browser JavaScript.
\n
Do not commit it to source control.
\n
Rotate it immediately if you suspect it has been exposed.
All calls must be made over HTTPS. Requests over plain HTTP are rejected.
\n

Request and response format

All request bodies (except Link Merchant) are JSON. Send Content-Type: application/json.
\n
Link Merchant uses multipart/form-data because it accepts a logo file upload.
\n

All responses are JSON with the following envelope:

{\n  \"status\": \"00\",\n  \"message\": \"Approved or completed successfully\",\n  \"data\": { ... }\n}\n\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`status`	A status code. `\"00\"` indicates success. Any other value indicates an error; `message` will explain.
`message`	A human-readable description of the outcome.
`data`	The result payload for a successful call. May be `null` for operations that do not need to return data (for example, payment notification).

Your integration should treat status == \"00\" as the sole indicator of success and log message for any other value.

Key concepts

IRN (Invoice Reference Number). The unique identifier NRS assigns to every cleared invoice. We return it in the response to Process Invoice and you must store it — it is the key for looking up, notifying payment on, or applying credit notes against the invoice later. Format: -- (for example, 7122889588380-BBCCC154-20260424).

merchantId****. Your identifier on our platform. You receive this during onboarding. Aggregators work with the merchantId of each merchant they have linked.

aggregatorId****. Only used in the Aggregator flow. Identifies your aggregator account on our platform.

Invoice kind. B2B, B2C, or B2G. Determines how NRS treats the invoice. Defaults to B2B if omitted.

Service mode. Applies to aggregators and determines which role the aggregator plays in the NRS four-corner model: APP (Access Point Provider), SI (System Integrator), BOTH, or NONE.

QR string. A base64-encoded PNG (data:image/png;base64,...) returned with every created or retrieved invoice. Render it on the invoice document you deliver to the buyer — they can scan it to verify the invoice against NRS.

\n","_postman_id":"16bfaf48-b1ac-44aa-ab22-fedd35fefded"},{"name":"General Reference","item":[{"name":"Bank Codes","item":[],"id":"4e1e4dfb-acdc-43e6-8d3b-18c2d913f792","description":"

bankCode	bankName
000	CENTRAL BANK OF NIGERIA
011	FIRST BANK OF NIGERIA PLC
023	NIGERIA INTERNATIONAL BANK (CITIBANK)
030	HERITAGE BANK PLC
032	UNION BANK OF NIGERIA PLC
033	UBA PLC
035	WEMA BANK PLC
039	STANBIC IBTC BANK PLC
044	ACCESS BANK PLC
050	ECOBANK NIGERIA PLC
057	ZENITH BANK PLC
058	GUARANTY TRUST BANK
068	STANDARD CHARTERED BANK NIGERIA LTD
070	FIDELITY BANK PLC
076	POLARIS BANK PLC
101	PROVIDUS BANK
214	FIRST CITY MONUMENT BANK PLC
215	UNITY BANK PLC
232	STERLING BANK PLC
301	JAIZ BANK
459	CORONATION MERCHANT BANK LIMITED
480	JUBILEE BANK
510120013	KANO MICROFINANCE BANKS
511080016	ESO SAVINGS LOANS PLC
511080026	ASO SAVINGS AND LOANS
511080036	NATIONAL HOUSING FUND
511080106	GAA-AKANBI MICRO FINANCE BANK
512170012	CLASSIC MICROFINANCE BANK
512170022	SOLID ROCK MFB OKE ONA ABEOKUTA
512170032	LAVENDER MICROFINANCE BANK LTD
512170042	EBIGI MICROFINANCE BANK
512170052	EFOTAMODI/OGUNOLA MICROFINANCE BANK
512170062	EIYEPE MICROFINANCE BANK
512170072	EJOSE MICROFINANCE BANK LTD
512170082	EMAZING GRACE MICROFINANCE BANK
512170092	CATLAND MICROFINANCE BANK LTD
512170102	OGUN STATE MICROFINANCE BANKS
512170112	UKUOMBE MICROFINANCE BANK LTD
512170122	URUWON MICROFINANCE BANK
512170132	USO-E MICROFINANCE BANK
512170142	EPPLE MICROFINANCE BANK
512170152	OFONYIN MICROFINANCE BANK
512170162	OMODI-IMOSAN MICROFINANCE BANK LTD
512170172	OJEBU-IFE COMMUNITY BANK NIG. LTD
512170182	OJEBU-IMUSIN MICROFINANCE BANK LTD
512170192	OKENNE MICROFINANCE BANK LTD
512170202	OGUN STATE MICROFINANCE BANKS
512170212	OLISAN MICROFINANCE BANK LTD
512170222	OMOWO MICROFINANCE BANK NIG LTD
512170232	ONTERLAND MICROFINANCE BANK
512170242	OPERU MICROFINANCE BANK LTD
512170252	OTELE MICROFINANCE BANK LTD
512170262	OGUN STATE MICROFINANCE BANKS
512170272	OGUN STATE MICROFINANCE BANKS
512170282	OGUN STATE MICROFINANCE BANKS
512170292	MALPOLY MICROFINANCE BANK
512170302	MOLUSI MICROFINANCE BANK LTD
512170312	NEW IMAGE MFB EGBA ODEDA
512170322	COMBINED BENEFITS MICROFINANCE BANK
512170332	OGUN STATE MICROFINANCE BANKS
512170342	AMU COMMUNITY BANK LTD
512170352	ARISUN MFB
512170362	RIVERSIDE MICROFINANCE BANK LTD
512170372	SAGAM MICROFINANCE BANK
512170382	TRUST MFB EGBA OWODE ABEOKUTA
512170392	OGUN STATE MICROFINANCE BANKS
512170402	ACON SUCCESS MICROFINANCE BANK LTD
512170412	UNAAB MICROFINANCE BANK
512170422	WEST-END MICROFINANCE BANK
512170432	HONEY MICROFINANCE BANK
512170442	EGOSASA MICROFINANCE BANK
512170452	ESTRA POLARIS MICROFINANCE BANK LTD
512170462	OGUN STATE MICROFINANCE BANKS
512170472	OGUN STATE MICROFINANCE BANKS
512170492	STAR MICROFINANCE BANK
512170502	CENTAGE SAVINGS AND LOANS
512170522	OGUN STATE MICROFINANCE BANKS
512170542	GATEWAY SAVINGS AND LOANS LTD
512170552	NACRDB ABIGI
512170562	NACRDB AYETORO
512170572	NACRDB IMEKO
512170582	NACRDB ABEOKUTA
512170592	OGUN STATE MICROFINANCE BANKS
512170602	NACRDB OTA
512170612	NACRDB ODEDA ABEOKUTA
512170622	NACRDB AGO-IWOYE
512170632	NACRDB SAGAM
512170652	ONTEGRATED MICROFINANCE BANK
512170662	OROLU MIRCOFINANCE BANK LTD
513210013	RIVERS MICROFINANCE BANKS
514040013	EDO MICROFINANCE BANKS
515150013	LAGOS BUILDING INVESTMENT CO.LTD
515150023	SKYE MORTGAGE
515150033	UNION HOMES SAVINGS AND LOANS PLC
515150043	NIGERIA POLICE FORCE
515150053	NIGERIA POLICE FORCE
515150063	LAGOS MICROFINANCE BANKS
515150073	SPECSMFB
516290013	OSUN MICROFINANCE BANKS
516290023	AAU MICRO-FINANCE BANK
517150014	ARITA BASHORUN MICROFINANCE BANK
517150024	MULTIVEST MICROFINANCE BANK
517150034	OGBOORA MFB
517150044	PACESETTERS MICROFINANCE BANK
517150054	CIVIC MICROFINANCE BANK
517150064	ALOGBON MFB
517150074	CREST MFB
517150084	EYETE MFB
517150094	EKESAN MFB
518150014	YOBE SAVINGS & LOANS LIMITED
518150024	NIG AGRIC COOP & RURAL DEV BANK LTD
518150034	YOBE MICROFINANCE BANK
518150044	YOBE MICROFINANCE BANK
518150054	YOBE MICROFINANCE BANK
518150064	YOBE MICROFINANCE BANK
519290019	ZION MFB
520150010	AURS MICRO FINANCE BANK
520150020	KWARA STATE MICROFINANCE BANKS
520150030	KWARA STATE MICROFINANCE BANKS
520150040	KWARA STATE MICROFINANCE BANKS
520150050	KWARA STATE MICROFINANCE BANKS
520150060	KWARA STATE MICROFINANCE BANKS
520150070	KWARA STATE MICROFINANCE BANKS
520150080	KWARA STATE MICROFINANCE BANKS
520150090	KWARA STATE MICROFINANCE BANKS
520150100	KWARA STATE MICROFINANCE BANKS
520150110	KWARA STATE MICROFINANCE BANKS
520150120	KWARA STATE MICROFINANCE BANKS
520150130	KWARA STATE MICROFINANCE BANKS
520150140	KWARA STATE MICROFINANCE BANKS
520150150	KWARA STATE MICROFINANCE BANKS
520150160	KWARA STATE MICROFINANCE BANKS
520150170	KWARA STATE MICROFINANCE BANKS
520150180	KWARA STATE MICROFINANCE BANKS
521150010	OKOLE MICROFINANCE BANK
521150020	SUNBEAM MICROFINANCE BANK LTD
521150030	ERAMOKO MFB LIMITED
522150010	JIGAWA SAVINGS & LOANS LTD
580000010	JUBILEE LIFE MORTGAGE BANK
590000001	POCKET MONEY

","_postman_id":"4e1e4dfb-acdc-43e6-8d3b-18c2d913f792"}],"id":"4326e795-15cf-4a7a-bca3-03875c01425c","_postman_id":"4326e795-15cf-4a7a-bca3-03875c01425c","description":""}],"event":[{"listen":"prerequest","script":{"id":"aa44acfb-e786-42ff-8021-48c307a10c3a","type":"text/javascript","requests":{},"exec":[""]}},{"listen":"test","script":{"id":"36126af6-a3dd-4563-8c11-51807a475fbc","type":"text/javascript","requests":{},"exec":[""]}}],"variable":[{"key":"accessToken","value":"eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJtdGwtZGZuc0NyUjROZjctdjBiUWpGa0tGQVlvOEpWQklhOW5mNW13RjlZIn0.eyJleHAiOjE3NTEyODUyMzMsImlhdCI6MTc1MTI4MTYzMywianRpIjoiNzYyZjdjOGQtZmE1YS00Y2QxLWFlOWQtZmFjOGIxNmU5NDBkIiwiaXNzIjoiaHR0cDovLzE5Mi4xNjguMTAuODI6OTE4MC9rZXljbG9hay9yZW1pdGEvZXhhcHAvYXBpL3YxL3JlZGdhdGUvYXV0aC9yZWFsbXMvcmVtaXRhIiwiYXVkIjpbImRpc2NvdmVyeS1zZXJ2ZXIiLCJhY2NvdW50Il0sInN1YiI6IjgwM2RjNDJlLTc2MjMtNDNhMi1iYTRkLWM3ODI2MjVhMmQ2MCIsInR5cCI6IkJlYXJlciIsImF6cCI6InJlbWl0YXVhYS1zZXJ2aWNlIiwic2Vzc2lvbl9zdGF0ZSI6IjBjMDQzNTQ4LTE2M2EtNDkyOC05NmNkLTgzMzM1NGI4ZGQ0ZCIsImFjciI6IjEiLCJhbGxvd2VkLW9yaWdpbnMiOlsiaHR0cHM6Ly9sb2dpbi5yZW1pdGEubmV0Il0sInJlYWxtX2FjY2VzcyI6eyJyb2xlcyI6WyJvZmZsaW5lX2FjY2VzcyIsInVtYV9hdXRob3JpemF0aW9uIl19LCJyZXNvdXJjZV9hY2Nlc3MiOnsiZGlzY292ZXJ5LXNlcnZlciI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsInZpZXctcHJvZmlsZSJdfSwiYWNjb3VudCI6eyJyb2xlcyI6WyJtYW5hZ2UtYWNjb3VudCIsIm1hbmFnZS1hY2NvdW50LWxpbmtzIiwidmlldy1wcm9maWxlIl19fSwic2NvcGUiOiJlbWFpbCBwcm9maWxlIiwiZW1haWxfdmVyaWZpZWQiOnRydWUsIm5hbWUiOiJVU0VSMDIwIFVTRVIwMjAiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiIybGVwbnI2cnpxYWQwajdnIiwiZ2l2ZW5fbmFtZSI6IlVTRVIwMjAiLCJmYW1pbHlfbmFtZSI6IlVTRVIwMjAiLCJvcmdhbmlzYXRpb24taWQiOiJDV0dERU1PIiwiZW1haWwiOiJ1c2VyMDIwIn0.Ql2Yjh5BZETaoHevgRF-U6Ui8M86tW2MiR5-BIiRrXqueYyHGtfCJgFlrwIjpYrTNzKnqy1QwpzXs3VX1DoVWwUWYO-u3MjydZbYHJZoywKvQakcgdUIHhFELk31BCQM8cABw_KS4LjGNaXHdnMEBHKUBDUmQ-DQR9XGTLwVk3sccm5cgV22X2hjA1BKVzF17rLv0nmPBrqEmjvrUR58OfYqSLTULII18ATyYrGLI4NuaHVS3FzWFJR9Fn7YWTdOyLyJKMHC6libt40Ljl6lOO-lgjIlff_xfDe262kUpx-RY-T2WpVgLWVyl5RMYwUPIJ3JnSj9g6Jq7dr8GVdYjw"},{"key":"transactionRef","value":"{{transactionRef}}"},{"key":"batchTransRef","value":"240706"},{"key":"merchantId_DD","value":""},{"key":"apiKey_DD","value":""},{"key":"serviceTypeId_DD","value":""},{"key":"apiToken","value":""},{"key":"merchantId","value":""},{"key":"apiKey","value":""},{"key":"serviceTypeId","value":""},{"key":"baseUrl","value":"https://demo.remita.net/remita/exapp/api/v1/send/api"},{"key":"payerAccount","value":"1245125478"},{"key":"payerBankCode","value":"057"},{"key":"publicKey","value":""},{"key":"secretKey","value":""},{"key":"otp","value":"1234"},{"key":"card","value":"0441234567890"},{"key":"frequency","value":"Day"},{"key":"startDate","value":"03/07/2025"},{"key":"endDate","value":"03/01/2026"},{"key":"baseUrl_RefData","value":"https://remitademo.net/referencedata/api/ext"},{"key":"publicKey_Ref","value":""},{"key":"billId","value":""},{"key":"agentCode","value":"SPECSQAD"},{"key":"agent_publicKey","value":""},{"key":"agent_secretKey","value":""},{"key":"mandateId_DD","value":"180799091923"},{"key":"requestId_DD","value":"1751532065837"},{"key":"apiHash","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"},{"key":"requestId_debit","value":"73298"},{"key":"transRef1","value":"205650600765"},{"key":"transRef2","value":"110051250820161900000000104136"},{"key":"transRef3","value":"110051250820161900000000465603"},{"key":"customerReference","value":"812919"},{"key":"rrr","value":"200799091919"},{"key":"amount","value":"10000"},{"key":"clientRef","value":"583402664332"},{"key":"vendReference","value":"583402664332"},{"key":"orderId","value":"1751531922971"},{"key":"secretKey_Connect_FI","value":""},{"key":"baseUrl_Connect_Temp","value":"https://api-gateway-qa.systemspecsng.com/services/connect-gateway"},{"key":"destBankCode","value":"058"},{"key":"destAccountNo","value":"0587851521"},{"key":"benAccount","value":"0588372336"},{"key":"benAccountName","value":"Olga Moreno"},{"key":"benAccountBank","value":"058"},{"key":"paymentReference","value":"4175554"},{"key":"randomProcessingTime","value":"8.35"},{"key":"baseUrl_Connect","value":"https://api-demo.systemspecsng.com/services/connect-gateway"},{"key":"paymentIdentifier","value":"000078250827083739963869306492"},{"key":"bulkReference","value":"8851722306"},{"key":"transRef4","value":"110051250820161900000000187277"},{"key":"amount1","value":"392"},{"key":"amount2","value":"488"},{"key":"amount3","value":"494"},{"key":"amount4","value":"561"},{"key":"bulkAmount","value":"1935"},{"key":"sourceAccountName","value":"Magdalena Guillaume"},{"key":"sourceBankCode","value":"925"},{"key":"sourceBankAccount","value":"9256258124"},{"key":"destAccountName1","value":"Ibrahim Lawal"},{"key":"destBankCode1","value":"070"},{"key":"destAccountNo1","value":"0702232975"},{"key":"destAccountName2","value":"Obinna Uche"},{"key":"destBankCode2","value":"070"},{"key":"destAccountNo2","value":"0705597564"},{"key":"destAccountName3","value":"Ibrahim Lawal"},{"key":"destBankCode3","value":"070"},{"key":"destAccountNo3","value":"0703030550"},{"key":"destAccountName4","value":"Amara Johnson"},{"key":"destBankCode4","value":"033"},{"key":"destAccountNo4","value":"0332919338"},{"key":"nibssTransactionId","value":"000078250307144824887138492958"},{"key":"encryptedResponseBody","value":"{{encryptedResponseBody}}"},{"key":"remitaPublicKey","value":""},{"key":"remitaSecretKey","value":""},{"key":"SessionID","value":"000078250307144824887138492958"},{"key":"destAccountName","value":"Paul Reed"},{"key":"bvn","value":"1741353888151"},{"key":"narration","value":"Payment for invoice #12345;RESPCODE:USE_CUSTOM_CODE,00;TIMEOUT:USE_CUSTOM_TIMEOUT,1;TQSCODES:[00:1]"},{"key":"transactionId","value":"{{transactionId}}"},{"key":"totalAmount","value":"21000"},{"key":"expiryDate","value":"{{expiryDate}}"},{"key":"yourListeningUrl","value":"{{yourListeningUrl}}"},{"key":"hash","value":"b1894bb8e87cfd52b2dad54e87b6ad3413475e7d9503f637a9cb1aa78acf08aab77b3bbfc77c49dc856c5aeaf2f43c297f28e8f4116207443f356074d8009a69"},{"key":"baseURL_DD_Get","value":"https://demo.remita.net/remita/ecomm"},{"key":"secretKey_Connect","value":""},{"key":"accountNumber","value":"5012284010"},{"key":"productCode","value":"101"},{"key":"categoryId","value":"{{categoryId}}"},{"key":"billerId","value":"S0000573002"},{"key":"productId","value":"10713664850"},{"key":"secretKey_FI","value":""},{"key":"destAccountNumber","value":"0586957398"},{"key":"baseUrl_Switch","value":"http://192.168.104.21:8323"},{"key":"baseUrl_UAA","value":"http://192.168.106.21:6201/microservice/remita/gateway/send"},{"key":"secretKey_FT","value":""},{"key":"publicKey_FT","value":""},{"key":"destbankCode","value":"044"},{"key":"currentIndex","value":"0"},{"key":"singleRef1","value":"5051884387"},{"key":"singleRef2","value":"2408649287"},{"key":"singleRef3","value":"4578086400"},{"key":"singleRef4","value":"1351987662"},{"key":"singleRef5","value":"2376778192"},{"key":"singleRef6","value":"9771061475"},{"key":"singleRef7","value":"6548151776"},{"key":"singleRef8","value":"3907618868"},{"key":"singleRef9","value":"3088184425"},{"key":"singleRef10","value":"3347919048"},{"key":"destinationBankCode1","value":"011"},{"key":"destinationAccountNo1","value":"0114967236"},{"key":"accountHolderName1","value":"Chinaza Ekene"},{"key":"destinationBankCode2","value":"035"},{"key":"destinationAccountNo2","value":"0358653747"},{"key":"accountHolderName2","value":"Adeola Fashola"},{"key":"destinationBankCode3","value":"926"},{"key":"destinationAccountNo3","value":"9268217263"},{"key":"accountHolderName3","value":"Zainab Musa"},{"key":"destinationBankCode4","value":"011"},{"key":"destinationAccountNo4","value":"0111237858"},{"key":"accountHolderName4","value":"Emeka Obi"},{"key":"destinationBankCode5","value":"035"},{"key":"destinationAccountNo5","value":"0355820276"},{"key":"accountHolderName5","value":"Salihu Garba"},{"key":"destinationBankCode6","value":"926"},{"key":"destinationAccountNo6","value":"9261952813"},{"key":"accountHolderName6","value":"Obinna Nwachukwu"},{"key":"destinationBankCode7","value":"011"},{"key":"destinationAccountNo7","value":"0115298777"},{"key":"accountHolderName7","value":"Temitope Alabi"},{"key":"destinationBankCode8","value":"035"},{"key":"destinationAccountNo8","value":"0353344503"},{"key":"accountHolderName8","value":"Obinna Nwachukwu"},{"key":"destinationBankCode9","value":"926"},{"key":"destinationAccountNo9","value":"9266169663"},{"key":"accountHolderName9","value":"Temitope Alabi"},{"key":"destinationBankCode10","value":"011"},{"key":"destinationAccountNo10","value":"0114321458"},{"key":"accountHolderName10","value":"Blessing Etim"},{"key":"transactionReference","value":"110051250607083202000516399829"},{"key":"variable_name","value":"Student Number"},{"key":"requestId","value":"1751533484929"},{"key":"timeStamp","value":"2025-07-03T8:46:45+000000"},{"key":"mandateId","value":"180799091923"},{"key":"remitaTransRef","value":"1751532401042"},{"key":"merchantID_DD","value":""},{"key":"debitAmount","value":"200"},{"key":"requestId_Mandate","value":"1751532065837"},{"key":"authorisationCode","value":"73573"},{"key":"customerId","value":"202408261636"},{"key":"bankCode","value":"023"},{"key":"authorization","value":""},{"key":"disbursementDate","value":"03-07-2025 01:09:25+0000"},{"key":"loanAmount","value":"20000"},{"key":"numberOfRepayments","value":"5"},{"key":"collectionAmount","value":"4120"},{"key":"totalCollectionAmount","value":"20600"},{"key":"mandateReference","value":"190799091952"},{"key":"batchPaymentIdentifier","value":"8851722306"},{"key":"customReference","value":"768050709347"},{"key":"paymentIdentifier1","value":"205650600765"},{"key":"paymentIdentifier2","value":"032880622374"},{"key":"paymentIdentifier3","value":"915153140422"},{"key":"paymentIdentifier4","value":"227962290455"},{"key":"main_MerchantId","value":""},{"key":"issueDate","value":"08-10-2025"},{"key":"dueDate","value":"07-11-2025"},{"key":"issueTime","value":"09:22:22"},{"key":"buyerIrn","value":"4571583738433-BBCCC154-20251008"},{"key":"sellerIrn","value":"4571583738433-BBCCC154-20251008"},{"key":"InvoiceNo","value":"4571583738433"},{"key":"purchaseOrder","value":"4047610103513"},{"key":"cust_customerId","value":"cust_009"},{"key":"cust_name","value":"Shoprite Nigeria"},{"key":"cust_email","value":"info@shoprite.com"},{"key":"cust_phone","value":"+2348099999999"},{"key":"cust_tin","value":"24988238-0001"},{"key":"cust_address_line","value":"9 Market Road"},{"key":"cust_address_city","value":"Ibadan"},{"key":"cust_address_country","value":"NG"},{"key":"cust_address_postalZone","value":"200001"},{"key":"li_0_name","value":"50kg Bag of Beans"},{"key":"li_0_description","value":"Premium beans"},{"key":"li_0_hsnCode","value":"CC-002"},{"key":"li_0_productCategory","value":"Food and Beverages"},{"key":"li_0_unitPrice","value":"4500"},{"key":"li_0_discountRate","value":"5"},{"key":"li_0_discountAmount","value":"675"},{"key":"li_0_feeRate","value":"1.5"},{"key":"li_0_feeAmount","value":"202.5"},{"key":"li_0_quantity","value":"3"},{"key":"li_0_totalAmount","value":"13027.5"},{"key":"li_0_taxRate","value":"7.5"},{"key":"li_0_taxAmount","value":"977.06"},{"key":"li_1_name","value":"Gallon of Vegetable Oil"},{"key":"li_1_description","value":"Cooking oil"},{"key":"li_1_hsnCode","value":"CC-004"},{"key":"li_1_productCategory","value":"Food"},{"key":"li_1_unitPrice","value":"12000"},{"key":"li_1_discountRate","value":"12"},{"key":"li_1_discountAmount","value":"2880"},{"key":"li_1_feeRate","value":"2.5"},{"key":"li_1_feeAmount","value":"600"},{"key":"li_1_quantity","value":"2"},{"key":"li_1_totalAmount","value":"21720"},{"key":"li_1_taxRate","value":"7.5"},{"key":"li_1_taxAmount","value":"1629"},{"key":"li_0_sellersItemIdentification","value":"sellersItemIdentification"},{"key":"li_0_taxCode","value":"STANDARD_VAT"},{"key":"li_1_sellersItemIdentification","value":"sellersItemIdentification"},{"key":"li_1_taxCode","value":"STANDARD_VAT"},{"key":"totals_totalLineAmount","value":"34747.5"},{"key":"totals_totalTax","value":"2606.06"},{"key":"totals_grandTotal","value":"37353.56"},{"key":"secretkey","value":""}]}