Skip to content
ZytePedevelopersDashboard
DocsGet started
Get started

Make your first request

Prepare your merchant account and make a signed, read-only payee lookup.

1. Prepare your account

In the dashboard, complete Merchant Profile, generate your API key and secret, and approve the outbound public IP of your server. Review credentials and IP whitelisting.

2. Set server-side credentials

Use your deployment secret manager for ZYTEPE_API_KEY_ID and ZYTEPE_API_SECRET. Do not prefix them with NEXT_PUBLIC_, commit them, or expose them in browser code. This documentation never collects credentials.

3. Sign a read-only request

Save the signing helper and list-payees.mjs in the same local directory. The example requires Node.js with built-in fetch. Execute it only on your approved server after providing its environment variables.

import { signedHeaders } from './signing.mjs';
const path = `/api/v1/payees/external/list`;
const query = 'limit=50&offset=0';
const body = ''; // GET requests have no body
const headers = signedHeaders({
  method: 'GET', path, query, body,
  keyId: process.env.ZYTEPE_API_KEY_ID,
  secret: process.env.ZYTEPE_API_SECRET,
});
const url = 'https://api.zytepe.com' + path + (query ? '?' + query : '');
const response = await fetch(url, { method: 'GET', headers });
if (!response.ok) throw new Error('Request failed: HTTP ' + response.status);
const result = await response.json();
// Store the returned identifiers securely. Do not log customer data.

The exact query is signed separately from the path. GET has no body. Your account may have no payees; an empty list is not an authentication failure.

4. Handle the result safely

Retain the payee identifiers your workflow needs. Do not log personal or bank details. On failure, record the HTTP status and a redacted error; check the full secret, outbound IP, timestamp, nonce and exact signed bytes before retrying.

5. Add a payment workflow

Choose payment links or payouts, and configure webhooks before processing transactions. There is no guaranteed setup duration or documented isolated sandbox.