Hosted Checkout entegrasyonu

Hosted Checkout, Volet.com tarafından barındırılan hazır bir ödeme sayfasıdır.

Müşterilerinizin göreceği sayfayı önizlemek için geliştiricilere yönelik Hosted Checkout sayfasını açın.

Uygulamanız bir ödeme talebi oluşturur ve müşteriyi Hosted Checkout'a yönlendirir. Müşteri ödemeyi tamamlar, Volet.com sunucunuza bir durum bildirimi gönderir ve ardından müşteriyi web sitenize geri yönlendirir.

Hosted Checkout şunları destekler:

Entegrasyondan önce hesabınızda bir Hosted Checkout ağ geçidi oluşturup yapılandırın. Bkz.: Ödeme ağ geçidi oluşturma.

Ödeme akışı

Müşteri web sitenizde sipariş verir.
Web siteniz bir ödeme talebi oluşturur ve bir ödeme düğmesi veya bağlantısı gösterir.
Müşteri Öde'ye tıklar ve Hosted Checkout'a yönlendirilir.
Müşteri ödemeyi tamamlar.
Volet.com, Status URL'nize ödeme durumu bildirimi gönderir.
Sisteminiz sipariş durumunu günceller.
Hosted Checkout ödeme sonucu sayfasını gösterir.
Müşteri ardından Devam'a tıklayabilir ve Success URL'nize veya Failed URL'nize yönlendirilir.

Merchant website
      │
      ▼
Hosted Checkout
      │
      ▼
Payment
      │
      ▼
Status URL
      │
      ▼
Merchant backend
      │
      ▼
Customer redirect

Başarılı ödemelerde sonuç sayfası işlem kimliğini ve ödeme bilgilerini içerir. Başarısız veya iptal edilen ödemelerde ilgili hata ya da iptal mesajını gösterir.

Success URL ve Failed URL, Hosted Checkout ayarlarında yapılandırılabilir veya ödeme talebinde dinamik olarak iletilebilir.

not

Sipariş durumunu güncellerken her zaman Status URL bildirimlerine güvenin. Yalnızca tarayıcı yönlendirmelerine güvenmeyin.

Success URL ve Failed URL nihai ödeme durumunu belirlemek için kullanılmamalıdır.

Hosted Checkout hızlı başlangıç

Adım 1. Ödeme talebi oluşturun

Hosted Checkout uç noktası

https://account.volet.com/api/public/payment-gateway

Zorunlu parametreler

Ödeme oluşturmak için yukarıdaki uç noktaya POST ile bir HTML formu gönderin. Ödeme talebi şu zorunlu parametreleri içermelidir:

Parametre	Açıklama
`ac_account_email`	Volet.com hesabınızın e-posta adresi
`ac_sci_name`	Hosted Checkout adı
`ac_amount`	Ödeme tutarı
`ac_currency`	Ödeme para birimi (ör. USD, EUR)
`ac_order_id`	Benzersiz sipariş tanımlayıcınız
`ac_sign`	Dijital imza

Desteklenen parametrelerin tam listesi için Ödeme talebi parametreleri bölümüne bakın.

not

Her ödeme talebi benzersiz bir ac_order_id kullanmalıdır.

Sipariş tanımlayıcılarını farklı ödemeler için yeniden kullanmayın.

İstek imzası

ac_sign parametresini aşağıdaki dizenin SHA-256 hash'ini hesaplayarak oluşturun:

ac_account_email:ac_sci_name:ac_amount:ac_currency:secret:ac_order_id

Burada secret, Hosted Checkout'u oluştururken belirlediğiniz şifredir.

Örnek dize:

[email protected]:Store:100.00:USD:password:123

SHA-256 hash'i:

eb9e7f491df701fe7d71c74551ae9e4226dfbed7e3a9cc4916e242d3c09f718e

Elde edilen hash değerini ac_sign parametresiyle iletin.

Ödeme talebini gönderin

HTML formunu POST yöntemiyle Hosted Checkout uç noktasına gönderin.

Örnek ödeme talebi

