{"info":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","description":"

Welcome to Swita! Our API enables seamless bill payments across a variety of services, including Airtime, Data subscriptions, Cable TV (such as GOTV, DSTV, and Startimes), and Electricity token purchases from multiple Distribution Companies (Discos) like AEDC (Abuja), IKEJA, KAEDC (Kaduna), and others.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"24569409","collectionId":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","publishedId":"2sAY4yfMbW","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-11-05T16:40:21.000Z"},"item":[{"name":"Transactions","item":[{"name":"Fetch Transactions","id":"bfa852b8-b217-44ea-bdfd-885d01fc1f3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/transactions","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["transactions"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"b3e03439-73e7-4898-8c67-a6a94537abd3","name":"Fetch Transactions","originalRequest":{"method":"POST","header":[],"url":"{{base_url}}/transactions"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 06 Nov 2024 16:47:11 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transactions fetched successfully!\",\n \"data\": {\n \"current_page\": 1,\n \"data\": [\n {\n \"id\": 36,\n \"service_id\": 5,\n \"account\": \"68100005534\",\n \"total_amount\": \"500.00\",\n \"amount\": \"500.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96500.00\",\n \"post_balance\": \"96000.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB199010738233388411823\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"68100005534\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"500\",\n \"service_type\": \"electricity\",\n \"service_code\": \"PHED\",\n \"account_type\": \"PREPAID\",\n \"package_code\": null,\n \"save_beneficiary\": true,\n \"redirect_url\": \"http://localhost:3000/electricity/done\",\n \"tx_ref\": \"SP-6777435543434233\",\n \"name\": \"John Doe\",\n \"minimum_amount\": 0,\n \"customer_address\": \"22 Crescent Avenue, Abuja\",\n \"customer_phone\": null,\n \"tariff_code\": \"C-Non MD\"\n },\n \"created_at\": \"2024-11-06T16:33:00.000000Z\",\n \"updated_at\": \"2024-11-06T16:33:48.000000Z\",\n \"metadata\": {\n \"info\": {\n \"token\": \"6654-5184-0285-2320-7719-4184\",\n \"expiry_date\": null,\n \"units\": \"8.24 units\",\n \"serial_number\": \"55307692587915350743\",\n \"kct1\": \"\",\n \"kct2\": \"\"\n }\n },\n \"service\": {\n \"id\": 5,\n \"name\": \"Port Harcourt Electricity Distribution Company\",\n \"code\": \"PHED\",\n \"sort_code\": 5,\n \"description\": \"PHED (Port Harcourt Electricity)\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 1,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782564/PHEDC_um3epc.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n },\n {\n \"id\": 35,\n \"service_id\": 12,\n \"account\": \"08061372146\",\n \"total_amount\": \"100.00\",\n \"amount\": \"100.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96600.00\",\n \"post_balance\": \"96500.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB191014637764685165776\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"100\",\n \"service_type\": \"AIRTIME\",\n \"service_code\": \"MTN_AIRTIME\",\n \"package_code\": null,\n \"tx_ref\": \"LC-18243071988344452112\"\n },\n \"created_at\": \"2024-11-06T16:32:00.000000Z\",\n \"updated_at\": \"2024-11-06T16:33:03.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 12,\n \"name\": \"MTN AIRTIME\",\n \"code\": \"MTN_AIRTIME\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n },\n {\n \"id\": 34,\n \"service_id\": 12,\n \"account\": \"08061372146\",\n \"total_amount\": \"100.00\",\n \"amount\": \"100.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96700.00\",\n \"post_balance\": \"96600.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB116781200905464308090\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"100\",\n \"service_type\": \"AIRTIME\",\n \"service_code\": \"MTN_AIRTIME\",\n \"package_code\": null,\n \"tx_ref\": \"LC-18243071988344452112\"\n },\n \"created_at\": \"2024-11-06T15:48:00.000000Z\",\n \"updated_at\": \"2024-11-06T15:48:15.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 12,\n \"name\": \"MTN AIRTIME\",\n \"code\": \"MTN_AIRTIME\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n },\n {\n \"id\": 33,\n \"service_id\": 12,\n \"account\": \"08061372146\",\n \"total_amount\": \"100.00\",\n \"amount\": \"100.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96800.00\",\n \"post_balance\": \"96700.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB188309288831220647883\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"failed\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"100\",\n \"service_type\": \"AIRTIME\",\n \"service_code\": \"MTN_AIRTIME\",\n \"package_code\": null,\n \"tx_ref\": \"LC-18243071988344452112\"\n },\n \"created_at\": \"2024-11-06T15:44:00.000000Z\",\n \"updated_at\": \"2024-11-06T15:44:48.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 12,\n \"name\": \"MTN AIRTIME\",\n \"code\": \"MTN_AIRTIME\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n },\n {\n \"id\": 32,\n \"service_id\": 12,\n \"account\": \"08061372146\",\n \"total_amount\": \"100.00\",\n \"amount\": \"100.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96900.00\",\n \"post_balance\": \"96800.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB146902353738894238373\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"100\",\n \"service_type\": \"AIRTIME\",\n \"service_code\": \"MTN_AIRTIME\",\n \"package_code\": null,\n \"tx_ref\": \"LC-18243071988344452112\"\n },\n \"created_at\": \"2024-11-06T15:36:00.000000Z\",\n \"updated_at\": \"2024-11-06T15:36:17.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 12,\n \"name\": \"MTN AIRTIME\",\n \"code\": \"MTN_AIRTIME\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n ],\n \"first_page_url\": \"http://localhost:12000/api/v1/transactions?page=1\",\n \"from\": 1,\n \"last_page\": 1,\n \"last_page_url\": \"http://localhost:12000/api/v1/transactions?page=1\",\n \"links\": [\n {\n \"url\": null,\n \"label\": \"« Previous\",\n \"active\": false\n },\n {\n \"url\": \"http://localhost:12000/api/v1/transactions?page=1\",\n \"label\": \"1\",\n \"active\": true\n },\n {\n \"url\": null,\n \"label\": \"Next »\",\n \"active\": false\n }\n ],\n \"next_page_url\": null,\n \"path\": \"http://localhost:12000/api/v1/transactions\",\n \"per_page\": 10,\n \"prev_page_url\": null,\n \"to\": 5,\n \"total\": 5\n }\n}"}],"_postman_id":"bfa852b8-b217-44ea-bdfd-885d01fc1f3b"},{"name":"Fetch Single Transaction","id":"3de9c705-9a06-4f68-93ca-d5e72d90575b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/transactions/SWB199010738233388411823","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["transactions","SWB199010738233388411823"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"581de9b7-c1c0-4ecf-8359-ffef82749cf2","name":"Fetch Single Transaction","originalRequest":{"method":"GET","header":[],"url":"{{base_url}}/transactions/SWB199010738233388411823"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 06 Nov 2024 16:46:40 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transaction details fetched successfully!\",\n \"data\": {\n \"id\": 36,\n \"service_id\": 5,\n \"account\": \"68100005534\",\n \"total_amount\": \"500.00\",\n \"amount\": \"500.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"96500.00\",\n \"post_balance\": \"96000.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB199010738233388411823\",\n \"external_reference\": null,\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"68100005534\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"500\",\n \"service_type\": \"electricity\",\n \"service_code\": \"PHED\",\n \"account_type\": \"PREPAID\",\n \"package_code\": null,\n \"save_beneficiary\": true,\n \"redirect_url\": \"http://localhost:3000/electricity/done\",\n \"tx_ref\": \"SP-6777435543434233\",\n \"name\": \"John Doe\",\n \"minimum_amount\": 0,\n \"customer_address\": \"22 Crescent Avenue, Abuja\",\n \"customer_phone\": null,\n \"tariff_code\": \"C-Non MD\"\n },\n \"created_at\": \"2024-11-06T16:33:00.000000Z\",\n \"updated_at\": \"2024-11-06T16:33:48.000000Z\",\n \"metadata\": {\n \"info\": {\n \"token\": \"6654-5184-0285-2320-7719-4184\",\n \"expiry_date\": null,\n \"units\": \"8.24 units\",\n \"serial_number\": \"55307692587915350743\",\n \"kct1\": \"\",\n \"kct2\": \"\"\n }\n },\n \"service\": {\n \"id\": 5,\n \"name\": \"Port Harcourt Electricity Distribution Company\",\n \"code\": \"PHED\",\n \"sort_code\": 5,\n \"description\": \"PHED (Port Harcourt Electricity)\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 1,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782564/PHEDC_um3epc.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n}"}],"_postman_id":"3de9c705-9a06-4f68-93ca-d5e72d90575b"},{"name":"Report Transaction","id":"7209a64d-12e7-4e59-aa03-9e692547f63c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"{{base_url}}/transactions/:reference/report","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["transactions",":reference","report"],"host":["{{base_url}}"],"query":[],"variable":[{"type":"any","value":"","key":"reference"}]}},"response":[],"_postman_id":"7209a64d-12e7-4e59-aa03-9e692547f63c"}],"id":"8310427e-9c55-4ba4-815f-293e21562ebc","_postman_id":"8310427e-9c55-4ba4-815f-293e21562ebc","description":"","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}}},{"name":"Services","item":[{"name":"List Categories","id":"f5b717bc-7ed7-443a-a220-afd9ee398c5f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/services/categories/list","description":"

