Credit Card API

Credit Card Acceptance

This page outlines how to integrate WiPay into your website using an HTML form so customers can pay via Credit Card and you can have the money deposited to your bank account.

Step 1

Test using your WiPay Business Verified account

Step 1.1: Sign Up for a WiPay Business account 

If you already have a WiPay Business Verified account, you can skip to Step 1.3: Update Merchant Key.

If you have a WiPay Business UnVerified account, you can find out on how to gain Account Verification [here].

If you do not have a WiPay Business account, you can find out how to begin the SignUp process [here].

Step 1.2: Update Bank Information

You need to update your banking info so that when people pay via credit card, the money goes to your linked back account.

WiPay can wire transfer within FIVE (5) work-days to the following banks:

  • Citizens Bank Guyana Inc.
  • GBTI Guyana Bank for Trade and Industry
  • Republic Bank (Guyana) Limited
  • Guyana Americas Merchant Bank Inc.
  • Scotiabank
  • Bank of Baroda
  • Demerara Bank Limited

Step 1.3: Update Merchant Key

The Merchant Key will be used to verify each transaction. Every transaction produces a unique hash. The developer should verify this hash using their merchant key.
Please note that you do not need to Generate a New Merchant Key, if you already have one set.

Test using the WiPay Test account

Using our Test account

You can use our Test Business Verified account. You will need the following info in the following sections when testing:

ParameterSandBox Value

Step 2: Initiate Transaction


The configuration for the Credit Card API calls can be seen below.

All reporting features are disabled in the sandbox URL.

Upon form submission, your customers will be redirected to a Secure Checkout page where they would enter their Credit Card Information.

NOTE: When testing, please use the SANDBOX API URL. Testing on the live platform is strictly prohibited and Account will be banned

API URL (Live)
API URL (Sandbox)


ParameterDescription Notes Required
totalThe total required to be paid by the customer.1. This parameter represents the total with the Transaction Fees already applied.Yes
phoneThe customer’s phone number captured in the web form.Yes
emailThe customer’s email captured in the web form.Yes
nameThe customer’s name captured in the web form.Yes
order_idYour own custom ID for the order.Yes
return_urlThe URL of the webpage that your customers will be redirected to upon entering their Credit Card information.Yes
developer_idYour WiPay account number.Yes

Here’s an example form you can implement on your website.

Upon form submission, your customers will be redirected to the following secure checkout page.

Below is a list of Sandbox test Credit Card numbers. You can use any Card CVV and any Expiry Date.

We recommend using the test Credit Card:

Card NumberCard CVVExpiry MonthExpiry Year

Step 3: Process and Verify Transaction

When the transaction is complete, the user will be redirected to the specified return_url. From the URL, you can extract all relevant information and validate to see if the transaction was a “success” or “fail”.
Please note that a “fail”-ed response does not include the &hash parameter.

Status Success


Status Fail





GET Parameters

The GET parameters can be easily retrieved using various languages (eg. PHP)


Verifying Hash

It is strongly recommended for each transaction to verify the &hash. The &hash can be computed as seen below:

$merchant_key=//pull from your server
if($hash == $_GET['hash']) {
    //Hash matched

Our Rates

3% + $200.00 GYD per transaction. These rates are automatically deducted in the dashboard.

How do you get the money to your bank?

Simply go to the Withdraw Tab and enter an amount to withdraw (the minimum that you can withdraw is $500.00 GYD).