<form method="POST" action="https://account.volet.com/api/public/payment-gateway">
  <input type="hidden" name="ac_account_email" value="[email protected]">
  <input type="hidden" name="ac_sci_name" value="Store">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_order_id" value="123">
  <input type="hidden" name="ac_sign" value="eb9e7f491df701fe7d71c74551ae9e4226dfbed7e3a9cc4916e242d3c09f718e">
  <button type="submit">VoletPay</button>
</form>

Adım 2. Ödeme bildirimlerini işleyin

Ödeme durumu değiştiğinde Volet.com, Status URL'nize bir bildirim gönderir.

Bildirim, Hosted Checkout yapılandırmanıza bağlı olarak GET veya POST ile iletilir.

Bildirim şu parametreleri içerir:

Parametre	Açıklama
`ac_transfer`	Volet.com işlem kimliği
`ac_transaction_status`	Ödeme durumu
`ac_order_id`	Sipariş tanımlayıcınız
`ac_amount`	Orijinal ödeme tutarı
`ac_merchant_amount`	Hesabınıza yatırılan tutar
`ac_merchant_currency`	Hesaba aktarım para birimi
`ac_start_date`	İşlem tarihi ve saati
`ac_sci_name`	Hosted Checkout adı
`ac_src_wallet`	Müşteri cüzdanı
`ac_dest_wallet`	Üye işyeri cüzdanı
`ac_buyer_email`	Müşterinin e-posta adresi (varsa)
`ac_hash`	Bildirim imzası hash'i

Kullanılabilir parametrelerin tam listesi için Ödeme bildirimi parametreleri bölümüne bakın.

Sipariş durumunu güncellemeden önce bildirimin Volet.com'dan geldiğini doğrulamak için ac_hash imzasını kontrol edin.

uyarı

Siparişleri müşteri yönlendirmelerine dayanarak ödendi olarak işaretlemeyin.

Sipariş durumunu güncellemeden önce her zaman geçerli bir Status URL bildirimini bekleyin ve ac_hash imzasını doğrulayın.

Status URL'nize gönderilen örnek bildirim:

<form method="POST" action="https://merchant.example.com/status">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_order_id" value="123">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_merchant_amount" value="100.00">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_sci_name" value="Store">
  <input type="hidden" name="ac_src_wallet" value="USD123456789012">
  <input type="hidden" name="ac_dest_wallet" value="USD210987654321">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_hash" value="4ceab247ca917e0142b1a99015beaed9310cd6a85ab3bacf08ba44d5ac03590b">
</form>

Bildirim imzasını doğrulayın

Bildirimi doğrulamak için aşağıdaki değerlerle SHA-256 hash'ini hesaplayın ve alınan ac_hash ile karşılaştırın.

İmza dizesi şu sırayla oluşturulur:

ac_transfer:ac_start_date:ac_sci_name:ac_src_wallet:ac_dest_wallet:ac_order_id:ac_amount:ac_merchant_currency:password

Burada password, ağ geçidi için yapılandırılan Hosted Checkout şifresidir.

Örnek dize:

235f9d0b-b48f-462c-9949-621c4930490c:2026-06-23 12:30:00:Store:USD123456789012:USD210987654321:123:100.00:USD:password

Bu dizenin SHA-256 hash'ini hesaplayın:

4ceab247ca917e0142b1a99015beaed9310cd6a85ab3bacf08ba44d5ac03590b

Hesaplanan hash'i alınan ac_hash ile karşılaştırın. Sipariş durumunu güncellemeden önce değerler eşleşmelidir.

İmza başarıyla doğrulandıktan sonra sisteminizdeki ilgili siparişi alınan ödeme durumuyla güncelleyin.

Adım 3. Entegrasyonu test edin

Gerçek ödeme kabul etmeden önce şunları doğrulayın:

Müşterinin Hosted Checkout'a yönlendirilmesi.
Başarılı bir ödemenin tamamlanması.
Status URL bildirimlerinin iletilmesi.
Bildirim imzasının doğrulanması.
Sipariş durumunun güncellenmesi.
Success URL ve Failed URL yönlendirmeleri.
Başarısız ödemelerin işlenmesi.

Bildirim sunucusu IP adresleri

