Your first Tranzila API call in 5 minutes

Create a hosted payment request and get back a Tranzila payment link. This is the fastest low-friction path from setup to a testable payment flow.

1. Get your test terminal credentials

Request a Tranzila terminal and API credentials for testing. You need:

terminal_name
app key
app secret

Keep the app secret on your server. Do not expose it in browser code.

Request access

2. Create a payment request

Shell

# Create a Tranzila payment request
REQUEST_TIME=$(date +%s%3N)
NONCE=$(openssl rand -hex 20)
ACCESS_TOKEN=$(printf "%s%s%s" "$TRANZILA_APP_KEY" "$REQUEST_TIME" "$NONCE" \
  | openssl dgst -sha256 -hmac "$TRANZILA_APP_SECRET" -binary \
  | xxd -p -c 256)

curl -X POST https://api.tranzila.com/v1/pr/create \
  -H "Content-Type: application/json" \
  -H "X-tranzila-api-app-key: $TRANZILA_APP_KEY" \
  -H "X-tranzila-api-request-time: $REQUEST_TIME" \
  -H "X-tranzila-api-nonce: $NONCE" \
  -H "X-tranzila-api-access-token: $ACCESS_TOKEN" \
  -d '{
    "terminal_name": "your_terminal",
    "created_by_user": "tester",
    "created_by_system": "your_system",
    "created_via": "TRAPI",
    "request_date": "2026-05-26",
    "request_language": "english",
    "response_language": "english",
    "action_type": 1,
    "request_currency": "ILS",
    "request_vat": 18,
    "payments_number": 1,
    "payment_plans": [1],
    "payment_methods": [1],
    "client": {
      "name": "Example Trading Ltd.",
      "contact_person": "John Doe",
      "email": "john.doe@example.com"
    },
    "items": [
      {
        "name": "Test payment",
        "unit_price": 100,
        "units_number": 1,
        "type": "I",
        "price_type": "G",
        "currency_code": "ILS"
      }
    ]
  }'

Successful response — Check error_code in the response body. 0 means the payment request was created successfully. Store the returned pr_id and open the returned pr_link to complete the payment on Tranzila’s hosted page.

3. Verify and go live

After the customer completes payment, reconcile the transaction in the Reports API. Before production, confirm that every payment method listed in payment_methods is enabled on your production terminal.