Skip to main content

ZSL

Quick Start
  1. Sign up at zsl.com and obtain API credentials
  2. Create a terminal in the Admin Console with the parameters below
  3. Start processing — the adapter is pre-built and ready to use

Go to ZSL →

Overview

ZSL payment integration

Provider IDzsl
CategoryInterbank Integrations
Websitezsl.com

Configuration

Required Parameters

ParameterDescription
base_urlbase URL API (including /ecp endpoint)

Example Configuration

{
"env": "prod",
"base_url": "https://api.zsl-gateway.com/",
"api_key": "your_api_key_here",
"merchant_id": "MERCHANT123",
"webhook_url": "https://api.yoursite.com/webhooks/zsl"
}

Payment Flow

Payments (one-phase only):

  1. authorize - payment creation via POST /ecp:
    • process_type="0200", process_code="200002"
    • txn_amt (minor units), ccy (currency), mer_ref (transaction ID)
    • mer_txn_date (YYYYMMDDHHMMSS format)
    • signature (MD5 hash)
    • country, lang, cust_tag (customer ID latest 10 characters)
    • success_url, failure_url, success_s2s_url, failure_s2s_url
    • Optional: bank_code, tel_phone, email, name, family_name
    • Retrieval txn_url (base64 encoded redirect URL) and response signature
    • Redirect user on decoded txn_url

Note: Upstream 4pay supports only authorize + webhooks, without direct API for capture/refund/status.


Resources