Altyapınız IP izin listeleri veya güvenlik duvarı kuralları kullanıyorsa şu Volet.com bildirim sunucularından gelen isteklere izin verin:

13.61.247.159

Gelişmiş yapılandırma

Aşağıdaki bölümler isteğe bağlı özellikleri ve gelişmiş entegrasyon senaryolarını açıklar.

Ödeme yöntemini önceden seçme

Hosted Checkout varsayılan olarak bir ödeme yöntemi seçim sayfası gösterir.

Ödeme talebinde ac_ps parametresiyle bir ödeme yöntemini önceden seçebilirsiniz. Belirtildiğinde Hosted Checkout ilgili ödeme ekranını doğrudan açar ve ödeme yöntemi seçim adımını atlar.

Ödeme talebi parametrelerinize şu alanları ekleyin:

Volet.com hesabı giriş sayfasını doğrudan açar:

<input type="hidden" name="ac_ps" value="VOLET">

Tron üzerinde USDT ödeme sayfasını doğrudan açar:

<input type="hidden" name="ac_ps" value="USDTETHER">
<input type="hidden" name="ac_ps_protocol" value="TRON">

Bitcoin ödeme sayfasını doğrudan açar:

<input type="hidden" name="ac_ps" value="BITCOIN">

Bu, müşteri Hosted Checkout'a yönlendirilmeden önce web sitenizde ödeme yöntemini zaten seçtiyse faydalıdır.

Dil

Hosted Checkout arayüz dilini belirtmek için ac_client_lang parametresini kullanın.

Örnek:

<input type="hidden" name="ac_client_lang" value="en">

Dil belirtilmezse Hosted Checkout müşteri için kullanılabilen varsayılan dili kullanır.

Özel alanlar

Bir ödeme talebine en fazla 10 özel alan ekleyebilirsiniz.

Volet.com bu alanları işlemez; Status URL bildirimlerinde ve müşteri yönlendirmelerinde değiştirmeden geri döndürür.

Tipik kullanım senaryoları:

Müşteri kimliği
Abonelik kimliği
Dahili fatura numarası
Yorum

Örnek:

<input type="hidden" name="customer_id" value="12345">
<input type="hidden" name="subscription_id" value="sub_987">
<input type="hidden" name="invoice_no" value="INV-2026-001">
<input type="hidden" name="comment" value="Premium plan">

Alt üye işyerleri

Ödemenin adına işlendiği üye işyerinin web sitesini belirtmek için ac_submerchant_url parametresini kullanın.

Örnek:

<input type="hidden" name="ac_submerchant_url" value="https://merchant.example.com">

Bu seçenek, başka üye işyerleri için ödeme işleyen ödeme toplayıcıları, pazaryerleri ve platformlar için tasarlanmıştır.

not

Üye işyerleri için geçerli olan tüm uyum, yasaklı faaliyet ve üye işyeri doğrulama gereksinimleri alt üye işyerleri için de geçerlidir.

URL'leri geçersiz kılma

Aşağıdaki parametreler doğrudan ödeme talebinde belirtilebilir:

ac_success_url
ac_success_url_method
ac_fail_url
ac_fail_url_method
ac_status_url
ac_status_url_method

Örnek:

<input type="hidden" name="ac_success_url" value="https://merchant.example.com/payment-success">
<input type="hidden" name="ac_success_url_method" value="GET">
<input type="hidden" name="ac_fail_url" value="https://merchant.example.com/payment-failed">
<input type="hidden" name="ac_fail_url_method" value="GET">
<input type="hidden" name="ac_status_url" value="https://merchant.example.com/payment-status">
<input type="hidden" name="ac_status_url_method" value="POST">

Talepte iletilen değerler, Hosted Checkout ağ geçidi için yapılandırılan varsayılan URL'leri geçersiz kılar.

Bu, birden fazla web sitesi, mağaza, uygulama, bot veya yapay zekâ ajanı aynı Hosted Checkout ağ geçidini kullandığında faydalıdır.

Ayrıca birden fazla Hosted Checkout ağ geçidi oluşturmadan her sipariş için farklı başarı, hata ve callback URL'leri oluşturmanızı sağlar.

İmzaları devre dışı bırakma

