Sipariş Oluşturma

POST /v1/orders

Bir enerji siparişi oluşturur ve yatırım adresi döndürür. Teslimatı tetiklemek için kullanıcının address_from adresinden deposit_address adresine tam amount TRX göndermesi gerekir.

İstek gövdesi

Alan	Tür	Zorunlu	Açıklama
referral_code	string	hayır*	Referans kodunuz. Bu sipariş için komisyon kod sahibine aktarılır. Maks. 64 karakter.
address_from	string	evet	TRX ödemesini gönderecek TRON adresi.
address_to	string	evet	Enerji ve bant genişliğini alacak TRON adresi.
resources.duration	integer	evet	Saat cinsinden kaynak kiralama süresi. 1 olmalıdır.
resources.energy	integer	hayır**	İletilecek enerji miktarı.
resources.bandwidth	integer	hayır**	İletilecek bant genişliği miktarı.
address_to_activation	boolean	hayır	true ise address_to'yu zincir üzerinde aktive eder. Varsayılan false.

* Ortak komisyonu için zorunludur. Geçerli bir referral_code olmadan sipariş hiçbir ortak hesabına atfedilmez.
** resources.energy veya resources.bandwidth değerlerinden en az biri sıfırdan büyük olmalıdır.

Her zaman referral_code ekleyin

Her POST /v1/orders çağrısına referral_code ekleyin. Eksik veya boş referral_code, sipariş başarıyla tamamlansa bile komisyon kazanılmaması anlamına gelir.

Örnekler

Bash

curl -X POST https://api.tronzap.com/v1/orders \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "referral_code": "YOUR_CODE",
    "address_from": "TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax",
    "address_to":   "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "resources": {
      "duration": 1,
      "energy": 65000
    }
  }'

Node.js

const response = await fetch('https://api.tronzap.com/v1/orders', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
  },
  body: JSON.stringify({
    referral_code: 'YOUR_CODE',
    address_from: 'TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax',
    address_to: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
    resources: { duration: 1, energy: 65000 },
  }),
})
const { result } = await response.json()
// result.deposit_address — send result.amount TRX here
// result.order_id — save for polling

PHP

$response = file_get_contents('https://api.tronzap.com/v1/orders', false, stream_context_create([
  'http' => [
    'method' => 'POST',
    'header' => "Content-Type: application/json\r\nAccept: application/json",
    'content' => json_encode([
      'referral_code' => 'YOUR_CODE',
      'address_from' => 'TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax',
      'address_to'   => 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
      'resources' => ['duration' => 1, 'energy' => 65000],
    ]),
  ],
]));
$data = json_decode($response, true)['result'];
// $data['deposit_address'] — send $data['amount'] TRX here

Python

import requests

resp = requests.post('https://api.tronzap.com/v1/orders', json={
    'referral_code': 'YOUR_CODE',
    'address_from': 'TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax',
    'address_to':   'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
    'resources': {'duration': 1, 'energy': 65000},
})
result = resp.json()['result']
# result['deposit_address'] — send result['amount'] TRX here

Yanıt

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {
    "order_id": "01HZX5N6Q9TY3K2P0VWB7HRD4M",
    "status": "new",
    "deposit_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
    "amount": 2.69,
    "currency": "TRX",
    "expires_at": "2026-05-18T16:07:05+00:00",
    "ttl": 3600
  }
}

Yanıt alanları

Alan	Tür	Açıklama
order_id	string	Oluşturulan siparişin ULID'i. Kontrol ve iptal için kullanın.
status	string	Yeni oluşturulan bir sipariş için her zaman new.
deposit_address	string	Kullanıcının TRX'i address_from adresinden bu adrese göndermesi gerekir.
amount	number	Gönderilecek tam TRX miktarı. Herhangi bir sapma siparişle eşleşmez.
currency	string	Her zaman TRX.
expires_at	string	ISO-8601 zaman damgası. Bu süreden sonra sipariş otomatik olarak expired durumuna geçer.
ttl	integer	expires_at değerine kadar kalan saniye. Genellikle 3600 (1 saat).

Tam miktar ve gönderici zorunludur

TRX transferi address_from adresinden başlamalı ve tam olarak amount TRX olmalıdır. Başka bir miktar veya gönderici adresi siparişle eşleşmez.