Payzah Payment Gateway Documentation

Payzah is a payment gateway that lets you accept K-Net, VISA, MasterCard, and Apple Pay on your website or mobile app. This documentation covers everything you need to integrate, test, and go live — from obtaining your API key to handling payment responses in production.

Introduction

Learn what Payzah offers and how the integration works end to end.

Prerequisites

Set up your merchant account, get your API key, and understand security requirements.

Integration Methods

Choose between the hosted Transit Payment Page and the fully custom Direct Integration.

API Reference

Explore the full API — initialization endpoints, status checks, request fields, and error codes.

How it works

Create a merchant account at payzah.com and obtain your private API key.

Choose your integration method

Use the Transit Payment Page for a quick hosted checkout, or the Direct Integration for full control over the payment UI.

Implement and test

Send payment initialization requests against the test environment using the provided sandbox credentials.

Go live

Swap in your production API key and endpoint URLs to start accepting real payments.

Transit Payment Page

Minimal setup — route customers to Payzah’s branded hosted checkout page.

Direct Integration

Full control — integrate each payment method directly into your own UI.

Test Credentials

K-Net, Visa, and Mastercard sandbox card numbers for UAT testing.

Response Codes

Complete list of error codes and payment status values.

⌘I