Hosted Checkout ayarlarında dijital imzalar devre dışıysa ac_sign parametresi isteğe bağlıdır.

Yine de isteklerin gerçekliğini doğrulamak ve verilerin değiştirilmesini önlemek için canlı ortamlarda imza kullanmanızı önemle öneririz.

İmzasız istekler yalnızca test ve geliştirme amacıyla kullanılmalıdır.

Hosted Checkout referansı

Ödeme talebi parametreleri

Ödeme talebi, uygulamanızın Hosted Checkout'a gönderdiği bir HTML formudur.

Bir ödemeyi işlemek için gereken ödeme bilgilerini, üye işyeri bilgilerini, yönlendirme URL'lerini ve isteğe bağlı yapılandırma parametrelerini içerir.

Aşağıdaki tablo desteklenen tüm ödeme talebi parametrelerini listeler.

Parametre	Zorunlu	Biçim	Açıklama	Örnekler
`ac_account_email`	Evet	Dize	Volet.com hesabınızın e-posta adresi.	`[email protected]`
`ac_sci_name`	Evet	Dize (en fazla 50 karakter)	Hosted Checkout adı.	`My Store`
`ac_amount`	Evet	Ondalık sayı	Ödeme talebinin tutarı. Ondalık hassasiyeti seçilen para birimine bağlıdır. Fazla ondalık basamaklar otomatik olarak kesilir.	`100.00`, `49.0302`, `0.12345678`
`ac_currency`	Evet	Para birimi kodu	Ödeme talebinin para birimi.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_order_id`	Evet	Dize (en fazla 64 karakter; `"A-z"`, `"-"`, `"_"`, `"0-9"`)	Üye işyerinin benzersiz sipariş tanımlayıcısı.	`123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
`ac_sign`	Koşullu	Onaltılık dize (SHA-256)	Ödeme talebinin bütünlüğünü doğrulamak için kullanılan istek imzası. Hosted Checkout için istek imzası doğrulaması etkinse zorunludur.	`36b4c9ad29b61d1c5996e3ef1a3af0c3194e19713613b6bf26a9b905b8019225`
`ac_ps`	Hayır	Dize (ödeme yöntemi kimliği)	Hosted Checkout açıldığında önceden seçilen ödeme yöntemi.	`VOLET`, `USDTETHER`, `USD_COIN`, `BITCOIN`, `ETHEREUM`, `RIPPLE`, `TRON`, `LITECOIN`, `TON`, `SOL`, `BNB`, `MATIC` (POLYGON için), `AVAX`
`ac_ps_protocol`	Koşullu	Dize (blokzincir veya protokol kimliği)	Önceden seçilen blokzincir ağı. ac_ps değeri USDTETHER, USD_COIN veya BNB olduğunda zorunlu, diğer durumlarda isteğe bağlıdır.	`ETHEREUM`, `TRON`, `BINANCE_SMART_CHAIN`, `MATIC` (POLYGON için), `SOLANA`, `AVALANCHE`, `OPTIMISM`, `ARBITRUM`, `TON`
`ac_comments`	Hayır	Dize (en fazla 255 karakter)	Müşteriye gösterilen ve değiştirilemeyen ek ödeme açıklaması.	`Payment for Order #1234`
`ac_success_url`	Hayır	Dize (en fazla 100 karakter)	Yapılandırılmış Success URL'yi geçersiz kılar.	`https://merchant.example.com/success`
`ac_success_url_method`	Hayır	`GET`, `POST`	Success URL yönlendirmesi için kullanılan HTTP yöntemi. Hosted Checkout yapılandırmasını geçersiz kılar.	`GET`
`ac_fail_url`	Hayır	Dize (en fazla 100 karakter)	Yapılandırılmış Failed URL'yi geçersiz kılar.	`https://merchant.example.com/failed`
`ac_fail_url_method`	Hayır	`GET`, `POST`	Failed URL yönlendirmesi için kullanılan HTTP yöntemi. Hosted Checkout yapılandırmasını geçersiz kılar.	`POST`
`ac_status_url`	Hayır	Dize (en fazla 100 karakter)	Yapılandırılmış Status URL'yi geçersiz kılar.	`https://merchant.example.com/status`
`ac_status_url_method`	Hayır	`GET`, `POST`	Status URL bildirimleri için kullanılan HTTP yöntemi. Hosted Checkout yapılandırmasını geçersiz kılar.	`POST`
`ac_client_lang`	Hayır	Dize (dil kodu)	Hosted Checkout sayfasının dili.	`en`
`ac_submerchant_url`	Hayır	Dize (en fazla 100 karakter)	Alt üye işyerinin web sitesi URL'si. Platform entegrasyonlarında kullanılır ve belirli üye işyeri kategorileri için zorunludur.	`https://seller.example.com`
Özel alanlar (örneğin `buyer_email`, `client_email`)	Hayır	En fazla 10 dize değeri (her biri en fazla 100 karakter)	Status URL bildirimlerinde ve müşteri yönlendirmelerinde değiştirilmeden döndürülen, üye işyerinin tanımladığı ek alanlar. Ödemeleri kendi siparişleriniz, müşterileriniz, faturalarınız veya diğer dahili kayıtlarınızla eşleştirmek için kullanın.	`[email protected]`, `#INV-12345`, `user_1001`

