Documentation

DNZ Payment Gateway — Merchant Guide

The DNZ Payment Gateway (Payment Gateway console at dnzteam.online) lets merchants create hosted checkout links, receive card payments, track balances, and withdraw matured funds through DNZ. Commission is 1.5% of each successful payment. Funds become withdrawable after 2 days.

DNZ Payment Gatewaypayment links APImerchant commission 1.5%checkout APIdnzteam.online gateway

How it works

1) Create a payment link from the DNZ console or via API.

2) Your customer pays on the hosted checkout page.

3) A webhook confirms success and the payment is credited to your merchant balance on DNZ.

4) After the maturity window (2 days), the net amount becomes withdrawable.

5) Request a withdrawal from the console; DNZ admins review and pay out.

Fees and deductions (1.5%)

Commission rate: 1.5% of the successful payment gross amount.

Example: customer pays $100.00 → DNZ commission $1.50 → your net $98.50.

Failed or pending payments do not create withdrawable balance.

Commission is calculated on successful transactions only and is shown in the dashboard as “Our share”.

Settlement / maturity (2 days)

Successful payments are not immediately withdrawable.

In the system, maturity is fixed at 2 days from payment completion.

The Withdrawable box shows only net amounts from successful payments older than 2 days, minus pending or approved withdrawals.

Merchant API

Base URL: your gateway host (see API Base in the console), e.g. https://gateway.dnzteam.online

Create an API key (gw_live_…) in the Payment Gateway console on dnzteam.online.

Authenticate with header: X-API-Key: gw_live_YOUR_KEY

Create payment: POST /api/payments/create

Payment status: GET /api/payments/status/{paymentId}

Console JWT auth also works for the same endpoints when using the dashboard session.

curl -X POST "https://gateway.dnzteam.online/api/payments/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gw_live_YOUR_KEY" \
  -d '{
    "productName": "Order #1001",
    "amount": 25.00,
    "currency": "USD",
    "description": "Checkout"
  }'

# Response includes checkoutUrl / formUrl for the customer.
# Poll status:
curl -H "X-API-Key: gw_live_YOUR_KEY" \
  "https://gateway.dnzteam.online/api/payments/status/PAYMENT_ID"

Statuses and webhooks

Typical statuses: pending, success, failed.

DNZ webhooks update the payment and credit the merchant on success.

Always verify status via GET /api/payments/status/{paymentId} before fulfilling an order.

Withdrawals

Use Withdraw full amount in the console when Withdrawable > 0.

Pending withdrawal requests reduce available balance until approved or rejected.

Approved withdrawals stay deducted; rejected withdrawals restore the amount.