The List Services endpoint supports the following categories to filter and retrieve specific types of services:

\n
    \n
  • \"POWER\": Lists all electricity services, including services for various electricity distribution companies (Discos) such as AEDC (Abuja Distribution), IKEJA (Ikeja), KAEDC (Kaduna), etc. This category covers services related to electricity token purchases, bill payments, and related transactions.
    • \n
  • \"Airtime\": Lists services for topping up airtime or mobile credit across all networks. This category includes services for major mobile network providers such as MTN, Airtel, Glo, and 9mobile (formerly Etisalat), allowing users to recharge their mobile phone balances.
    • \n
  • \"Data\": Lists services for purchasing data plans across all data networks. This category includes services for major data network providers such as MTN, Airtel, Glo, and 9mobile, enabling users to subscribe to internet data plans for browsing and online activities.
    • \n
  • \"TV\": Lists services for cable TV subscriptions, including networks such as Multichoice (DSTV and GOTV) and Startimes. This category covers services related to subscribing to cable TV packages, renewing subscriptions, and accessing TV channels and content.
    • \n
\n","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["services","categories","list"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"5e4cf8d9-8f05-41c8-8915-8f5b02541601","name":"List Categories","originalRequest":{"method":"POST","header":[],"url":"localhost:12000/api/v1/services/categories/list"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Sat, 29 Jun 2024 20:49:44 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Categories retrieved successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n },\n {\n \"id\": 2,\n \"name\": \"Pay CableTV\",\n \"slug\": \"cabletv\",\n \"sort_code\": 1,\n \"status\": \"upcoming\",\n \"description\": \"Pay for CableTV subscriptions.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n },\n {\n \"id\": 3,\n \"name\": \"Buy Airtime\",\n \"slug\": \"airtime\",\n \"sort_code\": 2,\n \"status\": \"upcoming\",\n \"description\": \"Purchase airtime for your phone.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n },\n {\n \"id\": 4,\n \"name\": \"Buy Internet\",\n \"slug\": \"internet\",\n \"sort_code\": 3,\n \"status\": \"upcoming\",\n \"description\": \"Buy internet data packages.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n },\n {\n \"id\": 5,\n \"name\": \"Pay Exams\",\n \"slug\": \"exams\",\n \"sort_code\": 4,\n \"status\": \"upcoming\",\n \"description\": \"Pay for examination fees.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n },\n {\n \"id\": 6,\n \"name\": \"Other Collections\",\n \"slug\": \"other_collections\",\n \"sort_code\": 5,\n \"status\": \"upcoming\",\n \"description\": \"Miscellaneous collections.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n ]\n}"}],"_postman_id":"f5b717bc-7ed7-443a-a220-afd9ee398c5f"},{"name":"List Services","id":"9eced30f-4bb6-48f0-a67f-8e3d8edd16b2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"category_slug\": \"electricity\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services","description":"

The List Services endpoint supports the following categories to filter and retrieve specific types of services:

\n
    \n
  • \"POWER\": Lists all electricity services, including services for various electricity distribution companies (Discos) such as AEDC (Abuja Distribution), IKEJA (Ikeja), KAEDC (Kaduna), etc. This category covers services related to electricity token purchases, bill payments, and related transactions.
    • \n
  • \"Airtime\": Lists services for topping up airtime or mobile credit across all networks. This category includes services for major mobile network providers such as MTN, Airtel, Glo, and 9mobile (formerly Etisalat), allowing users to recharge their mobile phone balances.
    • \n
  • \"Data\": Lists services for purchasing data plans across all data networks. This category includes services for major data network providers such as MTN, Airtel, Glo, and 9mobile, enabling users to subscribe to internet data plans for browsing and online activities.
    • \n
  • \"TV\": Lists services for cable TV subscriptions, including networks such as Multichoice (DSTV and GOTV) and Startimes. This category covers services related to subscribing to cable TV packages, renewing subscriptions, and accessing TV channels and content.
    • \n
\n","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["services"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"5c485ff7-b125-4ab3-904e-0d76001ddc6e","name":"List Services","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"category_slug\": \"electricity\"\r\n}","options":{"raw":{"language":"json"}}},"url":"localhost:12000/api/v1/services"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Sat, 29 Jun 2024 20:50:32 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Services retrieved successfully\",\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"Abuja Electricity Distribution Company\",\n \"code\": \"ABEDC\",\n \"sort_code\": 1,\n \"description\": \"ABEDC (Abuja Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 2,\n \"name\": \"Benin Electricity Distribution Company\",\n \"code\": \"BEDC\",\n \"sort_code\": 2,\n \"description\": \"BEDC (Benin Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 3,\n \"name\": \"Enugu Electricity Distribution Company\",\n \"code\": \"EEDC\",\n \"sort_code\": 3,\n \"description\": \"EEDC (Enugu Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 4,\n \"name\": \"Aba Power Electricity Distribution Company\",\n \"code\": \"APLE\",\n \"sort_code\": 4,\n \"description\": \"APLE (Enugu Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 5,\n \"name\": \"Maiduguri Electricity Distribution Company Limited\",\n \"code\": \"MEEPDCL\",\n \"sort_code\": 5,\n \"description\": \"MEEPDCL (Maiduguri Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 6,\n \"name\": \"Ibadan Electricity Distribution Company\",\n \"code\": \"IBEDC\",\n \"sort_code\": 6,\n \"description\": \"IBEDC (Ibadan Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 7,\n \"name\": \"Ikeja Electricity Distribution Company\",\n \"code\": \"IKEDC\",\n \"sort_code\": 7,\n \"description\": \"IKEDC (Ikeja Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 8,\n \"name\": \"Jos Electricity Distribution Company\",\n \"code\": \"JEDC\",\n \"sort_code\": 8,\n \"description\": \"JEDC (Jos Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 9,\n \"name\": \"Kaduna Electricity Distribution Company\",\n \"code\": \"KEDC\",\n \"sort_code\": 9,\n \"description\": \"KEDC (Kaduna Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 10,\n \"name\": \"Kano Electricity Distribution Company\",\n \"code\": \"KEDCO\",\n \"sort_code\": 10,\n \"description\": \"KEDCO (Kano Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n },\n {\n \"id\": 11,\n \"name\": \"Port Harcourt Electricity Distribution Company\",\n \"code\": \"PHED\",\n \"sort_code\": 11,\n \"description\": \"PHED (Port Harcourt Electricity)\",\n \"status\": \"active\",\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\",\n \"service_category\": {\n \"id\": 1,\n \"name\": \"Pay Electricity\",\n \"slug\": \"electricity\",\n \"sort_code\": 0,\n \"status\": \"upcoming\",\n \"description\": \"Pay your electricity bills.\",\n \"parent_id\": null,\n \"image_url\": null,\n \"created_at\": \"2024-06-29T20:49:15.000000Z\",\n \"updated_at\": \"2024-06-29T20:49:15.000000Z\"\n }\n }\n ]\n}"}],"_postman_id":"9eced30f-4bb6-48f0-a67f-8e3d8edd16b2"},{"name":"Get Payment Options","id":"f600893a-1954-4b50-bc2f-b92c635924d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/billers/payment-options","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","payment-options"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"57199b1a-27a9-40de-8d65-36ff825f006a","name":"Success - Get Payment Methods","originalRequest":{"method":"GET","header":[],"url":"localhost:12000/api/v1/billers/payment-methods"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 14 Aug 2024 13:15:41 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Fetched payment methods successfully.\",\n \"data\": [\n {\n \"label\": \"Pay with Sapa Wallet\",\n \"icon\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1723641040/wallet_xkpxkq.png\",\n \"disabled\": false,\n \"type\": \"wallet\"\n },\n {\n \"label\": \"Pay with Bank Transfer\",\n \"icon\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1723641041/bank_transfer_shdxwp.png\",\n \"disabled\": false,\n \"type\": \"bank_transfer\"\n },\n {\n \"label\": \"Pay with Debit Card\",\n \"icon\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1723641040/bank_card_uxhhsf.png\",\n \"disabled\": false,\n \"type\": \"debit_card\"\n }\n ]\n}"}],"_postman_id":"f600893a-1954-4b50-bc2f-b92c635924d7"},{"name":"Get Pricing Options","id":"484026b4-1a9c-4e6c-b9fb-d376b35ec15a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{base_url}}/billers/pricing-options","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","pricing-options"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"90e42216-9c0e-4a44-9f9c-9d506e1a1818","name":"Success - Get Pricing Options","originalRequest":{"method":"GET","header":[],"url":"localhost:12000/api/v1/billers/pricing-options"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Wed, 14 Aug 2024 13:15:35 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Fetched pricing options successfully\",\n \"data\": {\n \"allowed_pricing_options\": [\n 500,\n 1000,\n 2000,\n 5000,\n 10000,\n 20000,\n 50000\n ]\n }\n}"}],"_postman_id":"484026b4-1a9c-4e6c-b9fb-d376b35ec15a"},{"name":"Get Plans","id":"9d7f0cf6-95d8-490c-ba38-1f1b72c97754","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services/plans","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["services","plans"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"1d21b682-97b1-42fa-abb6-7b1bd912cd8d","name":"Get Plans","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\"\r\n}","options":{"raw":{"language":"json"}}},"url":"localhost:12000/api/v1/services/plans"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Oct 2024 09:20:43 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"transactions.fetch.success\",\n \"data\": [\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_1\",\n \"description\": \"1 Day\",\n \"amount\": 90\n },\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_2\",\n \"description\": \"1 Week\",\n \"amount\": 300\n },\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_3\",\n \"description\": \"1 Month\",\n \"amount\": 900\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_1\",\n \"description\": \"1 Day\",\n \"amount\": 160\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_2\",\n \"description\": \"1 Week\",\n \"amount\": 600\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_3\",\n \"description\": \"1 Month\",\n \"amount\": 1700\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_1\",\n \"description\": \"1 Day\",\n \"amount\": 320\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_2\",\n \"description\": \"1 Week\",\n \"amount\": 1200\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_3\",\n \"description\": \"1 Month\",\n \"amount\": 2500\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_1\",\n \"description\": \"1 Day\",\n \"amount\": 90\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_2\",\n \"description\": \"1 Week\",\n \"amount\": 300\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_3\",\n \"description\": \"1 Month\",\n \"amount\": 900\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_1\",\n \"description\": \"1 Day\",\n \"amount\": 200\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_2\",\n \"description\": \"1 Week\",\n \"amount\": 700\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_3\",\n \"description\": \"1 Month\",\n \"amount\": 2200\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_1\",\n \"description\": \"1 Day\",\n \"amount\": 400\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_2\",\n \"description\": \"1 Week\",\n \"amount\": 1500\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_3\",\n \"description\": \"1 Month\",\n \"amount\": 4200\n }\n ]\n}"}],"_postman_id":"9d7f0cf6-95d8-490c-ba38-1f1b72c97754"},{"name":"Validate Account (Electricity)","id":"7521d8bd-fa3d-4dfe-a742-4f2b59e49c52","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"electricity\",\r\n \"service_code\": \"phed\",\r\n \"account_type\": \"prepaid\",\r\n \"account\": \"68100005534\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/account/validate","description":"

Verify account details for different service types.

\n

Parameters:

\n
    \n
  • type (string): Specifies the service type for validation. Possible values include:
      \n
    • \"POWER\": Validates meter numbers for electricity services.
      • \n
    • \"AIRTIME\": Validates network providers for phone numbers (MTN, GLO, Airtel, 9Mobile).
      • \n
    • \"TV\": Validates decoder numbers for TV services.
      • \n
    • \"MONEY_TRANSFER\": Validates bank account numbers for money transfers.
      • \n
    • Additional service types can be added as needed.
      • \n
    \n
    • \n
  • account (string): possible values are account number (for money transfer), meter number (for disco or electricity), phone number (airtime or data) and decoder number (GOTV, DSTV and Startimes) to be validated.
    • \n
\n","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","account","validate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"3691601c-e519-44ff-89d1-a10b8dd5554f","name":"Validate Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"electricity\",\r\n \"service_code\": \"aedc\",\r\n \"account_type\": \"prepaid\",\r\n \"account\": \"12345556666\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/account/validate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Sat, 17 Aug 2024 05:15:55 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Account verified!\",\n \"data\": {\n \"name\": \"John Doe\",\n \"minimum_amount\": 0,\n \"customer_address\": \"22 Crescent Avenue, Abuja\",\n \"customer_phone\": null,\n \"tariff_code\": \"C-Non MD\",\n \"account\": \"12345556666\",\n \"account_type\": \"PREPAID\"\n }\n}"},{"id":"41623601-99d0-465d-8c39-d3afcd3fd573","name":"Validate Account","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"electricity\",\r\n \"service_code\": \"aple\",\r\n \"account_type\": \"prepaid\",\r\n \"account\": \"45066912762\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/account/validate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Oct 2024 10:03:38 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Account verification successful.\",\n \"data\": {\n \"service_type\": \"electricity\",\n \"service_code\": \"aple\",\n \"account_type\": \"PREPAID\",\n \"account\": \"45066912762\",\n \"error\": false,\n \"disco_code\": \"APLE\",\n \"minimum_vend_amount\": 500,\n \"max_vend_amount\": 1000000,\n \"response_code\": 100,\n \"outstanding\": 163867.759980512,\n \"debt_repayment\": 0,\n \"name\": \"UJOATUONU INNOCENT CHIOMA OPURUM\",\n \"customer_address\": \"PLOT 6 JEHOVAH WITNESS ROAD UMUCHICHI OBINGWA L.G.A ABIA STATE (4319364741), PLOT 6 JEHOVAH WITNESS ROAD UMUCHICHI OBINGWA L.G.A ABIA STATE (4319364741), ABA DISTRICT\",\n \"tariff\": 102.08,\n \"tariff_class\": \"R2SB-NMD\",\n \"demand_type\": \"NMD\"\n }\n}"}],"_postman_id":"7521d8bd-fa3d-4dfe-a742-4f2b59e49c52"},{"name":"Initiate Transaction (Electricity)","id":"f7509893-1709-4bbb-a602-423c1e6667c4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"electricity\",\r\n \"service_code\": \"PHED\",\r\n \"account_type\": \"PREPAID\",\r\n \"account\": \"68100005534\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"100\",\r\n \"client_reference\": \"IXPROD-0025\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate","description":"

Start a new transaction upon confirmation of details.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 NameDescriptionTypePossible ValuesExample
amountSpecifies the amount for the transaction.Decimal numberN/A\"amount\": \"100.00\"
accountContains the account details for the transaction.StringAccount number, meter number, phone number, etc.\"account\": \"1234567890\"
typeSpecifies the type of transaction.String\"POWER\", \"MONEY_TRANSFER\", \"AIRTIME\", etc.\"type\": \"MONEY_TRANSFER\"
payment_channelSpecifies the payment channel for the transaction.String\"CARD\", \"WALLET\", \"BANK_TRANSFER\", etc.\"payment_channel\": \"CARD\"
\n
","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","transactions","initiate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"e7ffc196-2b62-4c61-93f0-d633e109d0c6","name":"Initiate Transaction (Electricity)","originalRequest":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"68100005534\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"500\",\r\n \"service_type\": \"electricity\",\r\n \"service_code\": \"PHED\",\r\n \"account_type\": \"prepaid\",\r\n \"package_code\": \"\",\r\n \"client_reference\": \"SP-234394434534534433444233\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 07 Nov 2024 13:15:41 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"57"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transaction processed successfully!\",\n \"data\": {\n \"id\": 110,\n \"service_id\": 5,\n \"account\": \"68100005534\",\n \"total_amount\": \"500.00\",\n \"amount\": \"500.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"85180.00\",\n \"post_balance\": \"84680.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB124675873341996654334\",\n \"client_reference\": \"SP-234394434534534433444233\",\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"68100005534\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"500\",\n \"service_type\": \"electricity\",\n \"service_code\": \"PHED\",\n \"account_type\": \"PREPAID\",\n \"package_code\": null,\n \"client_reference\": \"SP-234394434534534433444233\",\n \"name\": \"John Doe\",\n \"minimum_amount\": 0,\n \"customer_address\": \"22 Crescent Avenue, Abuja\",\n \"customer_phone\": null,\n \"tariff_code\": \"C-Non MD\"\n },\n \"created_at\": \"2024-11-07T13:15:00.000000Z\",\n \"updated_at\": \"2024-11-07T13:15:41.000000Z\",\n \"metadata\": {\n \"info\": {\n \"token\": \"3456-9100-6593-3916-8142-5721\",\n \"expiry_date\": null,\n \"units\": \"8.24 units\",\n \"serial_number\": \"50585520775663567444\",\n \"kct1\": \"\",\n \"kct2\": \"\"\n }\n },\n \"service\": {\n \"id\": 5,\n \"name\": \"Port Harcourt Electricity Distribution Company\",\n \"code\": \"PHED\",\n \"sort_code\": 5,\n \"description\": \"PHED (Port Harcourt Electricity)\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 1,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782564/PHEDC_um3epc.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n}"}],"_postman_id":"f7509893-1709-4bbb-a602-423c1e6667c4"},{"name":"Get Plans (CableTV)","id":"4db7f5d6-b72a-4e10-8330-aab340153094","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"STARTIMES\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services/plans","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["services","plans"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"b0c82092-560b-4e5b-bc57-80998b5f07c0","name":"Get Plans","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services/plans"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Oct 2024 09:20:43 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"transactions.fetch.success\",\n \"data\": [\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_1\",\n \"description\": \"1 Day\",\n \"amount\": 90\n },\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_2\",\n \"description\": \"1 Week\",\n \"amount\": 300\n },\n {\n \"name\": \"DTT (Antenna) Nova\",\n \"code\": \"DTT_NOVA_3\",\n \"description\": \"1 Month\",\n \"amount\": 900\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_1\",\n \"description\": \"1 Day\",\n \"amount\": 160\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_2\",\n \"description\": \"1 Week\",\n \"amount\": 600\n },\n {\n \"name\": \"DTT (Antenna) Basic\",\n \"code\": \"DTT_BASIC_3\",\n \"description\": \"1 Month\",\n \"amount\": 1700\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_1\",\n \"description\": \"1 Day\",\n \"amount\": 320\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_2\",\n \"description\": \"1 Week\",\n \"amount\": 1200\n },\n {\n \"name\": \"DTT (Antenna) Classic\",\n \"code\": \"DTT_CLASSIC_3\",\n \"description\": \"1 Month\",\n \"amount\": 2500\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_1\",\n \"description\": \"1 Day\",\n \"amount\": 90\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_2\",\n \"description\": \"1 Week\",\n \"amount\": 300\n },\n {\n \"name\": \"DTH (Dish) Decoder Nova\",\n \"code\": \"DTH_NOVA_3\",\n \"description\": \"1 Month\",\n \"amount\": 900\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_1\",\n \"description\": \"1 Day\",\n \"amount\": 200\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_2\",\n \"description\": \"1 Week\",\n \"amount\": 700\n },\n {\n \"name\": \"DTH (Dish) Smart\",\n \"code\": \"DTH_SMART_3\",\n \"description\": \"1 Month\",\n \"amount\": 2200\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_1\",\n \"description\": \"1 Day\",\n \"amount\": 400\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_2\",\n \"description\": \"1 Week\",\n \"amount\": 1500\n },\n {\n \"name\": \"DTH (Dish) Super\",\n \"code\": \" DTH_SUPER_3\",\n \"description\": \"1 Month\",\n \"amount\": 4200\n }\n ]\n}"}],"_postman_id":"4db7f5d6-b72a-4e10-8330-aab340153094"},{"name":"Validate Account (CableTV)","id":"38cfaa84-155e-4f5e-99a8-9869502c1c8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\",\r\n \"account\": \"45066912762\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/account/validate","description":"

Verify account details for different service types.

\n

Parameters:

\n
    \n
  • type (string): Specifies the service type for validation. Possible values include:
      \n
    • \"POWER\": Validates meter numbers for electricity services.
      • \n
    • \"AIRTIME\": Validates network providers for phone numbers (MTN, GLO, Airtel, 9Mobile).
      • \n
    • \"TV\": Validates decoder numbers for TV services.
      • \n
    • \"MONEY_TRANSFER\": Validates bank account numbers for money transfers.
      • \n
    • Additional service types can be added as needed.
      • \n
    \n
    • \n
  • account (string): possible values are account number (for money transfer), meter number (for disco or electricity), phone number (airtime or data) and decoder number (GOTV, DSTV and Startimes) to be validated.
    • \n
\n","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","account","validate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"3835ed27-2370-42b1-840b-c8d4cb208638","name":"Validate Account (CableTV)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\",\r\n \"account\": \"45066912762\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/account/validate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Oct 2024 10:10:12 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Account verification successful.\",\n \"data\": {\n \"service_type\": \"CABLETV\",\n \"service_code\": \"MULTICHOICE_GOTV\",\n \"account\": \"45066912762\",\n \"customernumber\": \"45066912762\",\n \"name\": \"John Doe\",\n \"accountstatus\": \"Open\",\n \"product_type\": \"PAY_TV\",\n \"invoice_period\": 1\n }\n}"}],"_postman_id":"38cfaa84-155e-4f5e-99a8-9869502c1c8b"},{"name":"Initiate Transaction (CableTV)","id":"25ac594b-aba3-45a1-ab98-b5f4d5ac2e11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"600\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\",\r\n \"package_code\": \"19\",\r\n \"client_reference\": \"SP-6777435543434233\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate","description":"

Start a new transaction upon confirmation of details.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 NameDescriptionTypePossible ValuesExample
amountSpecifies the amount for the transaction.Decimal numberN/A\"amount\": \"100.00\"
accountContains the account details for the transaction.StringAccount number, meter number, phone number, etc.\"account\": \"1234567890\"
typeSpecifies the type of transaction.String\"POWER\", \"MONEY_TRANSFER\", \"AIRTIME\", etc.\"type\": \"MONEY_TRANSFER\"
payment_channelSpecifies the payment channel for the transaction.String\"CARD\", \"WALLET\", \"BANK_TRANSFER\", etc.\"payment_channel\": \"CARD\"
\n
","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","transactions","initiate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"e3069746-dfae-41ca-a2a2-1b2f71942b23","name":"Initiate Transaction (CableTV)","originalRequest":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"600\",\r\n \"service_type\": \"CABLETV\",\r\n \"service_code\": \"MULTICHOICE_GOTV\",\r\n \"package_code\": \"19\",\r\n \"client_reference\": \"SP-6777435543434233\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 07 Nov 2024 13:17:14 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transaction was successful\",\n \"data\": {\n \"id\": 111,\n \"service_id\": 20,\n \"account\": \"08061372146\",\n \"total_amount\": \"600.00\",\n \"amount\": \"600.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"84680.00\",\n \"post_balance\": \"84080.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB149286524299691075429\",\n \"client_reference\": \"SP-6777435543434233\",\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"600\",\n \"service_type\": \"CABLETV\",\n \"service_code\": \"MULTICHOICE_GOTV\",\n \"package_code\": \"19\",\n \"client_reference\": \"SP-6777435543434233\",\n \"customer_number\": \"08061372146\",\n \"name\": \"John Doe\",\n \"account_status\": \"Open\",\n \"product_type\": \"PAY_TV\",\n \"invoice_period\": 1\n },\n \"created_at\": \"2024-11-07T13:17:00.000000Z\",\n \"updated_at\": \"2024-11-07T13:17:14.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 20,\n \"name\": \"GOTV\",\n \"code\": \"MULTICHOICE_GOTV\",\n \"sort_code\": 15,\n \"description\": \"Multichoice GOTV\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 1,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782507/GOTV_vbhhfv.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n}"}],"_postman_id":"25ac594b-aba3-45a1-ab98-b5f4d5ac2e11"},{"name":"Initiate Transaction (Airtime)","id":"04272799-0dc8-44ae-8e27-0dedd1f43659","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"10\",\r\n \"service_type\": \"AIRTIME\",\r\n \"service_code\": \"MTN_AIRTIME\",\r\n \"client_reference\": \"TXSP-45454345345663454543455555345344233\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate","description":"

Start a new transaction upon confirmation of details.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 NameDescriptionTypePossible ValuesExample
amountSpecifies the amount for the transaction.Decimal numberN/A\"amount\": \"100.00\"
accountContains the account details for the transaction.StringAccount number, meter number, phone number, etc.\"account\": \"1234567890\"
typeSpecifies the type of transaction.String\"POWER\", \"MONEY_TRANSFER\", \"AIRTIME\", etc.\"type\": \"MONEY_TRANSFER\"
payment_channelSpecifies the payment channel for the transaction.String\"CARD\", \"WALLET\", \"BANK_TRANSFER\", etc.\"payment_channel\": \"CARD\"
\n
","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","transactions","initiate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"45f871e2-9945-4102-805c-4b1779ff286e","name":"Initiate Transaction (Airtime)","originalRequest":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"10\",\r\n \"service_type\": \"AIRTIME\",\r\n \"service_code\": \"MTN_AIRTIME\",\r\n \"client_reference\": \"TXSP-454543453456634534534543455345344233\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 07 Nov 2024 13:15:07 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"58"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transaction was successful\",\n \"data\": {\n \"id\": 109,\n \"service_id\": 12,\n \"account\": \"08061372146\",\n \"total_amount\": \"10.00\",\n \"amount\": \"10.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"85190.00\",\n \"post_balance\": \"85180.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB151537963025561258302\",\n \"client_reference\": \"TXSP-454543453456634534534543455345344233\",\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"10\",\n \"service_type\": \"AIRTIME\",\n \"service_code\": \"MTN_AIRTIME\",\n \"client_reference\": \"TXSP-454543453456634534534543455345344233\"\n },\n \"created_at\": \"2024-11-07T13:15:00.000000Z\",\n \"updated_at\": \"2024-11-07T13:15:07.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 12,\n \"name\": \"MTN AIRTIME\",\n \"code\": \"MTN_AIRTIME\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n}"}],"_postman_id":"04272799-0dc8-44ae-8e27-0dedd1f43659"},{"name":"Get Plans (Data Bundles)","id":"3ee5a75a-874a-4164-b5a8-2604e9a67de2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"INTERNET\",\r\n \"service_code\": \"MTN_DATABUNDLE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services/plans","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["services","plans"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"f7120210-52ec-4acb-8816-3a53928d70c8","name":"Get Plans","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"service_type\": \"INTERNET\",\r\n \"service_code\": \"GLO_DATABUNDLE\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/services/plans"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Oct 2024 09:19:31 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"transactions.fetch.success\",\n \"data\": [\n {\n \"amount\": 50,\n \"code\": \"50\",\n \"short_description\": \"45MB + 5MB nite@N50 1day\",\n \"description\": \"45MB + 5MB Night for N50 valid for 1 day.\",\n \"validity\": \"Daily\"\n },\n {\n \"amount\": 100,\n \"code\": \"100\",\n \"short_description\": \"115Mb + 35MB nite@N100 1day\",\n \"description\": \"115Mb + 35MB Night for N100 valid for 1 day.\",\n \"validity\": \"Daily\"\n },\n {\n \"amount\": 1000,\n \"code\": \"1000\",\n \"short_description\": \"1.9GB + 1GB nite@N1000 1mnth\",\n \"description\": \"1.9GB + 1GB Night for N1000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 1500,\n \"code\": \"1500\",\n \"short_description\": \"3.5GB + 600MB nite@N1500 1mnth\",\n \"description\": \"3.5GB + 600MB Night for N1500 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 2000,\n \"code\": \"2000\",\n \"short_description\": \"5.2GB + 600MB nite@N2000 1mnth\",\n \"description\": \"5.2GB + 600MB Night for N2000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 2500,\n \"code\": \"2500\",\n \"short_description\": \"6.8GB + 900MB nite@N2500 1mnth\",\n \"description\": \"6.8GB + 900MB Night for N2500 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 3000,\n \"code\": \"3000\",\n \"short_description\": \"10GB +1GB nite@N3000 1mnth\",\n \"description\": \"10GB +1GB Night for N3000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 4000,\n \"code\": \"4000\",\n \"short_description\": \"14GB + 1GB nite@N4000 1mnth\",\n \"description\": \"14GB + 1GB Night for N4000 valid for 1 month. \",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 5000,\n \"code\": \"5000\",\n \"short_description\": \"20GB + 2GB nite@N5000 1mnth\",\n \"description\": \"20GB + 2GB Night for N5000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 8000,\n \"code\": \"8000\",\n \"short_description\": \"27.5GB + 2GB nite@N8000 1mnth\",\n \"description\": \"27.5GB + 2GB Night for N8000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 10000,\n \"code\": \"10000\",\n \"short_description\": \"46GB + 4GB@N10,000 1mnth\",\n \"description\": \"46GB + 4GB for N10,000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 15000,\n \"code\": \"15000\",\n \"short_description\": \"86GB + 7GB@N15,000 1mnth\",\n \"description\": \"86GB + 7GB for N15,000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 18000,\n \"code\": \"18000\",\n \"short_description\": \"109GB + 10GB@N18,000 1mnth\",\n \"description\": \"109GB + 10GB for N18,000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n },\n {\n \"amount\": 20000,\n \"code\": \"20000\",\n \"short_description\": \"126GB + 12GB@N20,000 1mnth\",\n \"description\": \"126GB + 12GB for N20,000 valid for 1 month.\",\n \"validity\": \"Monthly\"\n }\n ]\n}"}],"_postman_id":"3ee5a75a-874a-4164-b5a8-2604e9a67de2"},{"name":"Initiate Transaction (Internet)","id":"70c9743e-72e1-439f-97ad-023a3890def5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"600\",\r\n \"service_type\": \"INTERNET\",\r\n \"service_code\": \"MTN_DATABUNDLE\",\r\n \"bundle_code\": \"19\",\r\n \"client_reference\": \"SP-17774355434342344312\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate","description":"

Start a new transaction upon confirmation of details.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\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 NameDescriptionTypePossible ValuesExample
amountSpecifies the amount for the transaction.Decimal numberN/A\"amount\": \"100.00\"
accountContains the account details for the transaction.StringAccount number, meter number, phone number, etc.\"account\": \"1234567890\"
typeSpecifies the type of transaction.String\"POWER\", \"MONEY_TRANSFER\", \"AIRTIME\", etc.\"type\": \"MONEY_TRANSFER\"
payment_channelSpecifies the payment channel for the transaction.String\"CARD\", \"WALLET\", \"BANK_TRANSFER\", etc.\"payment_channel\": \"CARD\"
\n
","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}},"urlObject":{"path":["billers","transactions","initiate"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"9908b692-7edd-494e-9e50-ee7ab8c8cfb2","name":"Initiate Transaction (Internet)","originalRequest":{"method":"POST","header":[{"key":"pin","value":"U2FsdGVkX1/t3B4YWA5j1d4Zbxs8k0ajrt+voLGFL30=","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account\": \"08061372146\",\r\n \"payment_method\": \"WALLET_MAIN\",\r\n \"currency\": \"NGN\",\r\n \"amount\": \"600\",\r\n \"service_type\": \"INTERNET\",\r\n \"service_code\": \"MTN_DATABUNDLE\",\r\n \"bundle_code\": \"19\",\r\n \"client_reference\": \"SP-677743554343423443\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/billers/transactions/initiate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Host","value":"localhost:12000"},{"key":"Connection","value":"close"},{"key":"X-Powered-By","value":"PHP/8.2.16"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Thu, 07 Nov 2024 13:21:45 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"X-RateLimit-Limit","value":"60"},{"key":"X-RateLimit-Remaining","value":"59"},{"key":"Access-Control-Allow-Origin","value":"*"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"code\": 200,\n \"message\": \"Transaction was successful\",\n \"data\": {\n \"id\": 112,\n \"service_id\": 13,\n \"account\": \"08061372146\",\n \"total_amount\": \"600.00\",\n \"amount\": \"600.00\",\n \"transaction_fee\": \"0.00\",\n \"pre_balance\": \"84080.00\",\n \"post_balance\": \"83480.00\",\n \"currency\": \"NGN\",\n \"transaction_reference\": \"SWB169453847007229351700\",\n \"client_reference\": \"SP-677743554343423443\",\n \"channel\": null,\n \"demand_type\": null,\n \"remark\": null,\n \"transaction_type\": \"debit\",\n \"payment_method\": \"WALLET_MAIN\",\n \"payment_status\": \"paid\",\n \"status\": \"success\",\n \"req\": {\n \"account\": \"08061372146\",\n \"payment_method\": \"WALLET_MAIN\",\n \"currency\": \"NGN\",\n \"amount\": \"600\",\n \"service_type\": \"INTERNET\",\n \"service_code\": \"MTN_DATABUNDLE\",\n \"bundle_code\": \"19\",\n \"client_reference\": \"SP-677743554343423443\"\n },\n \"created_at\": \"2024-11-07T13:21:00.000000Z\",\n \"updated_at\": \"2024-11-07T13:21:45.000000Z\",\n \"metadata\": {\n \"info\": [],\n \"message\": \"Transaction was successful\"\n },\n \"service\": {\n \"id\": 13,\n \"name\": \"MTN DATA\",\n \"code\": \"MTN_DATABUNDLE\",\n \"sort_code\": 11,\n \"description\": \"MTN\",\n \"transaction_fee\": \"0.00\",\n \"status\": \"active\",\n \"requires_validation\": 0,\n \"image_url\": \"https://res.cloudinary.com/dap8inwop/image/upload/v1719782543/MTN_mucvpp.png\",\n \"created_at\": \"2024-11-06T11:53:48.000000Z\",\n \"updated_at\": \"2024-11-06T11:53:48.000000Z\"\n }\n }\n}"}],"_postman_id":"70c9743e-72e1-439f-97ad-023a3890def5"}],"id":"b0d8a765-4707-4949-a590-2fee48042c80","_postman_id":"b0d8a765-4707-4949-a590-2fee48042c80","description":"","auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"},"isInherited":true,"source":{"_postman_id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","id":"2f75b895-8d2b-4444-b0b1-9e8b6304296c","name":"Swita Merchant Documentation","type":"collection"}}}],"auth":{"type":"apikey","apikey":{"key":"","value":"{{api_key}}"}},"event":[{"listen":"prerequest","script":{"id":"698cb78d-a01d-4e62-901a-675e66beeeea","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"2ac51eab-83cc-468f-b5bb-8884f5638599","type":"text/javascript","packages":{},"exec":[""]}}]}