Örnek

<form method="POST" action="https://account.volet.com/api/public/payment-gateway">
  <input type="hidden" name="ac_account_email" value="[email protected]">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <input type="hidden" name="ac_sign" value="36b4c9ad29b61d1c5996e3ef1a3af0c3194e19713613b6bf26a9b905b8019225">

  <input type="hidden" name="ac_ps" value="USDTETHER">
  <input type="hidden" name="ac_ps_protocol" value="ETHEREUM">
  <input type="hidden" name="ac_comments" value="Payment for Order #123456">

  <input type="hidden" name="ac_success_url" value="https://merchant.example.com/payment-success">
  <input type="hidden" name="ac_success_url_method" value="GET">
  <input type="hidden" name="ac_fail_url" value="https://merchant.example.com/payment-failed">
  <input type="hidden" name="ac_fail_url_method" value="GET">
  <input type="hidden" name="ac_status_url" value="https://merchant.example.com/payment-status">
  <input type="hidden" name="ac_status_url_method" value="POST">

  <input type="hidden" name="ac_client_lang" value="en">
  <input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="customer_email" value="[email protected]">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
  <input type="hidden" name="merchant_internal_id" value="seller_456">

  <button type="submit">Pay with Volet.com</button>
</form>

Başarılı ödeme parametreleri

Başarılı bir ödemeden sonra Hosted Checkout müşteriyi Success URL'nize yönlendirir ve ödeme bilgilerini yapılandırılan yönlendirme yöntemiyle iletir.

Aşağıdaki tablo kullanılabilir tüm parametreleri açıklar.

