Payzah Quickstart: Your First Payment in 5 Minutes

Take your first Payzah payment in about five minutes. Copy one request, run it, and get a live payment link you can open in a browser. No account needed. Everything on this page runs against the sandbox, so no real money moves.

متوفر أيضًا بالعربية — also available in Arabic.

Already on Shopify, WooCommerce, or Odoo? Skip the API entirely — install the plugin for your platform instead.

What You Need

Nothing. Use the public sandbox key below and start immediately — no account required.

NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==

This is a shared demo key, already Base64-encoded, and works only on the test environment. When you are ready to go live, register through the Payzah app for your own private key.

Create a payment

Run this exactly as written — the sandbox key is already filled in.

Terminal

curl --request POST \
  --url https://development.payzah.net/ws/paymentgateway/index \
  --header 'Content-Type: application/json' \
  --header 'Authorization: NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==' \
  --data '{
    "trackid": "QUICKSTART-001",
    "amount": "1.000",
    "currency": "414",
    "payment_type": "3",
    "success_url": "https://example.com/success",
    "error_url": "https://example.com/error"
  }'

You will get back something like this:

Response

{
  "status": true,
  "data": {
    "PaymentUrl": "https://development.payzah.net/pgaction",
    "PaymentID": "2019070115360420",
    "transit_url": "https://devgateway.trytajer.app?id=202409271806248183",
    "direct_url": ""
  }
}

Save the PaymentID. You need it for the next step and for any refund.

Got status: false instead? Code 10014 means the key was not sent correctly — check for a stray newline or space. See Troubleshooting for other codes.

Pay it

Open the transit_url from the response in your browser. That is the checkout page your customers would see.Pay using a sandbox test card, then let it redirect you back.

A redirect to your success URL does not mean you were paid. Anyone can visit that URL directly. Always verify server-side — which is the next step.

Confirm you were paid

Check the real outcome using your trackid and the PaymentID from step 2.

Terminal

curl --request POST \
  --url https://development.payzah.net/ws/paymentgateway/get-payment-details \
  --header 'Content-Type: application/json' \
  --header 'Authorization: NzYxMGVlNjFhZDJkZGJlODAzYmU2MjZmNzZhYmM5OTZkNDdkY2JiZA==' \
  --data '{
    "trackid": "QUICKSTART-001",
    "payment_id": "2019070115360420"
  }'

Look for paymentStatus in the response:

Response

{
  "status": true,
  "data": {
    "payzahRefrenceCode": "202303935749373001",
    "trackId": "QUICKSTART-001",
    "paymentStatus": "CAPTURED"
  }
}

CAPTURED means the funds are secured. Only fulfil an order on CAPTURED — every other value means you have not been paid. See all status values.

That is a complete payment flow. Everything else builds on these three calls.

Try It Without Any Code

Prefer to click rather than curl? Every endpoint has an interactive console pointed at the sandbox — fill in the fields and hit send.

Initialize a payment

Create a payment session.

Check payment status

Verify a transaction.

Refund a payment

Return funds to a customer.

Where to Next

Choose your integration method

You used the hosted Transit page above. Compare it against sending customers straight to K-Net or card.

Handle refunds

Issue full or partial refunds against a completed transaction.

Test properly

Sandbox cards for K-Net, Visa, and MasterCard.

Go live

Work through the checklist before switching to production.

Get Started

Plugins & Platforms

Custom Integration Guide

Testing & Go-Live

Resources

Payzah Quickstart: Your First Payment in 5 Minutes

What You Need

Try It Without Any Code

Initialize a payment

Check payment status

Refund a payment

Where to Next

Choose your integration method

Handle refunds

Test properly

Go live

​What You Need

​Try It Without Any Code

Initialize a payment

Check payment status

Refund a payment

​Where to Next

Choose your integration method

Handle refunds

Test properly

Go live

What You Need

Try It Without Any Code

Where to Next