Contacts

FasteCash API/SCI for Developers

Note:

You can get the instruction on how to integrate FasteCash API/SCI also in PDF format. Click here to download.

FasteCash SCI

This is a mechanism that allows Merchants (with fastecash account) to accept payment on their website without having to use Infomart(Fastecash Digital Marketplace).

Shopping Cart

Software is software used in e-commerce to assist people making purchases online, analogous to the American English term 'shopping cart'. In British English it is generally known as a shopping basket, almost exclusively shortened on websites to 'basket'.

The software allows online shopping customers to accumulate a list of items for purchase, described metaphorically as "placing items in the shopping cart". Upon checkout, the software typically calculates a total for the order, including shipping and handling (i.e. postage and packing) charges and the associated taxes, as applicable. - Wikipedia

FasteCash Shopping Cart Interface(SCI)

Processes payment from merchant website. Payment parameters are submitted by a shopping cart software or HTML forms on the merchant website.

Essentially the SCI page interfaces(interact) with the the merchant website.

How It Works

Merchant's web site must contain at least three HTML pages to successfully accept payments:

Payment page

That redirects Buyer to SCI web site to complete payment for products or services

Payment successful page

To inform the Buyer that his payment is completed successfully

Payment failed page

To inform the Buyer that his payment has failed

To accept online payment, Merchant's web site should redirect the Buyer to SCI web site to perform the payment for products or services ordered on the Merchant's web site. Once the payment is successfully complete, the Buyer will be redirected back to Merchant's web site.

Buyer selects a product or a service from an online store and decides to purchase it. Merchant displays the total amount of purchase and Buyer, in turn, proceeds to pay for his order by clicking an appropriate button or link. At this time, Merchant's web site redirects the Buyer to FasteCash SCI.

Below are the parameters that the merchant can use on his HTML form or website to communicate back to FasteCash SCI and the values from the parameters set are use for appropriate processes and transactions.

Parameters in HTML Forms

fec_merchant - FasteCash username of merchant

fec_merchant_ref - merchant's reference:this is generated by the merchant and used by the merchant(It can be an invoice,order or user id or number that is relevant to the current transaction). The merchant reference is returned to merchant's site on successful completion of transaction.
NOTE: The merchant reference is currently not saved or recorded by FasteCash.

fec_amount_naira - the naira value of the product/service (it might be sum of products and services as calculated by a shopping cart software)

fec_amount_dollar - the dollar amount of the product/service (it might be sum of products and services as calculated by a shopping cart software)

fec_fail_url - the url of the payment failed page. FasteCash SCI redirects to this page if the buyer cancels and refuses to go through with the payment

fec_success_url - the url of the payment successful page. FasteCash SCI redirects to this page if the buyer successfully complete the transaction.

fec_buyer - FasteCash username of the buyer you are expecting payment from. If this is set from your website, the buyer field will be pre-filled on FasteCash payment processor.

The only required fields are;

fec_merchant and any of
fec_amount_naira or
fec_amount_dollar.

Both fec_amount_naira and fec_amount_dollar can be presented for buyer to make choice of the currency he or she chooses to use.

Accepting and processing payments

You need to redirect the Buyer to FasteCash's SCI web page using this following URL address:

https://www.fastecash.com/sci.php

Sample Payment Form for Donation

<table >
<th colspan="2">Form 1:fec_merchant</th>
<tr>
<td colspan="2">This form only contain <b>fec_merchant parameter</b>. It is suitable for accepting donations<br />
NOTE: payment will only be available in naira.
</td>
</tr>
<tr>
<td>Merchant Username</td>
<td><input type="hidden" name="fec_merchant" value="bidavic" size="40"></td>
</tr>
<tr>
<td colspan="2" align="center"><input type="submit" name="submit" value="Donate With FasteCash" ></td>
</tr>

</table>
</form>

Sample Payment Form for Naira Acceptance

form action="https://www.fastecash.com/sci.php" method="post" name="form2" >

<th colspan="2">Form 2:fec_merchant,fec_merchant_ref,fec_amount_naira, fec_fail_url, fec_success_url</th>

<tr>

<td colspan="2">This form specifies amount in naira, so only naira payment is enabled. <b>fec_fail_url</b> and <b>fec_success_url</b> are aslo specified.<br />

</td>

</tr>

<tr>

<td>Merchant Username is hidden</td>

</tr>

<tr>

<td>Merchant Reference is hiiden</td>

</tr>

<tr>

<td>Amount(N)</td>

</tr>

<tr>

<td>Fail Url is hidden</td>

</tr>

<tr>

<td>Success Url is hidden</td>

</tr>

<tr>

</tr>

</table>

</form>

Sample Payment Form for Naira & Dollar Acceptance

<th colspan="2">Form 3:fec_merchant,fec_merchant_ref,fec_amount_naira, fec_fail_url, fec_success_url</th>

<tr>

<td colspan="2">This form specifies amount in naira, so only naira payment is enabled. <b>fec_fail_url</b> and <b>fec_success_url</b> are aslo specified.<br />

</td>

</tr>

<tr>

<td>Merchant Username is hidden</td>

</tr>

<tr>

<td>Merchant Reference is hiden</td>

</tr>

<tr>

<td>Amount(N)</td>

</tr>

<tr>

<td>Amount($)</td>

</tr>

<tr>

<td>Fail Url is hidden</td>

</tr>

<tr>

<td>Success Url is hidden</td>

</tr>

<tr>

</tr>

</table>

</form>

Sample Payment Form for Naira & Dollar Acceptance with the Request for Buyer's FasteCash Username

<th colspan="2">Form 4:fec_merchant,fec_buyer,fec_merchant_ref,fec_amount_naira, fec_fail_url, fec_success_url</th>

<tr>

<td colspan="2">This form specifies <b>fec_buyer</b>, the buyer field is therefore set at the

</td>

</tr>

<tr>

<td>Merchant Username is hidden</td>

</tr>

<tr>

<td>Merchant Reference is hiden</td>

</tr>

<tr>

<td>Fastecash Username(Buyer)</td>

</tr>

<tr>

<td>Amount(N)</td>

</tr>

<tr>

<td>Amount($)</td>

</tr>

<tr>

<td>Fail Url is hidden</td>

</tr>

<tr>

<td>Success Url is hidden</td>

</tr>

<tr>

</tr>

</table>

</form>