Parametre	Biçim	Açıklama	Örnekler
`ac_src_wallet`	Dize	Ödeme için kullanılan müşteri cüzdan numarası.	`USDT123456789012`
`ac_dest_wallet`	Dize	Üye işyeri cüzdan numarası veya hesaba aktarım cüzdanı.	`USD123456789012`
`ac_amount`	Ondalık sayı	Ödeme talebinin tutarı.	`100.00`, `0.12500000`
`ac_merchant_amount`	Ondalık sayı	Üye işyeri hesabına yatırılan tutar.	`100.00`
`ac_merchant_currency`	Para birimi kodu	Hesaba aktarım para birimi.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_fee`	Ondalık sayı	Ödeme için alınan işlem komisyonu.	`0.50`
`ac_buyer_amount_without_commission`	Ondalık sayı	Varsa müşterinin ödediği ücretler hariç müşteri tarafından ödenen tutar.	`100.00`
`ac_buyer_amount_with_commission`	Ondalık sayı	Müşterinin ödediği ücretler dahil müşteri tarafından ödenen toplam tutar.	`100.50`
`ac_buyer_currency`	Para birimi kodu	Müşterinin ödemeyi tamamlamak için kullandığı para birimi.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`, `BNB`, `AVAX`, `POL`
`ac_transfer`	UUID	Benzersiz Volet.com işlem tanımlayıcısı.	`235f9d0b-b48f-462c-9949-621c4930490c`
`ac_sci_name`	Dize	Hosted Checkout adı.	`My Store`
`ac_start_date`	`YYYY-MM-DD HH:mm:ss` (UTC)	Ödemenin oluşturulma tarihi ve saati.	`2026-06-23 12:30:00`
`ac_order_id`	Dize	Ödeme talebinde belirtilen üye işyeri sipariş tanımlayıcısı.	`123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
`ac_ps`	Dize (ödeme yöntemi kimliği)	Müşterinin kullandığı ödeme yöntemi.	`VOLET`, `USDT`, `USDC`, `BTC`, `ETH`, `TRX`, `SOL`
`ac_transaction_status`	Durum	Nihai ödeme durumu. Olası değerler: `PENDING`, `PROCESS`, `COMPLETED`, `CANCELED`.	`COMPLETED`
`ac_buyer_email`	Dize (e-posta adresi)	Varsa müşterinin e-posta adresi.	`[email protected]`
`ac_buyer_verified`	Mantıksal (boolean)	Müşteri hesabının doğrulanmış olup olmadığını gösterir.	`true`, `false`
`ac_comments`	Dize	Ödeme talebinde belirtilen yorum.	`Order #123456`
Özel alanlar	Dize	Ödeme talebinden değiştirilmeden döndürülen, üye işyerinin tanımladığı alanlar.	`customer_id`, `invoice_id`, `subscription_id`

Örnek

<form method="POST" action="https://merchant.example.com/payment-success">
  <input type="hidden" name="ac_src_wallet" value="USDT210987654321">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_merchant_amount" value="99.50">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_fee" value="0.50">
  <input type="hidden" name="ac_buyer_amount_without_commission" value="100.00">
  <input type="hidden" name="ac_buyer_amount_with_commission" value="100.00">
  <input type="hidden" name="ac_buyer_currency" value="USDT">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <input type="hidden" name="ac_ps" value="VOLET">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_buyer_verified" value="true">
  <input type="hidden" name="ac_comments" value="Order #123456">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
</form>

Başarısız ödeme parametreleri

Bir ödeme iptal edilirse veya başarısız olursa Hosted Checkout müşteriyi Failed URL'nize yönlendirir ve ödeme bilgilerini yapılandırılan yönlendirme yöntemiyle iletir.

Aşağıdaki tablo kullanılabilir tüm parametreleri açıklar.

Parametre	Biçim	Açıklama	Örnekler
`ac_dest_wallet`	Dize	Üye işyeri hesabı veya hesaba aktarım cüzdanı.	`USD123456789012`
`ac_amount`	Ondalık sayı	Ödeme talebinin tutarı.	`100.00`, `49.95`
`ac_currency`	Para birimi kodu	Ödeme talebinin para birimi.	`USD`, `EUR`, `BTC`, `ETH`, `USDT`, `USDC`, `XRP`, `TRX`, `LTC`, `TON`, `SOL`
`ac_sci_name`	Dize	Hosted Checkout adı.	`My Store`
`ac_order_id`	Dize	Ödeme talebinde belirtilen üye işyeri sipariş tanımlayıcısı.	`order_123456`, `baf419d9-6c82-4175-b870-5541b0ff3794`
Özel alanlar	Dize	Ödeme talebinden değiştirilmeden döndürülen, üye işyerinin tanımladığı alanlar.	`customer_id`, `invoice_id`, `subscription_id`

Örnek

<form method="POST" action="https://merchant.example.com/payment-failed">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="100.00">
  <input type="hidden" name="ac_currency" value="USD">
  <input type="hidden" name="ac_sci_name" value="My Store">
  <input type="hidden" name="ac_order_id" value="order_123456">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="customer_12345">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
  <input type="hidden" name="subscription_id" value="sub_98765">
</form>

Ödeme bildirimi parametreleri

Ödeme durumu değiştiğinde Hosted Checkout, yapılandırılan istek yöntemiyle (GET veya POST) Status URL'nize bir bildirim gönderir.

Bildirim, tüm başarılı ödeme parametrelerine ek olarak bir ac_hash imzası içerir.

