{"id":3015,"date":"2018-08-01T09:07:16","date_gmt":"2018-08-01T09:07:16","guid":{"rendered":"http:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/c\/"},"modified":"2018-08-01T15:48:53","modified_gmt":"2018-08-01T15:48:53","slug":"c","status":"publish","type":"docs","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/c\/","title":{"rendered":"C#"},"content":{"rendered":"<h1>B2C-Billers-Csharp<\/h1>\n<p><a href=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2018\/08\/b2c_billers_csharp-master.zip\" rel=\"nofollow\">Download Link<\/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_csharp#prerequisites\" aria-hidden=\"true\"><\/a>Prerequisites<\/h2>\n<ul>\n<li>Interswitch Base Library dll\u00a0<a href=\"https:\/\/github.com\/techquest\/interswitch_csharp\">Click here<\/a><\/li>\n<\/ul>\n<h1><a id=\"user-content-welcome\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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_csharp#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_csharp#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_csharp#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_csharp#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_csharp#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_csharp#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_csharp#get-all-billers\" aria-hidden=\"true\"><\/a>Get All Billers<\/h3>\n<pre><code>Get a list of all billers supported on our platform.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-get-all-categorys\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-get-all-billers-under-a-category\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-get-biller-payment-items\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-validate-customer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#validate-customer\" aria-hidden=\"true\"><\/a>Validate Customer<\/h3>\n<pre><code>Validates a customer-id under a particular biller.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-make-payment-for-a-customer\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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.\r\n<\/code><\/pre>\n<h3><a id=\"user-content-query-the-status-of-a-transaction\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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\r\n<\/code><\/pre>\n<h4><a id=\"user-content-samples\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#samples\" aria-hidden=\"true\"><\/a>Samples<\/h4>\n<p>Check out the samples folder for sample code on all the features above. It contains all the sample code for all features.<\/p>\n<h4><a id=\"user-content-support-team\" class=\"anchor\" href=\"https:\/\/github.com\/techquest\/b2c_billers_csharp#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<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<h1>B2C-Funds-Transfer-Csharp<\/h1>\n<p><a href=\"http:\/\/sandbox.interswitchng.com\/docbase\/wp-content\/uploads\/2018\/08\/b2c_funds_transfer_csharp-master.zip\" rel=\"nofollow\">Download Link<\/a><\/p>\n<pre class=\"\"><code>using B2C_Funds_Transfer_Csharp.codec;\r\nusing B2C_Funds_Transfer_Csharp.transfer;\r\nusing System;\r\nusing System.Collections.Generic;\r\nusing System.Linq;\r\nusing System.Text;\r\nusing System.Threading.Tasks;\r\n\r\nnamespace SampleApp\r\n{\r\n    class AppDriver\r\n    {\r\n\r\n        static void Main(string[] args)\r\n        {\r\n           String initiatingEntityCode = \"PBL\";\r\n\r\n          \/\/test clientID and clientSecret\r\n         \/\/String clientId = \"IKIA2EFBE1EF63D1BBE2AF6E59100B98E1D3043F477A\";\r\n         \/\/String clientSecret = \"uAk0Amg6NQwQPcnb9BTJzxvMS6Vz22octQglQ1rfrMA=\";\r\n\r\n        \/\/ sandbox clientId and clientSecret\r\n        String clientId = \"IKIA6570778A3484D6F33BC7E4165ADCA6CF06B2860A\";\r\n        String clientSecret = \"DXfUwpuIvMAKN84kv38uspqGOsStgFS0oZMjU7bPwpU=\";\r\n        FundsTransfer transfer = new FundsTransfer(clientId, clientSecret, Interswitch.Interswitch.SANDBOX);\r\n\r\n            try\r\n            {\r\n                BankResponse bankResponse = transfer.fetchBanks();\r\n\r\n                Bank[] bank = bankResponse.banks; \/\/ a bank array of all banks\r\n\r\n                if (bank != null)\r\n                {\r\n                    \/\/ successful\r\n                    Bank testBank = bank[0]; \/\/ bank at index 0\r\n\r\n                    String cbnCode = testBank.cbnCode; \/\/ Central bank code\r\n                    String bankName = testBank.bankName; \/\/ bank name:\r\n                    String bankCode = testBank.bankCode; \/\/ bankcode in alphabetical form: UBA, GTB, FBN\r\n\r\n                    TransferRequest request = new TransferRequestBuilder(initiatingEntityCode).begin()\r\n                        .amount(\"100000\") \/\/ mandatory, minor denomination\r\n                        .channel(FundsTransfer.LOCATION) \/\/ mandatory: ATM-1, POS-2, WEB-3, MOBILE-4, KIOSK-5, PCPOS-6, LOCATION-7, DIRECT DEBIT-8\r\n                        .destinationBankCode(cbnCode)\/* mandatory:  To be gotten from the get all banks code (transfer.fetchBanks())*\/\r\n                        .toAccountNumber(\"0114951936\") \/\/ mandatory\r\n                        .requestRef(\"60360575603527\")\/\/ mandatory\r\n                        .senderPhoneNumber(\"07036913492\") \/\/ optional\r\n                        .senderEmail(\"grandeur_man@yahoo.com\") \/\/ optional\r\n                        .senderLastName(\"Desmond\") \/\/ optional\r\n                        .senderOtherNames(\"Samuel\") \/\/ optional\r\n                        .receiverPhoneNumber(\"07036913492\") \/\/ optional\r\n                        .receiverEmail(\"grandeur_man@yahoo.com\") \/\/ optional\r\n                        .receiverLastName(\"Desmond\") \/\/ optional\r\n                        .receiverOtherNames(\"Samuel\") \/\/ optional\r\n                        .fee(\"10000\")\/\/ optional (minor denomination)\r\n                        .build();\r\n\r\n                    AccountValidation validationResponse = transfer.validateAccount(request);\/\/ validate account\r\n\r\n                    if (validationResponse is AccountValidation)\r\n                    {\r\n\r\n                        String accountName = validationResponse.accountName;\r\n                    }\r\n\r\n                    TransferResponse response = transfer.send(request); \/\/ send transfer request\r\n\r\n                    if (response.error is ErrorResponse)\r\n                    {\r\n                        \/\/ NOT SUCCESSFUL\r\n                        String code = response.error.code;\r\n                        String message = response.error.message;\r\n\r\n                    }\r\n                    else if (response.responseCode.Equals(\"90000\"))\r\n                    {\r\n\r\n                        \/\/ SUCCESS\r\n                        String mac = response.mac;\r\n                        String transactionDate = response.transactionDate;\r\n                        String responseCode = response.responseCode;\r\n\r\n                    }\r\n                    else\r\n                    {\r\n                        \/\/ transfer was not successful\r\n                    }\r\n                }\r\n                else\r\n                {\r\n                    \/\/ transfer was not successful\r\n                }\r\n\r\n            }\r\n            catch (Exception ex)\r\n            {\r\n\r\n            }\r\n\r\n\r\n        }\r\n    }\r\n}<\/code><\/pre>\n","protected":false},"author":29,"featured_media":0,"parent":3014,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3015"}],"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=3015"}],"version-history":[{"count":2,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3015\/revisions"}],"predecessor-version":[{"id":3032,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3015\/revisions\/3032"}],"up":[{"embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3014"}],"next":[{"title":"PHP","link":"https:\/\/sandbox.interswitchng.com\/docbase\/docs\/quickteller-sva\/sample-libraries\/php\/","href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/docs\/3016"}],"wp:attachment":[{"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/media?parent=3015"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/sandbox.interswitchng.com\/docbase\/wp-json\/wp\/v2\/doc_tag?post=3015"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}