{"info":{"_postman_id":"7d7cc421-a4fb-4705-b5fd-1599bda50539","name":"ChokeBills API Documentation","description":"

Pay Lifestyle bills and manage your finances at ease

Chokebills provides RESTFUL API based on simple HTTP GET/POST requests. Our open APIs lets your customers do the following:

Purchase airtime
\n
Purchase Internet data
\n
Save for a target
\n
Pay electricity bills ( Prepaid / Postpaid )
\n
Pay Cable Subscription ( GOTV, DSTV, Startimes)
\n
Fund your betting wallet
\n
Send Bulk SMS
\n
Pay Educational voucher ( JAMB, NECO, etc)
\n
Print Recharge Cards
\n
Convert excess airtime to cash
\n
Pay Insurrance
\n
Make financial verifications...
\n

Access the tools and resources you need to offer services similar to our platform.

*To Get Started*

Create an account on chokebills and complete your KYC, this literally should take less than a minute.

After then your profile setting page on to get the token.

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

Remember api tokens are long-lived.

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

Environment	Base URL
API EndPoint	https://chokebills.com/api/v1/endpoint

chokebills WEBHOOK

The chokebills 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 Transaction Payload

On chokebills, Webhooks can be configured for transactions. When a transaction is completed, a POST HTTP request is sent to the URL you have configured. The HTTP payload will contain
Hook Structure

SAMPLE PHP CODE TO VERIFY WEBHOOK SIGNATURE

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25130238","collectionId":"7d7cc421-a4fb-4705-b5fd-1599bda50539","publishedId":"2sA3kYhKCT","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-07-25T12:57:44.000Z"},"item":[{"name":"Account Information","item":[{"name":"My Account","id":"72a09093-737d-45bd-a984-50904e7e7d2b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"0d97b0df-c9fa-4c04-a50e-7bd40f59f53a","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","value":"application/json","type":"text","disabled":true}],"url":"https://chokebills.com/api/v1/my-account"},"_postman_previewlanguage":"json","header":[{"key":"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":"72a09093-737d-45bd-a984-50904e7e7d2b"}],"id":"7662d83e-fc82-4d95-ace3-1ba14214eab2","_postman_id":"7662d83e-fc82-4d95-ace3-1ba14214eab2","description":""},{"name":"Data Bundle","item":[{"name":"Get Data Bundle Providers","id":"a6edcdef-4012-4feb-a5d8-d61624d293f4","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-type":true}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{ access_token }}"},{"key":"Accept","value":"application/json"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"13f0291a-9303-476c-83dd-35dac141f190","name":"Get Data Bundle Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://chokebills.com/api/v1/data-bundle"},"_postman_previewlanguage":"json","header":[{"key":"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":"a6edcdef-4012-4feb-a5d8-d61624d293f4"},{"name":"Get Data Bundle Packages","id":"6662c114-793c-4e2b-ab72-fd22ab1edb68","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }} "}],"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 },\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 }\n ]","options":{"raw":{"language":"json"}}},"url":"https://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"b34aecbc-19ae-462d-8a02-c4665c7c3c83","name":"Get Data Bundle Packages","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }} ","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"}]},"url":"https://chokebills.com/api/v1/packages"},"_postman_previewlanguage":"json","header":[{"key":"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_original_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_original_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\": \"provider_code\"\n }\n ]"}],"_postman_id":"6662c114-793c-4e2b-ab72-fd22ab1edb68"},{"name":"Buy Data Bundle","id":"3d3b557b-ef9c-484b-9fbe-99a5bf65938b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.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.)

account_pin -- Your Padiwise account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"ea978ced-18a2-43b6-812a-81f3dd44c066","name":"Buy Data Bundle","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"recipient","value":"{{ recipient }}","type":"text"},{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"},{"key":"package_code","value":"{{ package_code }}","type":"text"},{"key":"reference","value":"{{ reference }}","type":"text"},{"key":"account_pin","value":"{{ account_pin }}","type":"text"}],"options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}"}],"_postman_id":"3d3b557b-ef9c-484b-9fbe-99a5bf65938b"}],"id":"6efc8f01-7c91-4a6d-a8c8-8004363bac70","_postman_id":"6efc8f01-7c91-4a6d-a8c8-8004363bac70","description":""},{"name":"Airtime TopUp","item":[{"name":"Get Airtime TopUp","id":"92a1b91f-0cf9-4657-9eaf-b36e64ac93bf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"Bearer {{ access_token }}"},{"key":"Accept","value":"application/json"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"0c8a5184-8dcb-46ab-a0a6-6ef98af8aa02","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://chokebills.com/api/v1/airtime-topup"},"_postman_previewlanguage":"json","header":[{"key":"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":"92a1b91f-0cf9-4657-9eaf-b36e64ac93bf"},{"name":"Buy Airtime TopUp","id":"f0490419-44f9-40ca-9904-66852e308551","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy","description":"

This request endpoint enables you to buy Airtime TopUp.

provider_code -- Provider Code

recipient -- Recipient

amount -- Amount

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

account_pin -- Your Padiwise account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"3f0f2441-3f38-4eaf-a12e-d97030d1814b","name":"Buy Airtime TopUp","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"account_pin","value":"{{ account_pin }}","type":"text"},{"key":"amount","value":"{{ amount }}","type":"text"},{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"}]},"url":"https://chokebills.com/api/v1/buy"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}"}],"_postman_id":"f0490419-44f9-40ca-9904-66852e308551"}],"id":"5da1c31d-5496-4b52-a2ee-01cc6a1ac903","_postman_id":"5da1c31d-5496-4b52-a2ee-01cc6a1ac903","description":""},{"name":"Cable Tv Subscription","item":[{"name":"Get Cable TV Providers","id":"6e5dde84-aa65-4c47-abc9-48dc74b3dbb2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"bf3ea615-0026-48cc-93fa-01177a5a6d38","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://chokebills.com/api/v1/cable-tv-subscription"},"_postman_previewlanguage":"json","header":[{"key":"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":"6e5dde84-aa65-4c47-abc9-48dc74b3dbb2"},{"name":"Get Cable Tv Packages","id":"0c690eef-4d9b-45e8-9d72-e1fc374dc6b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Authorization","value":"Bearer {{ access_token }}"},{"key":"Accept","value":"application/json"}],"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_original_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_original_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"b9155cc3-22ac-40c7-b7a1-4a301b81d7d6","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","value":"application/x-www-form-urlencoded","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"}]},"url":"https://chokebills.com/api/v1/packages"},"_postman_previewlanguage":"json","header":[{"key":"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_original_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_original_amount\": {{amount}},\n \"package_code\": \"unique_package_code\",\n \"provider_code\" : \"provider_code\"\n }\n ]\n}"}],"_postman_id":"0c690eef-4d9b-45e8-9d72-e1fc374dc6b1"},{"name":"Buy Cable Tv","id":"4d8ce877-33a6-441b-930a-cb69f9c4639d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy","description":"