Parametre	Biçim	Açıklama	Örnekler
`ac_hash`	SHA-256 hash değeri (onaltılık dize)	Bildirimin Volet.com tarafından gönderildiğini ve iletim sırasında değiştirilmediğini doğrulamak için kullanılan SHA-256 imzası.	`1cd6c127c5c49b6d5060cec4bdbf06608216c0c11cc76acebb546be0f7081afd`

İmzanın nasıl oluşturulacağı ve doğrulanacağı hakkında ayrıntılar için Bildirim imzasını doğrulayın bölümüne bakın.

Örnek bildirim

<form method="POST" action="https://merchant.example.com/status">
  <input type="hidden" name="ac_src_wallet" value="USDT210987654321">
  <input type="hidden" name="ac_dest_wallet" value="USD123456789012">
  <input type="hidden" name="ac_amount" value="123.45">
  <input type="hidden" name="ac_merchant_amount" value="123.55">
  <input type="hidden" name="ac_merchant_currency" value="USD">
  <input type="hidden" name="ac_fee" value="0.10">
  <input type="hidden" name="ac_buyer_amount_without_commission" value="123.45">
  <input type="hidden" name="ac_buyer_amount_with_commission" value="123.55">
  <input type="hidden" name="ac_buyer_currency" value="USD">
  <input type="hidden" name="ac_transfer" value="235f9d0b-b48f-462c-9949-621c4930490c">
  <input type="hidden" name="ac_sci_name" value="My Shop">
  <input type="hidden" name="ac_start_date" value="2026-06-23 12:30:00">
  <input type="hidden" name="ac_order_id" value="123456">
  <input type="hidden" name="ac_ps" value="VOLET">
  <input type="hidden" name="ac_transaction_status" value="COMPLETED">
  <input type="hidden" name="ac_buyer_email" value="[email protected]">
  <input type="hidden" name="ac_buyer_verified" value="true">
  <input type="hidden" name="ac_comments" value="Payment for order #123456">
  <input type="hidden" name="ac_hash" value="1cd6c127c5c49b6d5060cec4bdbf06608216c0c11cc76acebb546be0f7081afd">
  <!-- Custom fields -->
  <input type="hidden" name="customer_id" value="98765">
  <input type="hidden" name="invoice_id" value="INV-2026-001">
</form>

Ödeme akışı​

Hosted Checkout hızlı başlangıç​

Adım 1. Ödeme talebi oluşturun​

Hosted Checkout uç noktası​

Zorunlu parametreler​

İstek imzası​

Ödeme talebini gönderin​

Örnek ödeme talebi​

Adım 2. Ödeme bildirimlerini işleyin​

Bildirim imzasını doğrulayın​

Adım 3. Entegrasyonu test edin​

Bildirim sunucusu IP adresleri​

Gelişmiş yapılandırma​

Ödeme yöntemini önceden seçme​

Dil​

Özel alanlar​

Alt üye işyerleri​

URL'leri geçersiz kılma​

İmzaları devre dışı bırakma​

Hosted Checkout referansı​

Ödeme talebi parametreleri​

Örnek​

Başarılı ödeme parametreleri​

Örnek​

Başarısız ödeme parametreleri​

Örnek​

Ödeme bildirimi parametreleri​

Örnek bildirim​

Ödeme akışı

Hosted Checkout hızlı başlangıç

Adım 1. Ödeme talebi oluşturun

Hosted Checkout uç noktası

Zorunlu parametreler

İstek imzası

Ödeme talebini gönderin

Örnek ödeme talebi

Adım 2. Ödeme bildirimlerini işleyin

Bildirim imzasını doğrulayın

Adım 3. Entegrasyonu test edin

Bildirim sunucusu IP adresleri

Gelişmiş yapılandırma

Ödeme yöntemini önceden seçme

Dil

Özel alanlar

Alt üye işyerleri

URL'leri geçersiz kılma

İmzaları devre dışı bırakma

Hosted Checkout referansı

Ödeme talebi parametreleri

Örnek

Başarılı ödeme parametreleri

Örnek

Başarısız ödeme parametreleri

Örnek

Ödeme bildirimi parametreleri

Örnek bildirim