{"id":3016,"date":"2018-08-01T09:07:34","date_gmt":"2018-08-01T09:07:34","guid":{"rendered":"http:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/php\/"},"modified":"2021-09-06T09:59:21","modified_gmt":"2021-09-06T09:59:21","slug":"php","status":"publish","type":"docs","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/php\/","title":{"rendered":"PHP"},"content":{"rendered":"<h1>B2C-Billers-PHP<\/h1>\n<p><a href=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2018\/08\/b2c_billers_php-master.zip\" rel=\"nofollow\">Download Library<\/a><\/p>\n<p>This repository contains Java SDK and samples for Business to Consumer bill payments.<\/p>\n<h2><a id=\"user-content-prerequisites\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#prerequisites\" aria-hidden=\"true\"><\/a>Prerequisites<\/h2>\n<ul>\n<li>PHP 5+ or PHP 7<\/li>\n<\/ul>\n<h1><a id=\"user-content-welcome\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#welcome\" aria-hidden=\"true\"><\/a>Welcome<\/h1>\n<h5><a id=\"user-content-read-our-faqs-here\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#read-our-faqs-here\" aria-hidden=\"true\"><\/a><a href=\"https:\/\/github.com\/techquest\/b2c-billers-java\/wiki\/FAQ\">Read our FAQs here<\/a><\/h5>\n<h3><a id=\"user-content-biller\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#biller\" aria-hidden=\"true\"><\/a>Biller<\/h3>\n<p>A biller is any Organization\/Institution\/Business that is able to exchange services for a fee. e.g Telecoms provider(Airtel, Glo, MTN), Government Body(Lagos State) etc.<\/p>\n<h3><a id=\"user-content-category\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#category\" aria-hidden=\"true\"><\/a>Category<\/h3>\n<p>Billers are grouped under categories. For instance, all cable providers(DSTV, GOTV) can e grouped under a\u00a0<code>cable<\/code>\u00a0Category.<\/p>\n<h3><a id=\"user-content-customer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#customer\" aria-hidden=\"true\"><\/a>Customer<\/h3>\n<p>An individual that has an intent and\/or pays for any of the services offered by a Biller.<\/p>\n<h3><a id=\"user-content-paymentitem\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#paymentitem\" aria-hidden=\"true\"><\/a>PaymentItem<\/h3>\n<p>A biller(e.g DSTV) can offer different services and hence different prices for them. Each of those services, falls under a payment-item and has a unique payment-item-code. We say that a user has intent to pay for a payment-item offered by a Biller. An example of a payment-item under DSTV is the\u00a0<code>DSTV Premium Bouquet<\/code><\/p>\n<h1><a id=\"user-content-what-this-sdk-provides-for-you\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#what-this-sdk-provides-for-you\" aria-hidden=\"true\"><\/a>What this SDK provides for you<\/h1>\n<h3><a id=\"user-content-get-all-billers\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#get-all-billers\" aria-hidden=\"true\"><\/a>Get All Billers<\/h3>\n<pre><code>Get a list of all billers supported on our platform.\n<\/code><\/pre>\n<h3><a id=\"user-content-get-all-categorys\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#get-all-categorys\" aria-hidden=\"true\"><\/a>Get All Categorys<\/h3>\n<pre><code>Get a list of all categorys and associated billers supported on our platform.\n<\/code><\/pre>\n<h3><a id=\"user-content-get-all-billers-under-a-category\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#get-all-billers-under-a-category\" aria-hidden=\"true\"><\/a>Get All Billers under a Category<\/h3>\n<pre><code>Get a list of all biilers under a particular category.\n<\/code><\/pre>\n<h3><a id=\"user-content-get-biller-payment-items\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#get-biller-payment-items\" aria-hidden=\"true\"><\/a>Get Biller Payment Items<\/h3>\n<pre><code>Get a list of all payment-items under aparticular Biller.\n<\/code><\/pre>\n<h3><a id=\"user-content-validate-customer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#validate-customer\" aria-hidden=\"true\"><\/a>Validate Customer<\/h3>\n<pre><code>Validates a customer-id under a particular biller.\n<\/code><\/pre>\n<h3><a id=\"user-content-make-payment-for-a-customer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#make-payment-for-a-customer\" aria-hidden=\"true\"><\/a>Make payment for a customer<\/h3>\n<pre><code>Makes a payment for a payment-item for a particular customer.\n<\/code><\/pre>\n<h3><a id=\"user-content-query-the-status-of-a-transaction\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#query-the-status-of-a-transaction\" aria-hidden=\"true\"><\/a>Query the status of a transaction<\/h3>\n<pre><code>Query the status of a transaction made in the past based on the Request Reference\n<\/code><\/pre>\n<h1><a id=\"user-content-quick-start\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#quick-start\" aria-hidden=\"true\"><\/a>Quick start<\/h1>\n<h4><a id=\"user-content-composer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#composer\" aria-hidden=\"true\"><\/a>Composer<\/h4>\n<pre><code>\"interswitch\/interswitch\": \"dev-master\"\n<\/code><\/pre>\n<pre><code>composer require interswitch\/interswitch:dev-master\n<\/code><\/pre>\n<h4><a id=\"user-content-samples\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#samples\" aria-hidden=\"true\"><\/a>Samples<\/h4>\n<p>Check out the samples folder for sample code on all the features above.<\/p>\n<h4><a id=\"user-content-support-team\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_php#support-team\" aria-hidden=\"true\"><\/a>Support Team<\/h4>\n<p>Still experiencing issues, quickly talk to our Engineers at\u00a0<a href=\"https:\/\/interswitch.slack.com\/messages\/C4ULTK04T\/\" rel=\"nofollow\">Support chat<\/a>\u00a0or\u00a0<a href=\"https:\/\/gitter.im\/techquest\" rel=\"nofollow\">Support chat<\/a>\u00a0and get your issues fixed in a giffy<\/p>\n<h1>B2C-Funds-Transfer-PHP<\/h1>\n<p><a href=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2018\/08\/b2c-funds-transfer-php-master.zip\" rel=\"nofollow\">Download Library<\/a><\/p>\n<pre class=\"\"><code>&lt;?php\n    use Interswitch\\Interswitch;\n    use Interswitch\\transfer\\fundtransfer;\n    use Interswitch\\transfer\\transferrequestbuilder;\n    require_once __DIR__ . '\/..\/vendor\/autoload.php';\n\n    $initiatingEntityCode = \"PBL\";\n    \/\/test clientId and clientSecret\n    \/\/$clientId = \"IKIA2EFBE1EF63D1BBE2AF6E59100B98E1D3043F477A\";\n    \/\/$clientSecret = \"uAk0Amg6NQwQPcnb9BTJzxvMS6Vz22octQglQ1rfrMA=\";\n    \n    \/\/ sandbox clienId client\n    $clientId = \"IKIA6570778A3484D6F33BC7E4165ADCA6CF06B2860A\";\n    $clientSecret = \"DXfUwpuIvMAKN84kv38uspqGOsStgFS0oZMjU7bPwpU=\";\n    \n\n    \n    \/***- START- ***\/\n\n    \/**\n    * Interswitch.ENV_SANDBOX, is for sandbox environment\n    * \n    * Interswitch.ENV_PROD, is for production environment\n    *\/\n    $transfer = new FundsTransfer($clientId,$clientSecret,Interswitch::ENV_SANDBOX);\n    \/\/$transfer = new FundTransfer($clientId, $clientSecret, Interswitch::ENV_PRODUCTION); \/\/ Production\n    \/\/$transfer = new FundTransfer($clientId, $clientSecret); \/\/ Defaults to Sandbox\n    $bankResponse = $transfer-&gt;fetchBanks();\n\n    $bankResponseCode = json_decode($bankResponse[\"HTTP_CODE\"]);\n    $bankResponseBody = json_decode($bankResponse[\"RESPONSE_BODY\"]);\n\n    \n    if($bankResponseCode == 200) {\n        \n        $cbnCode = $bankResponseBody-&gt;banks[0]-&gt;cbnCode;\/\/ central bank code\n        $bankName = $bankResponseBody-&gt;banks[0]-&gt;bankName;\/\/ bank Name\n        $bankCode = $bankResponseBody-&gt;banks[0]-&gt;bankCode;\/\/ bankcode in alphabetical form: UBA, GTB, FBN\n\n        echo $cbnCode.\" \".$bankName.\" \".$bankCode.\"\\n\"; \/\/printed response\n\n        \/\/build transfer request\n        $request = (new TransferRequestBuilder($initiatingEntityCode))\n            -&gt;amount(\"100000\") \/\/ mandatory, minor denomination\n            -&gt;channel(FundsTransfer.LOCATION) \/\/ mandatory: ATM-1, POS-2, WEB-3, MOBILE-4, KIOSK-5, PCPOS-6, LOCATION-7, DIRECT DEBIT-8\n            -&gt;destinationBankCode(cbnCode)\/* mandatory:  To be gotten from the get all banks code (transfer.fetchBanks())*\/\n            -&gt;toAccountNumber(\"0114951936\") \/\/ mandatory\n            -&gt;requestRef(\"60360575603527\")\/\/ mandatory\n            -&gt;senderPhoneNumber(\"07036913492\") \/\/ optional\n            -&gt;senderEmail(\"grandeur_man@yahoo.com\") \/\/ optional\n            -&gt;senderLastName(\"Desmond\") \/\/ optional\n            -&gt;senderOtherNames(\"Samuel\") \/\/ optional\n            -&gt;receiverPhoneNumber(\"07036913492\") \/\/ optional\n            -&gt;receiverEmail(\"grandeur_man@yahoo.com\") \/\/ optional\n            -&gt;receiverLastName(\"Desmond\") \/\/ optional\n            -&gt;receiverOtherNames(\"Samuel\") \/\/ optional\n            -&gt;fee(\"10000\")\/\/ optional (minor denomination)\n            -&gt;build();\n\n\n             $validationResponse = $transfer-&gt;validateAccount($request);\n\n             if($validationResponse[\"HTTP_CODE\"] === 200) {\n                 $accountName =json_decode($validationResponse[\"RESPONSE_BODY\"])-&gt;accountName;\n                 echo \"Account Name is \".$accountName;\n             }\n             else if(!$validationResponse[\"HTTP_CODE\"] || $validationResponse[\"HTTP_CODE\"] != 200) {\n                 \/\/account validation was not successful, continue on\n             }\n\n             $response = $transfer-&gt;send($request);\n             if($response[\"HTTP_CODE\"] === 200) {\n                 $responseBody = json_decode($response[\"RESPONSE_BODY\"]);\n                 $mac = $responseBody-&gt;mac;\n                 $transactionDate = $responseBody-&gt;transactionDate;\n                 $responseCode = $responseBody-&gt;responseCode;\n                 echo $mac.\" \".$transactionDate.\" \".$responseCode;\n             }\n             else if(!$response[\"HTTP_CODE\"] || $response[\"HTTP_CODE\"] != 200) {\n                 var_dump($response);\n             }\n             \n    }\n    \n?&gt;<\/code><\/pre>\n","protected":false},"author":29,"featured_media":0,"parent":3014,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3016"}],"collection":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/comments?post=3016"}],"version-history":[{"count":3,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3016\/revisions"}],"predecessor-version":[{"id":4068,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3016\/revisions\/4068"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3014"}],"next":[{"title":"JAVA","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/java\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3017"}],"prev":[{"title":"C#","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/c\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3015"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=3016"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=3016"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}