{"info":{"_postman_id":"ad94fefa-7fd0-4ee0-a6c9-f654ffbb0279","name":"PinnaView Web Api (Documentation)","description":"

Request Basics

All requests need to pass Authentication token in the headers like this.

Make sure you pass Content-Type : application/json , Accept : application/json , and Authorization: api token headers
\n
If you want to create object use POST method with JSON body.
\n

If you want to retrieve object - use GET request.

3. Platform responds with very useful response headers, that you as a developer might wish to log

Note: you can get your token via API Settings [available to agent user only, for now.].

Remember api tokens are long-lived.

PinnaView WEBHOOK

The PinnaView REST APIs use webhooks for transactions notification. Webhooks are HTTP callbacks that contains notification messages for transactions. When you generate an api token, you can create add a webhook url on which you will receive the transactions update notifications.

SAMPLE PHP CODE TO VERIFY WEBHOOK SIGNATURE

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"9698276","collectionId":"ad94fefa-7fd0-4ee0-a6c9-f654ffbb0279","publishedId":"2s8YepsYHS","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-07-07T15:40:36.000Z"},"item":[{"name":"Account Information","item":[{"name":"My Account","id":"67024c8f-3454-488f-9e5e-8135f86ee21b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"name\": \"name\",\n \"email\": \"email\",\n \"account_balance\": {\n \"balance\": \"balance\",\n \"commission\": \"commission\"\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/my-account","description":"

This folder contains endpoint to get your account information.

\n","urlObject":{"protocol":"https","path":["api","v1","my-account"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"dbc6bbb4-d95c-40b4-9d20-83bc3ca7c4c4","name":"My Account","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text","disabled":true}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/my-account"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"name\": \"name\",\n \"email\": \"email\",\n \"account_balance\": {\n \"balance\": \"balance\",\n \"commission\": \"commission\"\n }\n }\n}"}],"_postman_id":"67024c8f-3454-488f-9e5e-8135f86ee21b"}],"id":"791c48e1-cc44-48e0-82d9-44c0724ee173","_postman_id":"791c48e1-cc44-48e0-82d9-44c0724ee173","description":""},{"name":"Data Bundle","item":[{"name":"Get Data Bundle Providers","id":"df8993cb-af6f-4a3d-879f-3d07ae1a8504","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Data Bunble Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\" : \"provider_info\"\n },\n {\n \"provider_name\": \"Data Bunble Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\" : \"provider_info\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/data-bundle","description":"

This request consist of available Data Bundle providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","data-bundle"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"6014b543-8451-457c-808f-d7e0510719fb","name":"Get Data Bundle Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","name":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/data-bundle"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Data Bunble Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\": \"provider_info\"\n },\n {\n \"provider_name\": \"Data Bunble Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\": \"provider_info\"\n }\n ]\n}"}],"_postman_id":"df8993cb-af6f-4a3d-879f-3d07ae1a8504"},{"name":"Get Data Bundle Packages","id":"7d505830-fe8b-4562-af55-df052b03c7bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }} ","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Data Bundle Package 1\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Data Bundle Package 2\",\n \"package_amount\": {{ amount }},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/packages","description":"

This
request consist of available packages for Data Bundle. Please note the
unique package code of each package, you will need it to perform
subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","packages"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"74d4ec1b-8d17-4b04-9769-89882385f36f","name":"Get Data Bundle Packages","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }} ","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"}]},"url":"https://pinnaview.com/api/v1/packages"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Data Bundle Package 1\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n },\n {\n \"package_name\": \"Data Bundle Package 2\",\n \"package_amount\": {{ amount }},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]"}],"_postman_id":"7d505830-fe8b-4562-af55-df052b03c7bd"},{"name":"Buy Data Bundle","id":"721a18cb-5f6e-4132-a637-3a408896ef7c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://pinnaview.com/api/v1/buy","description":"

This request endpoint enables you to buy Data Bundle.

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

package_code -- Package code

