Paynow Developer Hub
  • DOCUMENTATION
  • ABOUT
  • HELP
  • FORUMS
  • SIGN UP / SIGN IN

›Getting Started

Getting Started

  • Getting started
  • Generating Integration Keys
  • Test Mode
  • Artwork and Buttons
  • PHP
  • .NET
  • Node.JS
  • Python
  • Java
  • WooCommerce
  • Gravity Forms
  • Easy Digital Downloads
  • Shopify
  • Camptix
  • Magento
  • Spring Boot

Links & Buttons

  • Simple Payment Request Button
  • Advanced Payment Request Button
  • Notification, Success & Cancel URLs
  • URL Safe Base 64 Encoding

API Reference

  • System Layout
  • Initiate a transaction
  • Express Checkout Transactions
  • Complete a Transaction
  • Status Update
  • Polling for a Status Update
  • Generating Hash
  • Validating Hash
  • Initiate a Passenger Ticket Transaction

Library Source Docs

  • PHP
  • .NET
  • Node.JS
  • Java

Test Mode

When you first create an integration it is in test mode. Test mode allows you to create, cancel and pay a transaction to test all possible scenarios with your system. However no actual money is moved and you do not need access to Visa/MasterCard/Vpayments/EcoCash/TeleCash/OneMoney to do a test transaction.

After creating a transaction ONLY THE MERCHANT ACCOUNT USED TO CREATE THE INTEGRATION can login and Fake a Payment. Any other users will get a message saying the merchant is in testing and they cannot proceed with payment.

If you include the authemail field when initiating the transaction with Paynow, make sure its your merchant account email address, otherwise you won't be able to complete the test transaction.

When making payment in test mode select [TESTING: Faked Success] and click [Make Payment], Paynow will reply to your site as if payment has been made.

When you are happy that you have completed integration go back to the Integration Keys section and click [Request to be Set Live]. Paynow support will check you have performed at least one successful test transaction and set you to live. Once you are set live you will begin receive payment from your select Payment Methods.

Express Checkout

Mobile Money (ecocash, onemoney)

To use mobile money Express Checkout in test mode, there are four pre-configured mobile numbers that can be used to simulate various results:

N.B. The authemail field supplied during test mode should match one of the login email addresses for the merchant account being tested.

Success – 0771111111

Paynow will send a SUCCESS status update message 5 seconds after the transaction is initiated.

Delayed Success – 0772222222

Paynow will send a SUCCESS status update message 30 seconds after the transaction is initiated. This simulates the user taking a longer than normal amount of time to authorize the transaction from their handset

User Cancelled – 0773333333

Paynow will send a FAILED status update message 30 seconds after the transaction is initiated. This simulates the user cancelling the mobile money transaction.

Insufficient Balance – 0774444444

Paynow will immediately fail the transaction during initiation and return an “Insufficient balance” error message.

Visa / MasterCard (vmc)

Using one of the tokens below during a test mode express checkout transaction with method=vmc, will yield the associated transaction result:

Success: {11111111-1111-1111-1111-111111111111}

Paynow will send a SUCCESS status update message 5 seconds after the transaction is initiated.

Pending: {22222222-2222-2222-2222-222222222222}

Paynow will send a SUCCESS status update message 30 seconds after the transaction is initiated. This simulates the user taking a longer than normal amount of time to authorize the transaction from their handset

Cancelled: {33333333-3333-3333-3333-333333333333}

Paynow will send a FAILED status update message 30 seconds after the transaction is initiated. This simulates the user cancelling the mobile money transaction.

Insufficient Balance: {44444444-4444-4444-4444-444444444444}

Paynow will immediately fail the transaction during initiation and return an “Insufficient balance” error message.

The token should be specified as token=xxxxxxx in the request to the /interface/remotetransaction API endpoint, along with any other required fields

Zimswitch (zimswitch)

Using one of the tokens below during a test mode express checkout transaction with method=zimswitch, will yield the associated transaction result:

Success: 11111111111111111111111111111111

Paynow will send a SUCCESS status update message 5 seconds after the transaction is initiated.

Pending: 22222222222222222222222222222222

Paynow will send a SUCCESS status update message 30 seconds after the transaction is initiated. This simulates the user taking a longer than normal amount of time to authorize the transaction from their handset

Cancelled: 33333333333333333333333333333333

Paynow will send a FAILED status update message 30 seconds after the transaction is initiated. This simulates the user cancelling the mobile money transaction.

Insufficient Balance: 44444444444444444444444444444444

Paynow will immediately fail the transaction during initiation and return an “Insufficient balance” error message.

The token should be specified as token=xxxxxxx in the request to the /interface/remotetransaction API endpoint, along with any other required fields

← Generating Integration KeysArtwork and Buttons →
  • Express Checkout
    • Mobile Money (ecocash, onemoney)
    • Visa / MasterCard (vmc)
    • Zimswitch (zimswitch)
Documentation
Getting StartedAPI ReferenceFrequently Asked QuestionsArtwork & Buttons
Libraries & Plugins
PHP.NETNode.JSPythonJava
Plugins
WooCommerceGravity FormsEasy Digital DownloadsShopify
Community
Discussion ForumsBlogs & TutorialsGithubFacebookTwitter
Paynow Zimbabwe
Copyright © 2025 Paynow Zimbabwe