Ziia Sandbox — Interactive Developer Environment

🔑 Get your sandbox API key

Generate an instant sandbox key. No approval. No forms. Live in seconds.

Participant ID (any name)

🚀 Quick start

cURL

Go

Node

Python

# Step 1: Get a sandbox key curl -X POST https://sandbox.ziia.co/v1/sandbox/keys \ -H "Content-Type: application/json" \ -d '{"participant_id": "my_bank"}' # Step 2: Authorise a payment curl -X POST https://sandbox.ziia.co/v1/authorize \ -H "X-API-Key: pr_test_..." \ -H "Content-Type: application/json" \ -d '{ "transaction_id": "txn_001", "pan_token": "tok_approve", "amount": 5000, "currency": "USD", "merchant_id": "MERCH_001", "mcc": "5411", "acquirer_id": "acq_001" }'

package main import ( "bytes"; "fmt"; "io"; "net/http" ) func authorize() { body := []byte(`{ "transaction_id": "txn_001", "pan_token": "tok_approve", "amount": 5000, "currency": "USD", "merchant_id": "MERCH_001", "mcc": "5411", "acquirer_id": "acq_001" }`) req, _ := http.NewRequest("POST", "https://sandbox.ziia.co/v1/authorize", bytes.NewReader(body)) req.Header.Set("X-API-Key", "pr_test_...") resp, _ := http.DefaultClient.Do(req) b, _ := io.ReadAll(resp.Body) fmt.Println(string(b)) }

const res = await fetch( 'https://sandbox.ziia.co/v1/authorize', { method: 'POST', headers: { 'X-API-Key': 'pr_test_...', 'Content-Type': 'application/json' }, body: JSON.stringify({ transaction_id: 'txn_001', pan_token: 'tok_approve', amount: 5000, currency: 'USD', merchant_id: 'MERCH_001', mcc: '5411', acquirer_id: 'acq_001' }) } ) const { decision } = await res.json()

import requests res = requests.post( "https://sandbox.ziia.co/v1/authorize", headers={"X-API-Key": "pr_test_..."}, json={ "transaction_id": "txn_001", "pan_token": "tok_approve", "amount": 5000, "currency": "USD", "merchant_id": "MERCH_001", "mcc": "5411", "acquirer_id": "acq_001", } ) print(res.json()["decision"]) # APPROVE

✅ Getting started checklist

⬜Generate a sandbox API key

⬜Make your first authorisation request

⬜Test a decline scenario

⬜Trigger a 3DS challenge

⬜Configure a webhook endpoint

🎯 Request

Transaction ID

PAN Token

Amount (minor units)

Currency

Merchant ID

MCC

Acquirer ID

Issuer ID

IP Country

Card Country

📨 Response

Fire a request to see the response here.

📤 Request JSON

Fill the form above to preview the request.

0 approved 0 declined 0 other

📋

No requests yet. Fire some from the Request builder.

🔗 Endpoint configuration

Webhook URL

Secret (for HMAC-SHA256 signature)

Events to receive

transaction.authorized transaction.declined auth.3ds_required fraud.flagged settlement.completed

📦 Event payload reference

Event type

📬 Delivery log

🔔

No webhook events yet. Fire requests to generate events.

🔑 Issue a Trusted Agent Token

Agent model

Agent ID

Description / purpose

Max per transaction (cents)

Max per day (cents)

Allowed MCCs (comma-sep)

TTL (hours)

Single-use Require human approval

💳 Agent payment

Amount (cents)

Currency

Merchant

MCC

Agent context

📨 Agent response

Issue a token and fire a payment to see the response.