reference -- (Merchant's Unique reference for the transaction.)

transaction_pin -- Your PinnaView account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"721a18cb-5f6e-4132-a637-3a408896ef7c"}],"id":"8a4a7b5d-57e0-42c9-b45d-2530e031b0d9","_postman_id":"8a4a7b5d-57e0-42c9-b45d-2530e031b0d9","description":""},{"name":"Airtime TopUp","item":[{"name":"Get Airtime TopUp","id":"ed8468f8-9ebf-4a17-a693-82ec99476e59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Airtime Provider 1\",\n \"provider_code\": \"uniqiue_provider_code\",\n \"min_amount\" : \"min_amount\",\n \"max_amount\" : \"max_amount\",\n \"provider_info\" : \"provider_info\"\n },\n {\n \"provider_name\": \"Airtime Provider 2\",\n \"provider_code\": \"uniqiue_provider_code\",\n \"min_amount\" : \"min_amount\",\n \"max_amount\" : \"max_amount\",\n \"provider_info\" : \"provider_info\"\n }\n ]","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/airtime-topup","description":"

This
request consist of available airtime providers. Please note the unique
provider code of each provider, you will need it to perform subsequent
transactions

\n","urlObject":{"protocol":"https","path":["api","v1","airtime-topup"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"20e74dcf-03cf-4aa9-882a-89a181281157","name":"Get Airtime TopUp","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://pinnaview.com/api/v1/airtime-topup"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Airtime Provider 1\",\n \"provider_code\": \"uniqiue_provider_code\",\n \"min_amount\" : \"min_amount\",\n \"max_amount\" : \"max_amount\",\n \"provider_info\" : \"provider_info\"\n },\n {\n \"provider_name\": \"Airtime Provider 2\",\n \"provider_code\": \"uniqiue_provider_code\",\n \"min_amount\" : \"min_amount\",\n \"max_amount\" : \"max_amount\",\n \"provider_info\" : \"provider_info\"\n }\n ]"}],"_postman_id":"ed8468f8-9ebf-4a17-a693-82ec99476e59"},{"name":"Buy Airtime TopUp","id":"b0d44689-6fe4-4fe8-aaae-646607e7434d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://pinnaview.com/api/v1/buy","description":"

This request endpoint enables you to buy Airtime TopUp.

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

reference -- (Merchant's Unique reference for the transaction.)

amount -- Amount

transaction_pin -- Your PinnaView account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"b0d44689-6fe4-4fe8-aaae-646607e7434d"}],"id":"e095a285-e3f1-4a99-ac0b-a252b06e382c","_postman_id":"e095a285-e3f1-4a99-ac0b-a252b06e382c","description":""},{"name":"Cable Tv Subscription","item":[{"name":"Get Cable TV Providers","id":"be062a60-2308-45f0-8036-03da4b798ef0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_image\": \"image\",\n \"provider_name\": \"Cable TV Package 1\",\n \"provider_code\": \"uniqiue_provider_code\"\n },\n {\n \"provider_image\": \"image\",\n \"provider_name\": \"Cable TV Package 1\",\n \"provider_code\": \"uniqiue_provider_code\"\n }\n ]\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/cable-tv-subscription","description":"

This request consists of Cable TV API endpoint

\n","urlObject":{"protocol":"https","path":["api","v1","cable-tv-subscription"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"ae63937f-cc80-42db-a16b-7298c76aa788","name":"Get Cable TV Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://pinnaview.com/api/v1/cable-tv-subscription"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_image\": \"image\",\n \"provider_name\": \"Cable TV Package 1\",\n \"provider_code\": \"uniqiue_provider_code\"\n },\n {\n \"provider_image\": \"image\",\n \"provider_name\": \"Cable TV Package 1\",\n \"provider_code\": \"uniqiue_provider_code\"\n }\n ]\n}"}],"_postman_id":"be062a60-2308-45f0-8036-03da4b798ef0"},{"name":"Get Cable Tv Packages","id":"7c797a2f-990b-4f55-98dc-4d2a1a33bd6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Cable TV Package 1\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n },\n {\n \"package_name\": \"Cable TV Package 2\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/packages","description":"

This
request consist of available packages for Cable TV. Please note the
unique package code of each package, you will need it to perform
subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","packages"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"64995ec6-1209-48e8-ba3d-5249fdd4c7b3","name":"Get Cable Tv Packages","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/x-www-form-urlencoded","type":"text","disabled":true}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"}]},"url":"https://pinnaview.com/api/v1/packages"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Cable TV Package 1\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n },\n {\n \"package_name\": \"Cable TV Package 2\",\n \"package_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n }\n ]\n}"}],"_postman_id":"7c797a2f-990b-4f55-98dc-4d2a1a33bd6a"},{"name":"Buy Cable TV","id":"17d2e321-5174-4a7f-a924-feaca310f20c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://pinnaview.com/api/v1/buy","description":"

This request endpoint enables you to buy Cable TV

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

package_code -- Package code

reference -- (Merchant's Unique reference for the transaction.)

transaction_pin -- Your PinnaView account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"17d2e321-5174-4a7f-a924-feaca310f20c"}],"id":"6bea989d-b58b-4a54-b18e-b330e1f74561","_postman_id":"6bea989d-b58b-4a54-b18e-b330e1f74561","description":""},{"name":"Electricity Bill","item":[{"name":"Get Electricity Bill Providers","id":"4feb23a4-16ff-4509-b004-afc09d8636ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Elecricity Bill Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": \"min_amount\",\n \"max_amount\": \"max_amount\"\n },\n {\n \"provider_name\": \"Elecricity Bill Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": \"min_amount\",\n \"max_amount\": \"max_amount\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/electricity-bill","description":"

This
request consist of available Electricity Bill providers. Please note
the unique provider_code of each provider, you will need it to perform
subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","electricity-bill"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"da5804d5-93a8-4371-974d-88e1a5f628ce","name":"Get Electricity Bill Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":""},"url":"https://pinnaview.com/api/v1/electricity-bill"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Elecricity Bill Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": \"min_amount\",\n \"max_amount\": \"max_amount\"\n },\n {\n \"provider_name\": \"Elecricity Bill Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"min_amount\": \"min_amount\",\n \"max_amount\": \"max_amount\"\n }\n ]\n}"}],"_postman_id":"4feb23a4-16ff-4509-b004-afc09d8636ec"},{"name":"Buy Electricity Bill","id":"967b1fa7-7fcb-49cb-99f9-42f74b4e3348","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://pinnaview.com/api/v1/buy","description":"

This request endpoint enables you to buy Electricity Bill

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

reference -- (Merchant's Unique reference for the transaction.)

amount -- Amount

transaction_pin -- Your PinnaView account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"967b1fa7-7fcb-49cb-99f9-42f74b4e3348"}],"id":"cd8aa372-2e7b-4c5a-8c75-a589d18e1e42","_postman_id":"cd8aa372-2e7b-4c5a-8c75-a589d18e1e42","description":""},{"name":"Transactions","item":[{"name":"Get All Transactions","id":"b0080178-ab2e-4344-b7d8-fc213e762085","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"transaction_data\": [\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n },\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/transactions","description":"

This endpoint is used to fetch a transaction.

Below are the responses example :

reference -- reference

your reference -- your reference

provider -- Provider Name

recipient -- The Recipient

status -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund, Failed

amount_paid - The total amount paid for the transaction

package -- Package name

\n","urlObject":{"protocol":"https","path":["api","v1","transactions"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"d7f7d678-f788-497b-b67b-ab05f9c80da6","name":"Get All Transactions","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://pinnaview.com/api/v1/transactions"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"transaction_data\": [\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n },\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n }\n ]\n }\n}"}],"_postman_id":"b0080178-ab2e-4344-b7d8-fc213e762085"},{"name":"ReQuery A Transaction","id":"82ce2a38-ae4d-4795-99e0-2b45b2fe287d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"transaction_data\": [\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n }\n ]\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/requery","description":"

This endpoint is used to requery a transaction.

Below are the responses example :

reference -- reference

your reference -- your reference

provider -- Provider Name

recipient -- The Recipient

status -- Order Status which can be any of these : Pending, Completed, Processing, Cancelled, Refund, Failed

amount_paid - The total amount paid for the transaction

package -- Package name

\n","urlObject":{"protocol":"https","path":["api","v1","requery"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"590b5312-1ae5-4985-9972-4a1e7ada3255","name":"ReQuery A Transaction","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"reference","value":"{{ reference }}","type":"text"}]},"url":"https://pinnaview.com/api/v1/requery"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"{{message}}\",\n \"data\": {\n \"transaction_data\": [\n {\n \"package\": \"{{package}}\",\n \"provider\": \"{{provider}}\",\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"description\": \"{{description}}\",\n \"reference\": \"{{reference}}\",\n \"your_ref\": {{your_ref}},\n \"status\": \"{{status}}\",\n \"meter_token\": \"{{meter_token}}\",\n \"meter_unit\": \"{{meter_unit}}\",\n \"date\": \"{{date}}\"\n }\n ]\n }\n}"}],"_postman_id":"82ce2a38-ae4d-4795-99e0-2b45b2fe287d"}],"id":"a1119e45-906e-4ad0-bca9-6109afb87220","_postman_id":"a1119e45-906e-4ad0-bca9-6109afb87220","description":""},{"name":"Validation","item":[{"name":"Provider Recipient Validation","id":"e3d78be8-45a8-47e6-ba7a-4d6a6152f46f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"verified\": true,\n \"message\": \"Verified {{provider}}\"\n }\n}\n\n","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/validation","urlObject":{"protocol":"https","path":["api","v1","validation"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"81adff28-7f2b-4b29-a5c7-4f244cfc83df","name":"Provider Recipient Validation","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"{{ access_token }}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"}]},"url":"https://pinnaview.com/api/v1/validation"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"verified\": true,\n \"message\": \"Verified {{provider}}\"\n }\n}"}],"_postman_id":"e3d78be8-45a8-47e6-ba7a-4d6a6152f46f"}],"id":"248aef1e-cfb5-4bf9-88e6-b0ac3814dc57","description":"

This folder consists of endpoints for validation of recipients

\n","_postman_id":"248aef1e-cfb5-4bf9-88e6-b0ac3814dc57"},{"name":"Datashare","item":[{"name":"Get Datashare Providers","id":"bc5898f9-2b1f-4fea-849b-68ee91cf53b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"provider_name\": \"Data Bunble Provider 1\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\" : \"provider_info\",\n },\n {\n \"provider_name\": \"Data Bunble Provider 2\",\n \"provider_code\": \"unique_provider_code\",\n \"provider_info\" : \"provider_info\",\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/datashare","description":"

This request consist of available Datashare providers. Please note the unique provider_code of each provider, you will need it to perform subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","datashare"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"b4f77788-6313-4022-adf2-3b58d3f1a941","name":"Get Datashare Providers","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"url":"https://pinnaview.com/api/v1/datashare"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"bc5898f9-2b1f-4fea-849b-68ee91cf53b5"},{"name":"Get Datashare Packages","id":"6319bd19-25ed-49fa-bdbc-c2747c31dda8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": [\n {\n \"package_name\": \"Data Bundle Package 1\",\n \"package_amount\": {{amount}},\n \"package_original_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\",\n \"min_quantity\" : \"min_quantity\",\n \"max_quantity\" : \"max_quantity\"\n },\n {\n \"package_name\": \"Data Bundle Package 2\",\n \"package_amount\": {{ amount }},\n \"package_original_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\",\n \"min_quantity\" : \"min_quantity\",\n \"max_quantity\" : \"max_quantity\"\n }\n ]","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/datashare-packages","description":"

This request consist of available packages for Datashare. Please note the
unique package code of each package, you will need it to perform
subsequent transactions

\n","urlObject":{"protocol":"https","path":["api","v1","datashare-packages"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"34310d11-be28-4d73-a852-bd5348cfe190","name":"Get Datashare Packages","originalRequest":{"method":"POST","header":[{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"}],"options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/datashare-packages"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"6319bd19-25ed-49fa-bdbc-c2747c31dda8"},{"name":"Check DataShare Delivery Status","id":"6cee3020-9bb6-4b2d-865c-7903eb72609a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer : {{ access_token }}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"transaction_data\": {\n \"provider\": \"provider\",\n \"package\": \"package\",\n \"recipient\": \"recipient\",\n \"status\": \"status\",\n \"reference\": \"reference\"\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://pinnaview.com/api/v1/datashare-delivery-status","description":"

This endpoint is used to requery a datashare transaction pin.

Below are the responses example :

recipient -- recipient

reference -- reference

your reference -- your reference

provider -- Provider Name

serial_number -- Serial Number

status -- Order Status which can be any of these : Used, Unsed

package -- Package name

\n","urlObject":{"protocol":"https","path":["api","v1","datashare-delivery-status"],"host":["pinnaview","com"],"query":[],"variable":[]}},"response":[{"id":"ad9254e7-27ca-4b1f-8965-3987cf2526dd","name":"Check DataShare Delivery Status","originalRequest":{"method":"POST","header":[{"warning":"This is a duplicate header and will be overridden by the Authorization header generated by Postman.","key":"Authorization","value":"Bearer : {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"serial_number","value":"{{ serial_number }}","type":"text"}]},"url":"https://pinnaview.com/api/v1/datashare-delivery-status"},"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"6cee3020-9bb6-4b2d-865c-7903eb72609a"}],"id":"064f510a-e8cf-4666-9366-860d651392d1","_postman_id":"064f510a-e8cf-4666-9366-860d651392d1","description":""}]}