This request endpoint enables you to buy Cable Tv Subscription.

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

package_code -- Package code

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

account_pin -- Your Padiwise account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"5ba50a7d-12eb-4c0b-839d-65da5d840843","name":"Buy Cable Tv","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"account_pin","value":"{{ account_pin }}","type":"text"},{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"},{"key":"package_code","value":"{{ package_code }}","type":"text"},{"key":"reference","value":"{{ reference }}","type":"text"}],"options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}"}],"_postman_id":"4d8ce877-33a6-441b-930a-cb69f9c4639d"}],"id":"9932540c-8450-4a19-ace1-c61d14b737ff","_postman_id":"9932540c-8450-4a19-ace1-c61d14b737ff","description":""},{"name":"Electricity Bill","item":[{"name":"Get Electricity Bill Providers","id":"9f093391-711a-4e4c-910d-bd462f075aa4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"113516dc-756b-473f-bf5f-40cd715988fe","name":"Get Electricity Bill Providers","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://chokebills.com/api/v1/electricity-bill"},"_postman_previewlanguage":"json","header":[{"key":"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":"9f093391-711a-4e4c-910d-bd462f075aa4"},{"name":"Buy Electricity Bill","id":"dd0f9d0f-7c1d-4ae6-abf6-6b1ddcc8e3f8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy","description":"

This request endpoint enables you to buy Electricity Bill.

provider_code -- Provider Code

recipient -- Recipient

amount -- Amount

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

account_pin -- Your Padiwise account pin

\n","urlObject":{"protocol":"https","path":["api","v1","buy"],"host":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"14fce2dc-0e9c-45d6-8f51-752a6ef38672","name":"Buy Electricity Bill","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"status\": true,\n \"message\": \"success\",\n \"data\": {\n \"status\": true,\n \"message\": \"Transaction Sent For {{status}} . N{{amount}} {{provider}} Recipient : {{recipient}} \",\n \"transaction_data\": {\n \"reference\": \"{{reference}}\",\n \"status\": \"{{status}}\",\n \"package\": {{package}},\n \"provider\" : {{provider}},\n \"recipient\": \"{{recipient}}\",\n \"amount_paid\": {{amount_paid}},\n \"commission\" : {{commission}}\n }\n }\n}","options":{"raw":{"language":"json"}}},"url":"https://chokebills.com/api/v1/buy"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"dd0f9d0f-7c1d-4ae6-abf6-6b1ddcc8e3f8"}],"id":"aa4238dc-2d7e-4fbd-9c9e-cba3a2bdbfd5","_postman_id":"aa4238dc-2d7e-4fbd-9c9e-cba3a2bdbfd5","description":""},{"name":"Transactions","item":[{"name":"Get All Transactions","id":"74950a82-754a-424a-9e8b-f8e9dab58ac6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"ef48cfa1-35e0-4ee9-a50a-c3767beb7096","name":"Get All Transactions","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"url":"https://chokebills.com/api/v1/transactions"},"_postman_previewlanguage":"json","header":[{"key":"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":"74950a82-754a-424a-9e8b-f8e9dab58ac6"},{"name":"ReQuery A Transaction","id":"66885ea8-197f-4bb8-bd4f-60c23931dcd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"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://chokebills.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":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"18bff393-c68c-4114-8795-0c66e0104e9c","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://chokebills.com/api/v1/requery"},"_postman_previewlanguage":"json","header":[{"key":"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":"66885ea8-197f-4bb8-bd4f-60c23931dcd9"}],"id":"0575a1f6-4fa4-4cd4-a611-d2e8883a6315","_postman_id":"0575a1f6-4fa4-4cd4-a611-d2e8883a6315","description":""},{"name":"Validations","item":[{"name":"Provider Recipient Validation","id":"fe1d23a5-6749-4ce4-83f7-964501bed871","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"Accept","value":"application/json"},{"key":"Authorization","value":"Bearer {{ access_token }}"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"}]},"url":"https://chokebills.com/api/v1/validation","description":"

This request endpoints is for validation of recipients

Below are the request body parameters :

provider_code -- Provider Code

recipient -- Recipient

\n","urlObject":{"protocol":"https","path":["api","v1","validation"],"host":["chokebills","com"],"query":[],"variable":[]}},"response":[{"id":"43ee84b5-401d-4082-b6b9-62e3bc498764","name":"Provider Recipient Validation","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{ access_token }}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"provider_code","value":"{{ provider_code }}","type":"text"},{"key":"recipient","value":"{{ recipient }}","type":"text"}]},"url":"https://chokebills.com/api/v1/validation"},"_postman_previewlanguage":"json","header":[{"key":"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\": \"{{message}}\"\n }\n}"}],"_postman_id":"fe1d23a5-6749-4ce4-83f7-964501bed871"}],"id":"59f1becf-1077-4b02-9e46-ecaa5758e187","_postman_id":"59f1becf-1077-4b02-9e46-ecaa5758e187","description":""}]}